diff --git a/README.md b/README.md index ca73b1df..ce7ef8ba 100644 --- a/README.md +++ b/README.md @@ -1,18 +1,24 @@
+ Psysonic Logo -## The Ultimate Desktop Client for Self-Hosted Music Libraries +## A modern 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. +**Fast. Native. Beautiful. Built for people who actually care about their music collection.** + +Psysonic is built primarily for **Navidrome** and also works with **Gonic**, **Airsonic**, **LMS** and other Subsonic-compatible servers, depending on the features supported by your server.
-Latest Release GitHub Stars License GPLv3 Tauri v2 Discord Community Telegram Community AUR psysonic AUR psysonic-bin Cachix +Latest Release GitHub Stars License GPLv3 Tauri v2 + +Discord Community Telegram Community Support Psysonic on Ko-fi + +AUR psysonic AUR psysonic-bin Cachix

-**No telemetry • Native performance • Massive feature set • Community driven** +**No telemetry • Native performance • Navidrome-first • Community driven**
@@ -23,95 +29,103 @@ Built primarily for **Navidrome**. Also compatible with **Gonic**, **Airsonic**, --- > [!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. +> Psysonic is under active development. Bugs and rough edges can happen, and features may change as the project evolves. -## Server Compatibility +## What is Psysonic? -**Psysonic is optimized first and foremost for Navidrome.** +Psysonic is a desktop music client for self-hosted music libraries. It is designed for people who want the freedom of their own server without giving up the comfort, polish and speed of a modern music app. -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. +It is built with **Rust**, **Tauri v2** and **React**, with a strong focus on responsiveness, customization, practical music-library workflows and a user interface that does not require a manual before you can press play. -## 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. +Psysonic is **optimized first and foremost for Navidrome**. Other Subsonic-compatible servers can work well too, but advanced features may depend on server-side support. --- -# Core Features +# Highlights -## Playback Engine +## Playback & Queue * Gapless playback * Crossfade * ReplayGain support -* Smart Loudness Normalization +* LUFS-based Smart Loudness Normalization +* [AudioMuse-AI](https://github.com/NeptuneHub/AudioMuse-AI) support * Infinite Queue * Smart Radio sessions -* High responsiveness with low memory usage +* Fast and responsive playback handling +* Low memory usage compared to heavy web-first clients ## Audio Tools * 10-band Equalizer -* Presets +* Equalizer presets * AutoEQ headphone correction * Per-device optimization +* Loudness-aware playback options -## Library Power +## Library Management -* Lightning-fast search -* Albums / Artists / Tracks / Genres -* Ratings system +* Fast search across large libraries +* Albums, artists, tracks and genres +* Ratings support * Multi-select bulk actions * Drag & drop playlist management -* Huge library friendly +* Smart Playlists +* Built for large self-hosted collections ## Lyrics & Discovery * Synced lyrics with seek support -* Auto-scroll sidebar lyrics +* Lyrics provider support: [YouLy+](https://github.com/ibratabian17/YouLyPlus), LRCLIB and NetEase +* Auto-scrolling sidebar lyrics * Fullscreen lyric mode * Last.fm scrobbling -* Similar artists / love tracks / stats +* Similar artists +* Loved tracks and listening stats -## Personalization +## Sharing & Social Listening -* Huge theme collection -* Catppuccin / Nord inspired styles +* Magic Strings sharing: + + * share albums, artists and queues + * Navidrome user management helpers + * fast account sharing +* Orbit shared listening sessions: + + * host-controlled synchronized playback + * session invites via link + * guest song suggestions + * real-time queue interaction + +## Personalization & Accessibility + +* Large theme collection +* Catppuccin and Nord inspired styles * Glassmorphism effects * Font customization * Zoom controls * Keybind remapping -* Theme Scheduler (day/night auto switch) +* Theme Scheduler for automatic day/night switching +* Colorblind-friendly theme options +* Keyboard-friendly navigation ## Power User Extras * CLI controls * USB / portable sync -* Backup & restore settings +* Backup and restore settings * In-app auto updater * LAN / remote auto switching --- -# Orbit (Upcoming) +
+ Shared listening feature banner +
-## Listen Together. In Sync. Soon. +Orbit brings synchronized shared listening sessions directly into Psysonic. -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.** +Start a session, invite others with a link and listen together with host-controlled playback, shared queue interaction and guest song suggestions. It is built for real-world music sharing without turning your self-hosted setup into a social-media circus. --- @@ -119,11 +133,11 @@ Currently in final development and testing. Orbit will introduce synchronized sh | OS | Support | | ------- | --------------------------------------------------------------- | -| Windows | Native Installer *(certificate pending)* | +| Windows | Native installer | | macOS | Signed DMG | | Linux | AppImage / DEB / RPM / AUR (`psysonic`, `psysonic-bin`) / NixOS | -Supports **8 languages** and growing. +Psysonic supports **8 languages** and growing. --- @@ -135,15 +149,15 @@ Supports **8 languages** and growing. curl -fsSL https://raw.githubusercontent.com/Psychotoxical/psysonic/main/scripts/install.sh | sudo bash ``` +Linux builds are also available through GitHub Releases, AUR and Cachix/Nix. + ## Windows -Download the latest installer from Releases. - -> SmartScreen warnings may appear until the code-signing certificate is active. +Download the latest installer from the [GitHub Releases](https://github.com/Psychotoxical/psysonic/releases/latest). ## macOS -Download the signed DMG from Releases. +Download the signed DMG from the [GitHub Releases](https://github.com/Psychotoxical/psysonic/releases/latest). --- @@ -164,41 +178,50 @@ npm run tauri:build --- -# Privacy First +# Privacy + +Psysonic is built for self-hosted music collections. Your library is yours. * No telemetry * No spyware nonsense * No analytics harvesting -* Your library stays yours +* No hidden tracking --- -# Community +# Community & Support -Join Discord, report bugs, suggest features, share themes, shape the future. +Join the community, report bugs, suggest features, share themes and help shape the future of Psysonic. + +* [Discord](https://discord.gg/AMnDRErm4u) +* [Telegram](https://t.me/+GLBx1_xeH28xYTJi) +* [GitHub Issues](https://github.com/Psychotoxical/psysonic/issues) +* [Support Psysonic on Ko-fi](https://ko-fi.com/psychotoxic) --- # License -GNU GPL v3.0 +Psysonic is licensed under the **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. +Psysonic is free and open-source software under the GPLv3. You are welcome to fork it, modify it and build upon it under the terms of the 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. +If you publish a modified or rebranded version, please make it clear that your project is based on Psysonic and preserve proper 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. +That is not about preventing forks. Forks are part of open source. It is about being honest with users and contributors about where the work comes from. + +Features, design work and implementation ideas developed in Psysonic should not be presented as unrelated original work in downstream projects. ---
-## Stop using boring music clients. +## Own your music. Enjoy the client too. -## Use Psysonic. +**Psysonic brings a modern desktop experience to self-hosted music libraries.**
diff --git a/public/orbit.png b/public/orbit.png new file mode 100644 index 00000000..7d7e06be Binary files /dev/null and b/public/orbit.png differ diff --git a/public/screenshot1.png b/public/screenshot1.png index 218b6c82..ac3aecec 100644 Binary files a/public/screenshot1.png and b/public/screenshot1.png differ