Frank Stellmacher
8692e50603
* feat(licenses): tooling and initial data generation Adds the maintainer-only generator that produces src/data/licenses.json: - src-tauri/about.toml + about.hbs: cargo-about config + handlebars template for the Rust-side license enumeration - scripts/generate-licenses.mjs: orchestrator that runs cargo-about and license-checker-rseidelsohn (via npx, no devDep), merges the outputs into a single per-crate JSON with full license texts, and writes the result to src/data/licenses.json The script is invoked directly with `node scripts/generate-licenses.mjs` — no npm script wrapper on purpose, since adding one to package.json would trigger the nix-npm-deps-hash-sync workflow on every push. Initial generation covers 575 cargo crates + 71 npm packages (646 entries total, all with full license text bundled, ~1.4 MB JSON). * feat(licenses): Settings panel UI Adds a new Open Source Licenses section under Settings → System, sitting below Contributors. Components: - LicensesPanel.tsx: search input, curated highlight block of ~10 key dependencies (Tauri, React, rodio, symphonia, etc.), TanStack-Virtual list of all 600+ entries - LicenseTextModal.tsx: full-screen-ish modal showing the bundled license text plus name/version/license-id badges + repository link - licensesData.ts: lazy dynamic-import loader (Vite emits the JSON as a separate chunk, so the heavy ~1.4 MB payload is only loaded when the user actually opens the panel — no runtime fetch, the data is fixed into the build artifact) The panel registers itself in the Settings in-page search index under the System tab. * feat(licenses): i18n in 8 locales Adds the `licenses` namespace (title, intro, highlights, search placeholder, no-results, loading / load error, no-license-text, view-source, total line, generated-at) across en, de, fr, nl, zh, nb, ru, es. License names themselves (MIT, Apache-2.0, GPL-3.0, …) stay universal and are rendered as-is. * docs(release): document licenses regeneration step Adds a Step A.3 to the release SOP describing the maintainer-only `node scripts/generate-licenses.mjs` workflow, the cargo-about prerequisite, and explicitly notes why no npm script wrapper exists (would trigger the nix-npm-deps-hash-sync workflow).
The Ultimate Desktop Client for Self-Hosted Music Libraries
Fast. Beautiful. Native. Feature-packed. Built primarily for Navidrome. Also compatible with Gonic, Airsonic, LMS and other Subsonic-compatible servers with partial feature support.
No telemetry • Native performance • Massive feature set • Community driven
Warning
Psysonic is under heavy active development. Bugs and rough edges are to be expected. We reserve the right to change, remove, or rework existing features at any time without prior notice.
Server Compatibility
Psysonic is optimized first and foremost for Navidrome.
Many advanced functions integrate directly with Navidrome APIs for the best possible experience. Other Subsonic-compatible servers generally work well, but some features may be limited depending on server capabilities.
Why Psysonic?
Most Subsonic clients feel like web wrappers.
Psysonic does not.
It is a true desktop experience built with Rust, Tauri v2, and React for users who care about speed, aesthetics, customization, and serious music library management.
If you host your own music, this is what the premium experience should feel like.
Core Features
Playback Engine
- Gapless playback
- Crossfade
- ReplayGain support
- Smart Loudness Normalization
- Infinite Queue
- Smart Radio sessions
- High responsiveness with low memory usage
Audio Tools
- 10-band Equalizer
- Presets
- AutoEQ headphone correction
- Per-device optimization
Library Power
- Lightning-fast search
- Albums / Artists / Tracks / Genres
- Ratings system
- Multi-select bulk actions
- Drag & drop playlist management
- Huge library friendly
Lyrics & Discovery
- Synced lyrics with seek support
- Auto-scroll sidebar lyrics
- Fullscreen lyric mode
- Last.fm scrobbling
- Similar artists / love tracks / stats
Personalization
- Huge theme collection
- Catppuccin / Nord inspired styles
- Glassmorphism effects
- Font customization
- Zoom controls
- Keybind remapping
- Theme Scheduler (day/night auto switch)
Power User Extras
- CLI controls
- USB / portable sync
- Backup & restore settings
- In-app auto updater
- LAN / remote auto switching
Orbit (Upcoming)
Listen Together. In Sync. Soon.
Currently in final development and testing. Orbit will introduce synchronized shared listening sessions directly inside Psysonic.
- Host-controlled playback
- Join via link
- Shared listening sessions
- Guest song suggestions
- Real-time queue interaction
Rolling out in an upcoming release. Community feedback will help shape the final experience.
Platforms
| OS | Support |
|---|---|
| Windows | Native Installer (certificate pending) |
| macOS | Signed DMG |
| Linux | AppImage / DEB / RPM / AUR (psysonic, psysonic-bin) / NixOS |
Supports 8 languages and growing.
Install
Linux
curl -fsSL https://raw.githubusercontent.com/Psychotoxical/psysonic/main/scripts/install.sh | sudo bash
Windows
Download the latest installer from Releases.
SmartScreen warnings may appear until the code-signing certificate is active.
macOS
Download the signed DMG from Releases.
Development
git clone https://github.com/Psychotoxical/psysonic.git
cd psysonic
npm install
npm run tauri:dev
Build release:
npm run tauri:build
Privacy First
- No telemetry
- No spyware nonsense
- No analytics harvesting
- Your library stays yours
Community
Join Discord, report bugs, suggest features, share themes, shape the future.
License
GNU GPL v3.0
Forks and Attribution
Psysonic is GPLv3 software. You are free to fork, modify, and redistribute it under the terms of that license.
If you distribute a modified or rebranded version, please clearly state that it is based on Psysonic and preserve attribution to the original project.
Features such as Orbit were originally designed and implemented in Psysonic. Forks must not present original Psysonic work as their own independent creation.