Birda GUI

Desktop GUI for birda, a bird species detection CLI powered by BirdNET.

Built with Electron, Svelte 5, and Tailwind CSS.

Prerequisites

• Node.js (v20+)
• birda CLI installed and available on your PATH

Setup

npm install

Development

npm run dev

Build

# Build for current platform
npm run dist

# Platform-specific
npm run dist:win     # Windows (NSIS installer + portable)
npm run dist:linux   # Linux (AppImage + deb)
npm run dist:mac     # macOS (dmg)

Tech Stack

• Electron 40 - Desktop runtime
• Svelte 5 - UI framework (runes)
• Tailwind CSS 4 + daisyUI 5 - Styling
• better-sqlite3 - Local detection storage
• WaveSurfer.js - Audio waveform visualization
• MapLibre GL - Map visualization
• electron-vite - Build tooling

License

MIT