Getting Started
When you first launch Crabdrop, you’ll see the setup screen. You need to configure a connection to your S3-compatible storage before you can start browsing files.
Setup
Fill in the following fields:
| Field | Required | Description | Example |
|---|---|---|---|
| Endpoint URL | Yes | Your S3 endpoint. See Supported Services for examples | https://my-account.r2.cloudflarestorage.com |
| Bucket Name | Yes | The name of your S3 bucket | my-bucket |
| Region | Yes | The AWS region (or equivalent for your provider) | us-east-1 |
| Access Key ID | Yes | Your access key for authentication | AKIA... |
| Secret Access Key | Yes | Your secret key for authentication | |
| Encryption Passphrase | Yes | Passphrase for client-side file encryption |
Once filled in, click Connect.
Where Credentials Are Stored
- Storage settings (endpoint, bucket, region) are saved to
~/.config/crabdrop/config.toml - Credentials (access key, secret key, encryption passphrase) are stored in your OS keychain:
- macOS: Keychain Access
- Windows: Credential Manager
- Linux: Secret Service (GNOME Keyring, KDE Wallet, etc.)
Credentials are never stored in plaintext config files.
First Use
After setup, Crabdrop opens the file browser showing the root of your bucket. From here you can:
- Browse — click folders to navigate into them
- Upload — drag and drop files onto the window
- Download — double-click a file to download and open it
- Go back — click the back arrow or use the breadcrumb path