Cross-platform, open-source file sharing with end-to-end encrypted share links built with Flutter & Dart.

Getting Started • Roadmap • Releases

Captured from a connected Android device via ADB (debug build). Paths are from the repo root. After large UI changes, recapture with the same flow and replace the files in docs/screenshots/.

Home

Step	Preview
Home

Send files

Pick file	Uploading	Uploaded

Your uploads

Bottom sheet

Receive files

Valid token	Wrong token	Downloading	Downloaded

Short screen captures of the same flows live in docs/videos/ (recorded with adb shell screenrecord on device, then pulled to the repo).

• Flutter

• Dart

• Cloudflare Workers + R2 + KV

• odin_core and odin_cli

• Cross-platform Flutter app for send/receive flows
• Cloudflare Workers backend with token-based upload/download APIs
• odin_cli terminal client with TUI and headless modes
• Upload from files and directories (directories are zipped before upload)
• End-to-end encrypted uploads by default:
  • Payloads are encrypted client-side before upload
  • Share token contains decryption key in URL fragment (#k=...), which is not sent to the server
  • Legacy plaintext tokens/downloads remain supported
• Metadata pre-check on download flow
• Upload/download progress indicators
• Expiring uploads and delete-token support

To build on MacOS, Windows, Linux, Android, or iOS follow these steps.

Step 1:

git clone https://github.com/odinapp/odin.git

Step 2:

cd odin

Create the .env file:

cat > .env <<'EOF'
API_URL=https://<your-worker>.workers.dev/
API_VERSION=v1
SUCCESSFUL_STATUS_CODE=200
EOF

Backend: Odin uses a Cloudflare Workers backend. Deploy your own using the code in odin-worker/, then set API_URL to your deployment URL. The .env file is gitignored — never commit it. No GitHub credentials are required.

Step 3:

Install FVM (Flutter Version Management), then from the repository root install the SDK pinned for this project:

fvm install

Odin pins the stable Flutter channel via .fvmrc. Use fvm flutter / fvm dart for all Flutter and Dart commands so you use that SDK (not a mismatched global install).

Step 4:

Enable the desktop embedder for your OS if you have not already, then pick the desktop device when running.

# for windows
fvm flutter config --enable-windows-desktop

# for macos
fvm flutter config --enable-macos-desktop

# for linux
fvm flutter config --enable-linux-desktop

Step 5:

To fetch packages and run the app (from the repo root):

fvm flutter pub get
fvm flutter run

Editor tip: Point your IDE’s Flutter SDK path to .fvm/flutter_sdk inside this repo so analysis and device selection match FVM.

From the repo root:

fvm flutter analyze --no-fatal-infos
fvm flutter test

For Android: fvm flutter build apk (debug or release). For Linux desktop, install the Flutter Linux prerequisites (for example cmake, ninja-build, and GTK development packages), then run fvm flutter build linux or fvm flutter run -d linux.

• Flutter send/receive experience for mobile + desktop
• Cloudflare Worker backend (upload, download, info, delete)
• Upload/download progress in app and CLI
• odin_core package as shared upload/download logic
• odin_cli package with TUI + headless/script-friendly mode
• Directory upload support (zip-then-upload)
• End-to-end encrypted share tokens with key fragment support
• Backward-compatible plaintext token download support

• Streaming/chunked encryption for very large files
• Optional auto-extract after encrypted zip download
• Clipboard + QR improvements for encrypted share tokens in CLI/TUI
• Optional web upload/download client that uses the same odin_core protocol
• Better key rotation/revocation UX for shared links
• Multi-recipient sharing with per-recipient key wrapping
• LAN/direct local transfer mode (same network)
• Signed releases for CLI binaries

If you'd like to propose a feature, submit an issue here.

Please see the releases tab for more details about the latest release.

First off, thanks for visiting Odin's repo and taking your time to read this doc. Any contributions you make are greatly appreciated. Please look at CONTRIBUTING.md for details.

Odin began as what most projects start as "A weekend project". Originally, we wanted to develop a cross-platform, open-source file-sharing platform that was faster and easier than sharing files over chat services or data cables. We wanted to develop and prototype the project as quickly as possible. The result was an MVP that was ready in just a few hours because we used Flutter.

Fun Fact: The app icon resembles the helmet of the god Odin from Norse mythology. It also resembles a free-flying bird, which indicates our feelings while developing this with Flutter😊.

Distributed under the GPL-3.0 License. See LICENSE for more information.