flashnote

README

Flash Note

Self-hosted ephemeral text & image sharing. Paste to upload, one-click copy, auto-expire. Single binary, zero external dependencies.

Features

• Paste-first — Ctrl+V anywhere to upload text or images
• Real-time sync — WebSocket pushes changes to all connected clients instantly
• Auto-expire — Every clip has a TTL; expired content is cleaned up automatically
• Single binary — Frontend is embedded via go:embed, just run and go
• Dark mode — Follows system preference, no toggle needed
• Image actions — Copy to clipboard, download, share (Web Share API)

Quick Start

Binary

Download the latest binary from Releases, then:

cp examples/config.yaml config.yaml
./flashnote

Open http://localhost:8080 in your browser.

Docker

mkdir -p data && chown -R 65532:65532 data
docker run -d \
  -p 8080:8080 \
  -v ./data:/data \
  -v ./config.yaml:/config.yaml \
  mmx233/flashnote

Build from Source

git clone https://github.com/Mmx233/flashnote.git
cd flashnote
cd web && yarn install && yarn build && cd ..
go build -o flashnote .

Configuration

Create a config.yaml in the working directory (or specify with -c). See examples/config.yaml for a full example.