mopidy-smartplaylists/README.md

mopidy-smartplaylists

Mopidy extension for generating diverse, full-length smart playlists from a local music library, with queue auto-refill.

Features

• Genre Mix — playlist of tracks from albums in a given genre
• Artist Mix — playlist of tracks by a given artist
• Album Mix — expanded playlist seeded from an album
• Instant Mix — playlist based on a track (same genre + similar artists)
• Playlist Mix — instant mix generated from a random track in an existing playlist
• Smart Queue — auto-refills the playback queue as tracks play
• Queue Insert — insert smart queue tracks next or at end of the current queue
• HTTP UI — web interface at /smartplaylists/static/

Bookmarklet: Toggle Smart Queue

Drag this link to your bookmarks bar to toggle the Smart Queue:

javascript:(function(){var u=location.origin.replace(/\/+$/,'');fetch(u+'/smartplaylists/smart-queue').then(function(r){return r.json()}).then(function(d){return fetch(u+'/smartplaylists/smart-queue',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({enabled:!d.enabled})})}).then(function(r){return r.json()}).then(function(d){alert('Smart Queue: '+(d.enabled?'On':'Off'))}).catch(function(e){alert('Failed: '+e)})})();

Works from any page on the same Mopidy host (Iris, smart playlists UI, etc.). Uses location.origin and appends /smartplaylists/smart-queue.

Configuration

Add to your Mopidy config:

[smartplaylists]
enabled = true
playlist_prefix = [Smart]
search_uris = local:directory:music

# Smart queue
smart_queue_enabled = true
smart_queue_min_tracks = 5
smart_queue_refill_to = 15
smart_queue_cooldown = 3
smart_queue_variety = 0.15

Development

pip install -e .