https://github.com/mgoltzsche/mopidy-webm3u

A Mopidy extension for reading M3U playlists from an HTTP server
https://github.com/mgoltzsche/mopidy-webm3u

m3u m3u-playlist m3u8 m3u8-playlist mopidy mopidy-backend python webm3u

Last synced: about 2 months ago
JSON representation

A Mopidy extension for reading M3U playlists from an HTTP server

• Host: GitHub
• URL: https://github.com/mgoltzsche/mopidy-webm3u
• Owner: mgoltzsche
• License: apache-2.0
• Created: 2024-03-05T02:27:41.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2024-05-19T02:15:38.000Z (8 months ago)
• Last Synced: 2024-09-20T00:40:31.044Z (4 months ago)
• Topics: m3u, m3u-playlist, m3u8, m3u8-playlist, mopidy, mopidy-backend, python, webm3u
• Language: Python
• Homepage:
• Size: 24.4 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
****************

Mopidy-WebM3U

****************

`Mopidy `_ extension for reading M3U playlists from an HTTP server.

For example it allows you to browse and listen to the playlists within your `Beets `_ library that have been generated by Beets' `smartplaylist plugin `_ and served by the `beets-webm3u `_ plugin (on another machine) within Mopidy.

This extension does not support manipulating playlists.

Installation

============

Install by running::

    sudo pip install Mopidy-WebM3U

Configuration

=============

Before starting Mopidy, you must configure it as follows, enabling the webm3u extension and specifying the URL to the M3U playlist of playlists::

    [m3u]

    enabled = false

    [webm3u]

    enabled = true

    seed_m3u = http://beets:8337/playlists/index.m3u

    uri_scheme = m3u

(Mopidy's built-in m3u extension must be disabled in order to be able to use the ``m3u`` URI scheme with the webm3u extension which is required to make playlists show up within the Iris web GUI, see `here `_.)

The playlist of playlists URL specified by the ``seed_m3u`` option is expected to return an `EXTM3U-formatted `_ list of `tagged `_ `*.m3u` HTTP URLs, e.g.::

    #EXTM3U

    #EXTINF:0,Playlist 1

    http://localhost:8337/playlists/playlist1.m3u

    #EXTINF:0,Playlist 2

    http://localhost:8337/playlists/playlist2.m3u

Development

===========

First make sure an example M3U playlist of playlists is served at ``http://localhost:8337/m3u/playlists/index.m3u``, e.g. by running the `beets-webm3u development server `_.

Then you can run a mopidy container with the extension installed (including your local changes) as follows (requires `docker `_)::

    make run

Once Mopidy started, you can browse the playlists within the Iris UI at `http://localhost:6680/iris/library/playlists `_.