Audion

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

---

🎵 What is Audion?

Audion is a privacy-focused music player that brings the Spotify experience to your local music library. No internet required, no tracking—just your music, beautifully organized.

Key highlights:

• Synced lyrics with karaoke-style word highlighting
• Extensible plugin system
• Gorgeous, customizable interface
• Fully offline

---

📸 Screenshots

Desktop

Mobile (Android)

Click any screenshot to view full size

---

⚡ Quick Start

Download

Get the latest builds from Releases.

• Windows: Audion_x64-setup.exe
• macOS (dmg): Audion.dmg
• Linux (AppImage): Audion-x86_64.AppImage
• Linux (Flatpak): audion__linux.flatpak
• Arch Linux (AUR): yay -S audion-bin (Community maintained, auto-updating binary)

Installation Notes

Arch Linux / Arch-based Distros

You can install Audion directly from the Arch User Repository (AUR) using your preferred AUR helper:

# Using yay
yay -S audion-bin

# Using paru
paru -S audion-bin

If you prefer, download the platform-specific asset from the Releases page for your OS.

First Run

1. Launch Audion
2. Click "Add Music Folder" and select your music directory
3. Wait for the scan to complete
4. Enjoy!

---

🐳 Self-Hosted Server (Docker)

Audion now supports a self-hosted streaming server (audion-server-docker) written in Rust with a responsive Svelte frontend. This allows you to host your library on a home server or VPS and stream to your Audion clients anywhere.

Running Audion Server

A preconfigured docker-compose.yml is available in the audion-server-docker directory:

1. Verify configuration in audion-server-docker/docker-compose.yml:

   services:
     audion-server:
       build:
         context: .
         dockerfile: Dockerfile
       ports:
         - "8080:8080"
       volumes:
         - ./data:/data
       environment:
         - AUDION_ADMIN_USER=admin
         - AUDION_ADMIN_PASSWORD=securepasswordhere # Change this!
         - AUDION_JWT_SECRET=your-secret-key-here
         - AUDION_DATA_DIR=/data

2. Start the server:

   cd audion-server-docker
   docker compose up --build -d

3. Access the Web Interface: Navigate to http://localhost (or port 8080 for backend API access directly) to manage files, playlists, and users.

Connecting the Client

To connect your Audion desktop or mobile application to your self-hosted server:

1. Open Audion settings.
2. Under Server Connection, select Custom Server.
3. Input your server URL (e.g., http://your-server-ip:8080) and your credentials.
4. Enjoy streaming playback, library sync, and remote access!

---

✨ Features

Music Management

• Auto-scan local music folders with metadata extraction
• Smart playlists and queue management
• Support for all major audio formats (FLAC, MP3, AAC, ALAC etc.)

Lyrics

• Real-time synced lyrics from LRCLIB and Musixmatch
• Word-by-word karaoke highlighting
• Cached locally for offline use

Customization

• Dark/light themes with custom accent colors
• Full-screen mode
• Mini player
• Keyboard shortcuts

Plugins

Extend Audion with JavaScript/WASM plugins. Learn more →

---

🛠️ Build from Source

Requirements: Node.js 18+, Rust (latest), Tauri CLI

git clone https://github.com/dupitydumb/Audion.git
cd audion
npm install
npm run tauri dev    # Development
npm run tauri build  # Production build

Tech stack: Tauri 2.0, SvelteKit, Rust, SQLite

---

🤝 Contributing

Contributions are welcome! Check out:

• Issues for bugs and feature requests
• PLUGINS.md to create plugins
• Discord to discuss ideas

---

Built with Tauri and Svelte