What is This?
Ever wanted to use GitHub as a storage drive? Well, now you can. This project lets you store files on GitHub using an FTP frontend, and you can mount it with Rclone like it’s just another folder on your system. Because, why the hell not?
Features
- FTP Frontend – Because a proper UI is too much work.
- Rclone Mountable – Full file operations supported (yes, it actually works).
Compatibility
- Linux – Works fine.
- macOS – Somehow works.
- Windows – Not tested. Don’t even ask for support.
GitHub Repository
Why No README on GitHub?
Simple. I don’t trust GitHub. They can nuke my account at any time, so all updates and documentation live here. Deal with it.
Setup Guide (Try to Keep Up)
- Download the Binary
- Grab it from the releases page.
- Get the Configuration File
- Download
config_example.yaml
from the repo’s main page.
- Download
- Create a GitHub Account
- Important: If you’re making this public, USE A VPN. People upload sketchy stuff, and you don’t want law enforcement knocking on your door. Be smart.
- Generate a GitHub Token
- If you don’t know how, Google exists.
- Create a Private Repository
- This ensures random people don’t poke around your files. Encryption isn’t supported yet, so keep it private.
- Create a Few Releases
- Figure it out.
- Get Release Data for Configuration
./fafda --list-releases <your_token>
If this fails, something went wrong in the steps above. Fix it. - Update Configuration File
- Copy the release data into
config_example.yaml
. - Rename
config_example.yaml
toconfig.yaml
.
- Copy the release data into
- Run the Program
./fafda
If things break, try:./fafda --debug
- Use an FTP Client or Mount with Rclone
- FTP Client: Works with FileZilla.
- Rclone Mount:
rclone mount -v --allow-other --vfs-cache-mode=writes --vfs-cache-max-age=10s fafda: ./GitHubDrive
- If Something Breaks, Restart It
- I’m not offering Windows support. If you’re on Windows, you’re on your own.
A Note to GitHub Staff
Dear GitHub moderators, before you hit that ban button on my repo like you did with YouTube-DL (on fake DMCA claims, no less) and those Switch emulator repos, just know this—at least I’m being honest about abusing your storage instead of pretending it’s “for educational purposes only.” XOXO.