Home

Aurora Wiki

Welcome to the documentation for Aurora, a local music player for Linux built in Rust with a client-server (daemon/client) architecture. This wiki covers the system architecture, each crate's internals, the IPC protocol, and the Slint-based GUI.

New here? Start with the Project Overview, then Getting Started & Build Setup to build and run Aurora yourself.

Contents

Overview

• Aurora Music Player — Project Overview
• Getting Started & Build Setup
• System Architecture & IPC

aurora-daemon (Background Service)

• aurora-daemon — Background Service
• Daemon Startup & State Initialization
• Request Handlers & Command Dispatch
• Playback Engine & Audio Pipeline
• Library Indexing & File Watching
• Playlist, Liked Songs & History Persistence
• Background Threads: MPRIS2, Theme & Watcher

aurora-protocol (Shared Schema)

• aurora-protocol — Shared Communication Schema
• Request & Response Enums
• Shared Data Types: Song, Playlist & Theme

aurora-player (GUI Frontend)

• aurora-player — GUI Frontend
• UI–Daemon Bridge (interface.rs)
• Slint UI Components
  • Data Types & Navigation (Types.slint, TabSelectorView.slint)
  • Reusable Widget Library (CustomComp.slint)
• Theming System
• Assets & Fonts

Reference

• Glossary

---

Source code: github.com/mavenried/aurora