Skip to content

Commit

Permalink
configuration example and readme
Browse files Browse the repository at this point in the history
  • Loading branch information
balazsgrill committed Aug 4, 2024
1 parent 9abfd30 commit 5e6a8b2
Show file tree
Hide file tree
Showing 4 changed files with 38 additions and 28 deletions.
6 changes: 3 additions & 3 deletions .github/workflows/go.yml
Original file line number Diff line number Diff line change
Expand Up @@ -28,8 +28,8 @@ jobs:
run: go test -v ./...

- name: Build
run: go build -o potato-s3.exe ./cmd/s3
run: go build -o potatodrive.exe ./cmd/main
- uses: actions/upload-artifact@v4
with:
name: potato-s3.exe
path: potato-s3.exe
name: potatodrive.exe
path: potatodrive.exe
35 changes: 35 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1 +1,36 @@
# PotatoDrive

Windows user-space locally-cached virtual file system client. Based on [Projected File System](https://learn.microsoft.com/en-us/windows/win32/projfs/projected-file-system) service available on Windows 10+ and works similar to OneDrive, using the local directory as a cache of the remote state.

:construction: PotatoDrive is in early development phase, don't trust it with data you're not willing to lose. Keep your backups safe (as always)!

Features:

* Windows 10+
* Supports standard S3 (AWS, BackBlaze, Minio, etc..) as backend without additional server
* Files are cached locally
* Multiple folder bindings on a single machine

## Installation

Installer is not (yet) available, latest binaries can be downloaded as [artifacts from successful builds](https://github.com/balazsgrill/potatodrive/actions).

To work, Projected File System service needs to be [enabled](https://learn.microsoft.com/en-us/windows/win32/projfs/enabling-windows-projected-file-system) (disabled by default):

```PowerShell
Enable-WindowsOptionalFeature -Online -FeatureName Client-ProjFS -NoRestart
```

## Configuration

Configuration is stored in Windows Registry, see [example.reg](example/potatodrive-minio.reg).

## Running

Once configured,

# Development

* [afero](https://github.com/spf13/afero) is used as backend interface, meaning that any

Windows user-space virtual file system binding to [afero](https://github.com/spf13/afero) file systems backend. Makes it possible to implement virtual file systems for windows backed by any kind of user-space implementation of virtual file system.
25 changes: 0 additions & 25 deletions example/main.go

This file was deleted.

Binary file added example/potatodrive-minio.reg
Binary file not shown.

0 comments on commit 5e6a8b2

Please sign in to comment.