Home

Astra User Guide

This wiki documents the features, controls, and behavior you can use in Astra. It is written for the v0.7 series and will follow the current beta as Astra continues to evolve.

You do not need to be an audio engineer to use the advanced sections. Technical terms are explained when they help you make a useful choice; implementation and development documentation live with the source code instead.

Start Here

• Getting Started — Install Astra, add your music, and begin playback.
• Managing Your Music Library — Folders, scanning, metadata, artwork, and library organization.
• Queue and Playback Controls — Playing music, building the queue, shuffle, repeat, volume, and seeking.
• Troubleshooting — Start here when something is not working as expected.

Library and Playback

• Playlists — Normal and dynamic playlists, editing, sorting, and recovery.
• Playlist Import — Import CSV, M3U, XSPF, WPL, and ASX playlists.
• Lyrics — Online and local lyrics, synchronized display, XLRC features, editing, and timing offsets.
• Ratings and Listening Stats — Track ratings, play qualification, history, statistics, imports, and sharing.
• Astra Signal — Share a provider-neutral track link or scannable card.

Sound and Visuals

• Audio Output and Bit-Perfect Playback — Output devices, Standard playback, and native exclusive output.
• Spatial and Multichannel Audio — Direct and binaural rendering, channel routing, Eclipsa/IAMF, Dolby Atmos, and the Virtual Speaker Room.
• Output Delay and Calibration — Measure and correct device latency.
• Equalizer — Parametric EQ, filters, presets, per-device behavior, and AutoEQ.
• Visualizers — The seven scopes, analyzer layouts, profiles, and every visible scope control.
• Audio Pipeline Shelf — Read Astra's live signal-path display.

Interface and Controls

• Themes and Appearance — Themes, cover-art accents, interface scale, greetings, and transport display.
• Keyboard and Controller Controls — Keybinds, global shortcuts, Quick Launch, and controller navigation.

Connections

• Scrobbling — Last.fm, ListenBrainz, AudioScrobbler, custom destinations, and multiscrobble.
• Discord Rich Presence — Presence layout, cover art, links, and privacy controls.
• Remote Libraries — Connect Jellyfin and Subsonic-compatible servers such as Navidrome.
• Phone Remote and Library Sync — Pair a phone, control Astra, and sync supported library data.
• Companion API Setup — Enable the local API and choose what local companion tools are allowed to do.

Parallax and Experimental Tools

• Parallax — Roles, pairing, zones, timing trim, Zone Display, and connection troubleshooting.
• Experimental Features — What experimental status means and where to enable preview features.
• Library Graph — Explore artist and collaboration relationships in your library.
• Library Integrity Scanner — Check files for readability, corruption, and quality warnings.
• Settings Transfer — Move Astra preferences and supported data between installations.

Getting Help

Check Troubleshooting for common symptoms and recovery steps. If the problem continues, report it through the Astra GitHub repository or ask in the Astra Discord.