1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
|
.. _ext-m3u:
**********
Mopidy-M3U
**********
Mopidy-M3U is an extension for reading and writing M3U playlists stored
on disk. It is bundled with Mopidy and enabled by default.
This backend handles URIs starting with ``m3u:``.
Editing playlists
=================
There is a core playlist API in place for editing playlists. This is supported
by a few Mopidy clients, but not through Mopidy's MPD server yet.
It is possible to edit playlists by editing the M3U files located in the
:confval:`m3u/playlists_dir` directory by hand with a text editor.
See `Wikipedia <https://en.wikipedia.org/wiki/M3U>`__ for a short description
of the quite simple M3U playlist format.
If you run Mopidy manually in a terminal, the playlists are usually found in
:file:`~/.local/share/mopidy/m3u/`.
If you run Mopidy as a system service, the playlists are usually found in
:file:`/var/lib/mopidy/m3u/`.
Configuration
=============
See :ref:`config` for general help on configuring Mopidy.
.. literalinclude:: ../../mopidy/m3u/ext.conf
:language: ini
.. confval:: m3u/enabled
If the M3U extension should be enabled or not.
.. confval:: m3u/playlists_dir
Path to directory with M3U files. Unset by default, in which case the
extension's data dir is used to store playlists.
.. confval:: m3u/base_dir
Path to base directory for resolving relative paths in M3U files.
If not set, relative paths are resolved based on the M3U file's
location.
.. confval:: m3u/default_encoding
Text encoding used for files with extension ``.m3u``. Default is
``latin-1``. Note that files with extension ``.m3u8`` are always
expected to be UTF-8 encoded.
.. confval:: m3u/default_extension
The file extension for M3U playlists created using the core playlist
API. Default is ``.m3u8``.
|
