Quickstart

Prerequisites

Node.js 18+ (with bun, npm, yarn, or pnpm)
Rust 1.70+ — Install via rustup
Tauri prerequisites for your OS

Installation

# 1. Clone the Flicker repository
git clone https://github.com/EmberlyOSS/Flicker.git
cd Flicker
 
# 2. Install dependencies
bun install
 
# 3. Fetch Rust dependencies
cargo fetch

Development

bun run tauri dev

The application launches in a development window with hot module reloading.

Building

bun run tauri build
# Binary will be in: src-tauri/target/release/

First Run

1. Log In

Launch Flicker and sign in with your Emberly email and password directly in the app. Two-factor authentication is supported.

Alternatively, you can authenticate using your Upload Token:

Log in to embrly.ca
Go to Settings → Profile → Upload Token
Copy the token and paste it into Flicker’s Settings screen

Keep your token private

Your upload 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