A modern, local music player with a Spotify-inspired experience
Features • Installation • Development • Plugins • License
Clean, modern interface for browsing your music library
Real-time synced lyrics with smooth scrolling
Immersive full-screen player with album art and lyrics
Beautiful album pages with track listings
Extensible plugin system for custom functionality
- Local Library Management — Scan and organize your local music collection with automatic metadata extraction
- Album Art Display — Beautiful album artwork fetched from your music files
- Smart Playlists — Create, edit, and manage custom playlists
- Queue Management — Full queue control with drag-and-drop reordering
- Synced Lyrics — Real-time synchronized lyrics from LRCLIB and Musixmatch
- Word-by-Word Sync — Premium karaoke-style word highlighting
- Lyrics Panel — Dedicated panel with smooth auto-scrolling
- Local Caching — LRC files saved locally for offline access
- Theme Engine — Fully customizable color schemes with live preview
- Dark/Light Mode — System-aware theme switching
- Accent Colors — Choose your preferred accent color palette
- Mini Player — Compact mode for minimal desktop footprint
- Extensible Architecture — JavaScript and WebAssembly plugin support
- Permission System — Granular permissions for plugin security
- Event API — React to player events (track changes, play/pause, etc.)
- UI Injection — Plugins can add custom UI elements
- Full-Screen Mode — Immersive full-screen player with lyrics
- Keyboard Shortcuts — Quick controls for power users
- Context Menus — Right-click actions for tracks, albums, and artists
- Cross-Platform — Native performance on Windows, macOS, and Linux
Download the latest release for your platform from the Releases page.
| Platform | Download |
|---|---|
| Windows | Audion_1.0.0_x64-setup.exe |
# Clone the repository
git clone https://github.com/dupitydumb/Audion.git
cd audion
# Install dependencies
npm install
# Run in development mode
npm run tauri dev
# Build for production
npm run tauri build| Layer | Technology |
|---|---|
| Framework | Tauri 2.0 |
| Frontend | SvelteKit + TypeScript |
| Backend | Rust |
| Database | SQLite (via rusqlite) |
| Styling | CSS Variables + Custom Theme Engine |
audion/
├── src/ # Frontend (SvelteKit)
│ ├── lib/
│ │ ├── components/ # UI components
│ │ ├── stores/ # Svelte stores (state management)
│ │ ├── plugins/ # Plugin runtime & API
│ │ ├── lyrics/ # Lyrics fetching (LRCLIB, Musixmatch)
│ │ └── api/ # Tauri API wrappers
│ └── routes/ # SvelteKit routes
├── src-tauri/ # Backend (Rust)
│ ├── src/
│ │ ├── commands/ # Tauri commands
│ │ ├── db/ # SQLite database operations
│ │ └── scanner/ # Music file scanner
│ └── tauri.conf.json # Tauri configuration
├── plugin-examples/ # Example plugins
└── static/ # Static assets
npm run dev # Start SvelteKit dev server
npm run build # Build frontend for production
npm run tauri dev # Run full Tauri app in development
npm run tauri build # Build production binaries
npm run check # TypeScript type checkingAudion supports a flexible plugin system that allows extending functionality.
| Permission | Description |
|---|---|
player:read |
Access current track, playback state |
player:control |
Play, pause, skip, seek |
storage:local |
Persist plugin data locally |
ui:inject |
Add custom UI elements |
system:notify |
Show system notifications |
(function() {
const MyPlugin = {
init(api) {
this.api = api;
// Listen for track changes
api.on('trackChange', (track) => {
console.log('Now playing:', track.title);
});
},
start() {
// Plugin enabled
},
stop() {
// Plugin disabled
}
};
window.MyPlugin = MyPlugin;
window.AudionPlugin = MyPlugin;
})();See the plugin-examples folder for more examples.
Audion supports all audio formats that your system can play, including:
- Lossless: FLAC, WAV, ALAC, AIFF
- Lossy: MP3, AAC, OGG, Opus, M4A
- Metadata: ID3v2, Vorbis Comments, APE Tags
This project is licensed under the MIT License. See the LICENSE file for details.