Mist

A modern, desktop-focused web client for OpenSubsonic-compatible music servers.

Note: Mist is still in development.

Features

• Clean, responsive UI built with Svelte 5, optimized for desktop screens
• Client only, no offline mode: everything runs in your browser
• Scrobble tracks to your server
• Create, edit and delete playlists
• Light and Dark themes support
• Immersive fullscreen mode

Screenshots

Installation

Docker

Images are published to the Github Container Registry on releases (see here).

# Use the latest version
docker run -p 8080:80 ghcr.io/kusefiru/mist:latest

# Use a specific version
docker run -p 8080:80 ghcr.io/kusefiru/mist:VERSION

Docker compose

services:
  mist:
    image: ghcr.io/kusefiru/mist:latest
    ports:
      - "8080:80"
    restart: unless-stopped

Static files

Mist is entirely client-side, so you can grab the latest release artefact and run it through a basic nginx setup. See the bundled Docker nginx configuration file.

You can also instead run the included Python script, assuming you have Python 3 on your machine. PORT is optional (default to 8000).

./run_server.py [PORT]

Note: This script uses Python basic HTTP server, see security considerations.

Support

Mist works with any server implementing the OpenSubsonic API.

Tested with:

• Navidrome v0.63.2

If you encounter a problem with a specific server, please open an issue.

Note: Mist is built for desktop browsers. I recommend not using it on mobile at all, as the interface hasn't been conceived for it.

Roadmap

This is a non exhaustive list of features planned for future releases:

• Multi-server support
• Lyrics support
• Internet radios support
• Podcasts support
• Jukebox support
• Equalization settings
• More visualizers
• Native app with Tauri

Feel free to request additional features if not listed here.

License

MIT License