Quickstart
A 5-minute quickstart for developers setting up the Emberly desktop uploader.
Prerequisites
- Node.js 16+ (with bun, npm, yarn, or pnpm)
- Rust 1.70+ — Install via rustup
- Tauri prerequisites for your OS
Installation
Development
The application launches in a development window with hot module reloading.
Building
First Run
1. Configure Settings
- Click the Settings icon (⚙️) in the top right
- Enter your Emberly instance details:
- API URL:
https://embrly.ca - Session Token: Copy from your browser cookies after logging in
- API URL:
- Choose a default visibility and optional password
- Click Save Settings
2. Get Your Session Token
- Open embrly.ca and log in
- Open DevTools:
F12orCtrl+Shift+I - Go to Application → Cookies
- Find and copy
next-auth.session-token - Paste it into the Settings modal
Keep your token private
Your session token authenticates all uploads. Treat it like a password — never commit it to source control.
3. Test a Screenshot Upload
- Click Capture Screenshot
- Wait for the upload to complete
- Click Copy to copy the URL to clipboard
4. Test File Upload
- Click Select File
- Choose any file from your system
- Upload completes automatically and the URL is copied
Common Tasks
View Upload History
- Click the History tab
- See all recent uploads with their URLs
- Click the link icon to open in browser, or trash to remove from history
Troubleshooting
| Problem | Solution |
|---|---|
| "Rust is required" | Run curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh |
| Upload fails with 401 | Session token expired — get a fresh one from DevTools |
| Screenshot is blank | Grant screen capture permission in System Settings |
| Build fails | Run rustup update and ensure Tauri prerequisites are installed |