Audion

A modern, local music player with a Spotify-inspired experience

Features • Installation • Development • Plugins • License

📸 Screenshots

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

✨ Features

🎵 Core Music Experience

• 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

🎤 Lyrics Integration

• 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

🎨 Customization

• 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

🔌 Plugin System

• 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

🖥️ Desktop Experience

• 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

📦 Installation

Pre-built Binaries

Download the latest release for your platform from the Releases page.

Build from Source

Prerequisites

• Node.js (v18 or later)
• Rust (latest stable)
• Tauri CLI

Steps

# 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

🛠️ Development

Tech Stack

Project Structure

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

Available Scripts

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 checking

🔌 Plugins

Audion supports a flexible plugin system that allows extending functionality.

Plugin Permissions

Example Plugin

(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.

🗂️ Supported Formats

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

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

Made with ❤️ using Tauri and Svelte