Skip to main content

Raphson Music Player

Web-based social music player for parties or social spaces.

What makes this different from other music players? It is designed around listening with groups. Instead of playing a single playlist, this music player allows enabling many playlists from different people. Tracks are shuffled from multiple playlists into a single queue. No more arguing about which music to play, everyone's music get played.

An additional benefit of this is music discovery; even when you're listening solo you might like to mix up your own music with someone else's.

Screenshot of music player

Features

  • Player
    • Shuffle music from multiple people's music collections ("playlists").
    • Shuffle algorithm ensures the least recently played songs are picked first.
    • Of course, you can also manually browse or search the music collection and queue specific songs.
    • Sync players so every room in your house plays the same music, or to listen together with a friend somewhere else.
  • Music library
    • Create playlists using music files (like MP3, FLAC).
    • Are files too old fashioned for you? Link your Spotify playlist and it will be imported automatically!
    • Built-in web file browser to download, upload, rename and delete files.
    • WebDAV protocol support allows you to connect using a file manager of your choice.
    • Download music using the yt-dlp-based downloader.
    • Large, high quality album covers are fetched from MusicBrainz.
    • Time synced lyrics are fetched from various sources.
    • Artist information is downloaded from wikipedia.
    • A metadata editor is available to easily correct metadata while listening.
    • Audio is loudness-normalized ensuring consistent volume for all genres, without losing dynamic range.
  • Responsive and mobile compatible
    • Touch-friendly interface.
    • Optionally, stream at a lower quality to save data.
    • Implements the (Open)Subsonic protocol, allowing you to use native apps.
  • Statistics
    • See what others are playing now or in the past.
    • Statistics page with graphs based on historical data.
    • Users can connect their last.fm account to also save play history there.
  • News
    • Optionally, play hourly news just like real radio.
  • Fun
    • Enable 'Album cover meme mode' to replace album covers by (sometimes) funny memes related to the song title.
    • Play games with your music collections, like a music guessing game.
  • Simple sofware philosophy
    • The server is simple to run with one command. No other services, like a database, are needed.
    • Python dependencies are kept to a minimum to ensure portability.
    • Queued songs are cached, temporary network connection issues are no problem.
    • Written in pure HTML, CSS and JavaScript with only one third party library (eCharts). The frontend should be fast, even on an old laptop or cheap single board computer.

Demo

See docs/demo.md.

Screenshots

See docs/screenshots.md (will load ~20MB of images).

Usage

See docs/installation.md.

  • Headless client: to run on a headless machine with an audio output. Can be controlled remotely.
  • Headless client HA: Home Assistant integration to control a headless client.

Development and translation

See docs/development.md.

Metadata

Release files for raphson-mp 2.14.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for raphson-mp 2.14.0
File Size Uploaded Provenance Actions
raphson_mp-2.14.0.tar.gz 886.5 kB Without provenance Details for raphson_mp-2.14.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for raphson-mp 2.14.0
File Interpreter ABI Platform Actions
raphson_mp-2.14.0-py3-none-any.whl Python 3 none any Details for raphson_mp-2.14.0-py3-none-any.whl

Total release size: 1.9 MB

Release files / raphson_mp-2.14.0.tar.gz

Download URL raphson_mp-2.14.0.tar.gz
Size 886.5 kB
Tags Source
SHA-256 checksum
How to use checksums
bb045349cf56952188e0dd1cbf74195a57463630247114b8ba97bbb9254c0a99
BLAKE2b-256 checksum
How to use checksums
8fbc3abd8370f6f6d6ef8928d64c43d3d35bccbbaf89b08e3c35b0fd5d0f0189
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Release files / raphson_mp-2.14.0-py3-none-any.whl

Download URL raphson_mp-2.14.0-py3-none-any.whl
Size 1.0 MB
Tags Python 3
SHA-256 checksum
How to use checksums
456d6058773fee87b6e975527415a6818631b0bb90b680fe3d33afc77df059b6
BLAKE2b-256 checksum
How to use checksums
05e922a9ae51897b4d427b91115d05ada35061099962b14fcb4e09bdacef60a2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.7

Security for raphson-mp 2.14.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

2.14.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page