SolidSonic

SolidSonic is a modern, high-performance desktop music player for Subsonic and OpenSubsonic-compatible servers. Built with SolidJS and Electron, it offers a snappy, reactive user experience combined with flexible audio backends.

✨ Features

• Subsonic/OpenSubsonic Integration: Full support for your favorite music server backends.
• Flexible Audio Backends:
  • HTML5 Audio: Standard web-based playback.
  • MPV (Experimental): Robust playback via node-mpv for advanced formats and high quality.
• Reactive UI: A sleek, modern interface built with SolidJS and Tailwind CSS.
• MPRIS Support: Seamless integration with Linux desktop media controls.
• Advanced State Management: Powered by TanStack Query for efficient data fetching and caching.
• File-Based Routing: Clean and predictable navigation via TanStack Router.
• Cross-Platform: Ready for Windows, macOS, and Linux.

🚀 Tech Stack

• Frontend: SolidJS
• Desktop Framework: Electron
• Routing: TanStack Router
• Data Fetching: TanStack Query
• Styling: Tailwind CSS
• Audio Backends: HTML5 Audio & MPV (via node-mpv)
• Linting/Formatting: Biome
• Build Tool: Vite

❄️ Nix Support

This project includes a Nix Flake for reproducible development environments and packaging.

Development Shell

If you have Nix installed with flakes enabled, you can enter a pre-configured development environment with all dependencies (Node.js, Bun, MPV, Electron, etc.) ready to go:

nix develop

Packaging

To build the SolidSonic package using Nix:

nix build

The resulting binary will be available in ./result/bin/solidsonic.

🛠️ Getting Started

Prerequisites

• Node.js (latest LTS recommended)
• Bun (preferred for dependency management)
• MPV: Ensure mpv is installed on your system and available in your PATH.

Installation

1. Clone the repository:

   git clone https://github.com/imaviso/solidsonic.git
   cd solidsonic

2. Install dependencies:

   bun install
   # or
   npm install

Development

Start the development server with Hot Module Replacement (HMR) and Electron:

npm run electron:dev

Building

To package the application for your current platform:

npm run electron:build

Build for specific platforms:

• npm run electron:build:win
• npm run electron:build:mac
• npm run electron:build:linux

🧪 Testing & Quality

• Run tests: npm run test
• Lint & Format: npm run check
• Fix formatting: npm run format

📂 Project Structure

• electron/: Main process logic, MPRIS integration, and preload scripts.
• src/: Renderer process (SolidJS application).
  • src/components/: Reusable UI components.
  • src/lib/: Core logic (API, Player, Auth, Settings).
  • src/routes/: File-based route definitions.
  • src/hooks/: Custom SolidJS primitives.

📄 License

This project is licensed under the MIT License.