Mopidy-Party

Mopidy web extension designed for party! Let your guests manage the sound ;)

• Minimal, fast web interface designed for mobile
• Search soundtracks and add it to the queue
• Skip current track after a configurable number of votes (defaults to 3)

See this blog entry for some details about this package.

Installation

You must install mopidy (version 3) and some backends (soundcloud, spotify, youtube...).

PROD: you just have to install pip and then:

sudo python3 -m pip install Mopidy-Party

DEV: After cloning the repository, install by running:

sudo python3 -m pip install -e .

Usage

To use the interface, simply use your browser to visit your Mopidy instance's IP at port 6680 to see all available web interfaces. For example, http://192.168.0.2:6680/

Direct access to Mopidy Party should then be: http://192.168.0.2:6680/party/

Configuration

[party]
enabled = true
votes_to_skip = 3     # Votes needed from different users to allow skipping a song.
max_tracks = 0        # Maximum number of tracks that can be added by a single user in a row. 0 for unlimited
max_results = 50      # Maximum number of tracks to show per source when searching / browsing
max_queue_length = 0  # Maximum number of tracks queued at the same time. 0 for unlimited
max_song_duration = 0 # Maximum song duration in minutes. Longer songs are not shown in search results. 0 for unlimited.
hide_pause = false    # Change to true to hide the pause button
hide_skip = false     # Change to true to hide the skip button
style = dark.css      # Stylesheet to use. Also embedded is original.css (light theme)
source_prio = local   # Source search priority. Allows you to configure your best or fastest sources first
  tidal               # for faster response times. One source per line.
  spotify
  youtube
source_blacklist = cd # Blacklist sources you don't want mopidy-party to search. No need to disable the
  file                # plugins. One source per line.

Project resources

• Source code
• Issue tracker
• Development branch tarball

Developer information

The RequestHandler 'config' makes mopidy.conf's section for the [party] configuration available via http GET requests. Useful if you want to make aspects of the controller configurable.

Example: The controller uses the below request, to read the max_results value:

$http.get('/party/config?key=max_results')

Changelog

v1.3.0 (2025-10-12)

• Update fontawesome
• Review search ordering algorithm
• Add max_song_duration, source_prio and source_blacklist config options (by grasdk)

v1.2.2 (2024-03-09)

• Add max_queue_length, max_results config options (by grasdk)

v1.2.1 (2023-08-14)

• Add music source name and icon in search results (by grasdk)
• Bump fontawesome version

v1.2.0 (2022-12-21)

• Add hide_pause, hide_skip, style config options (by grasdk)
• Provide two default styles (dark and original)

v1.1.0 (2022-10-12)

• Use IP from X-Forwarded-For header if available (by girst)
• Limit maximum number of tracks per user in a row (by girst)
• Allows fallback tracks (added by other mopidy frontends) (by girst)
• Dark mode (by girst)

v1.0.0 (2020-01-03)

• Port to python3 and Mopidy 3 (by girst)

v0.3.1 (2018-10-17)

• Vendorize mopidy javascript for 3.0 upstream compatibility

v0.3.0 (2018-08-03)

• Add browse when search string is empty and on load (supports both mopidy-local and mopidy-local-sqlite backends, by juniormonkey)

v0.2.0 (2017-01-08)

• Add vote to skip (by RealityFork)

v0.1.2 (2016-10-10)

• Add artists and album names in songs list

v0.1.0 (2015-09-01)

• Initial release.