Home

Awesome

<img src="assets/icon.png" alt="sonixd logo" title="sonixd" align="right" height="60px" />

Sonixd

<a href="https://github.com/jeffvli/sonixd/releases"> <img src="https://img.shields.io/github/v/release/jeffvli/sonixd?style=flat-square&color=blue" alt="Release"> </a> <a href="https://github.com/jeffvli/sonixd/blob/main/LICENSE"> <img src="https://img.shields.io/github/license/jeffvli/sonixd?style=flat-square&color=brightgreen" alt="License"> </a> <a href="https://github.com/jeffvli/sonixd/releases"> <img src="https://img.shields.io/github/downloads/jeffvli/sonixd/total?style=flat-square&color=orange" alt="Downloads"> </a> <a href="https://discord.gg/FVKpcMDy5f"> <img src="https://img.shields.io/discord/922656312888811530?color=red&label=discord&logo=discord&logoColor=white" alt="Discord"> </a> <a href="https://matrix.to/#/#sonixd:matrix.org"> <img src="https://img.shields.io/matrix/sonixd:matrix.org?color=red&label=matrix&logo=matrix&logoColor=white" alt="Matrix"> </a>

Sonixd is a cross-platform desktop client built for Subsonic-API (and Jellyfin in 0.8.0+) compatible music servers. This project was inspired by the many existing clients, but aimed to address a few key issues including <strong>scalability</strong>, <strong>library management</strong>, and <strong>user experience</strong>.

Sonixd has been tested on the following: Navidrome, Airsonic, Airsonic-Advanced, Gonic, Astiga, Jellyfin

Demo Sonixd using Navidrome

Features

<h5>* Gapless playback is artifically created using the crossfading players so it may not be perfect, YMMV.</h5>

Screenshots

<a href="https://raw.githubusercontent.com/jeffvli/sonixd/main/assets/screenshots/0.13.1/album.png"><img src="https://raw.githubusercontent.com/jeffvli/sonixd/main/assets/screenshots/0.13.1/album.png" width="49.5%"/></a> <a href="https://raw.githubusercontent.com/jeffvli/sonixd/main/assets/screenshots/0.13.1/artist.png"><img src="https://raw.githubusercontent.com/jeffvli/sonixd/main/assets/screenshots/0.13.1/artist.png" width="49.5%"/></a> <a href="https://raw.githubusercontent.com/jeffvli/sonixd/main/assets/screenshots/0.13.1/search.png"><img src="https://raw.githubusercontent.com/jeffvli/sonixd/main/assets/screenshots/0.13.1/search.png" width="49.5%"/></a> <a href="https://raw.githubusercontent.com/jeffvli/sonixd/main/assets/screenshots/0.13.1/now_playing.png"><img src="https://raw.githubusercontent.com/jeffvli/sonixd/main/assets/screenshots/0.13.1/now_playing.png" width="49.5%"/></a>

Install

You can install sonixd by downloading the latest release for your specified operating system.


Windows

If you prefer not to download the release binary, you can install using winget.

Using your favorite terminal (cmd/pwsh):

winget install sonixd

Arch Linux

There is an AUR package of the latest AppImage release available here.

To install it you can use your favourite AUR package manager and install the package: sonixd-appimage

For example using yay:

yay -S sonixd-appimage

If you encounter any problems please comment on the AUR or contact the maintainer directly before you open an issue here.


Once installed, run the application and sign in to your music server with the following details. If you are using airsonic-advanced, you will need to make sure that you create a decodable credential for your login user within the admin control panel.

If you have any questions, feel free to check out the Usage Documentation & FAQ.

Development / Contributing

This project is built off of electron-react-boilerplate v2.3.0. If you want to contribute to this project, please first create an issue or discussion so that we can both discuss the idea and its feasability for integration.

First, clone the repo via git and install dependencies (Windows development now requires additional setup, see #232):

git clone https://github.com/jeffvli/sonixd.git
yarn install

Start the app in the dev environment:

yarn start

To package apps for the local platform:

yarn package

If you receive errors while packaging the application, try upgrading/downgrading your Node version (tested on v14.18.0).

If you are unable to run via debug in VS Code, check troubleshooting steps here.

If your devtools extensions are failing to run/install, check troubleshooting steps here.

License

GNU General Public License v3.0 ©