92 lines
2.0 KiB
ReStructuredText
92 lines
2.0 KiB
ReStructuredText
.. _ext-local:
|
|
|
|
************
|
|
Mopidy-Local
|
|
************
|
|
|
|
Extension for playing music from a local music archive.
|
|
|
|
This backend handles URIs starting with ``local:``.
|
|
|
|
|
|
Known issues
|
|
============
|
|
|
|
https://github.com/mopidy/mopidy/issues?labels=Local+backend
|
|
|
|
|
|
Dependencies
|
|
============
|
|
|
|
None. The extension just needs Mopidy.
|
|
|
|
|
|
Default configuration
|
|
=====================
|
|
|
|
.. literalinclude:: ../../mopidy/backends/local/ext.conf
|
|
:language: ini
|
|
|
|
|
|
Configuration values
|
|
====================
|
|
|
|
.. confval:: local/enabled
|
|
|
|
If the local extension should be enabled or not.
|
|
|
|
.. confval:: local/media_dir
|
|
|
|
Path to directory with local media files.
|
|
|
|
.. confval:: local/playlists_dir
|
|
|
|
Path to playlists directory with m3u files for local media.
|
|
|
|
.. confval:: local/tag_cache_file
|
|
|
|
Path to tag cache for local media.
|
|
|
|
.. confval:: local/scan_timeout
|
|
|
|
Number of milliseconds before giving up scanning a file and moving on to
|
|
the next file.
|
|
|
|
.. confval:: local/excluded_file_extensions
|
|
|
|
File extensions to exclude when scanning the media directory. Values
|
|
should be separated by either comma or newline.
|
|
|
|
|
|
Usage
|
|
=====
|
|
|
|
If you want use Mopidy to play music you have locally at your machine, you need
|
|
to review and maybe change some of the local extension config values. See above
|
|
for a complete list. Then you need to generate a tag cache for your local
|
|
music...
|
|
|
|
|
|
.. _generating-a-tag-cache:
|
|
|
|
Generating a tag cache
|
|
----------------------
|
|
|
|
The command :command:`mopidy local scan` will scan the path set in the
|
|
:confval:`local/media_dir` config value for any media files and build a MPD
|
|
compatible ``tag_cache``.
|
|
|
|
To make a ``tag_cache`` of your local music available for Mopidy:
|
|
|
|
#. Ensure that the :confval:`local/media_dir` config value points to where your
|
|
music is located. Check the current setting by running::
|
|
|
|
mopidy config
|
|
|
|
#. Scan your media library. The command writes the ``tag_cache`` to
|
|
the :confval:`local/tag_cache_file`::
|
|
|
|
mopidy local scan
|
|
|
|
#. Start Mopidy, find the music library in a client, and play some local music!
|