-
Notifications
You must be signed in to change notification settings - Fork 686
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
24 changed files
with
622 additions
and
349 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,13 @@ | ||
.. _commands: | ||
|
||
******** | ||
Commands | ||
******** | ||
|
||
Mopidy comes with the following commands: | ||
|
||
.. toctree:: | ||
:maxdepth: 1 | ||
:glob: | ||
|
||
** |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,98 @@ | ||
.. _mopidy-convert-config: | ||
|
||
***************************** | ||
mopidy-convert-config command | ||
***************************** | ||
|
||
Synopsis | ||
======== | ||
|
||
mopidy-convert-config | ||
|
||
|
||
Description | ||
=========== | ||
|
||
Mopidy is a music server which can play music both from multiple sources, like | ||
your local hard drive, radio streams, and from Spotify and SoundCloud. Searches | ||
combines results from all music sources, and you can mix tracks from all | ||
sources in your play queue. Your playlists from Spotify or SoundCloud are also | ||
available for use. | ||
|
||
The ``mopidy-convert-config`` command is used to convert ``settings.py`` | ||
configuration files used by ``mopidy`` < 0.14 to the ``mopidy.conf`` config | ||
file used by ``mopidy`` >= 0.14. | ||
|
||
|
||
Options | ||
======= | ||
|
||
.. program:: mopidy-convert-config | ||
|
||
This program does not take any options. It looks for the pre-0.14 settings file | ||
at ``$XDG_CONFIG_DIR/mopidy/settings.py``, and if it exists it converts it and | ||
ouputs a Mopidy 0.14 compatible ini-format configuration. If you don't already | ||
have a config file at ``$XDG_CONFIG_DIR/mopidy/mopidy.conf``, you're asked if | ||
you want to save the converted config to that file. | ||
|
||
|
||
Example | ||
======= | ||
|
||
Given the following contents in ``~/.config/mopidy/settings.py``: | ||
|
||
:: | ||
|
||
LOCAL_MUSIC_PATH = u'~/music' | ||
MPD_SERVER_HOSTNAME = u'::' | ||
SPOTIFY_PASSWORD = u'secret' | ||
SPOTIFY_USERNAME = u'alice' | ||
|
||
Running ``mopidy-convert-config`` will convert the config and create a new | ||
``mopidy.conf`` config file: | ||
|
||
.. code-block:: none | ||
$ mopidy-convert-config | ||
Checking /home/alice/.config/mopidy/settings.py | ||
Converted config: | ||
[spotify] | ||
username = alice | ||
password = ******** | ||
[mpd] | ||
hostname = :: | ||
[local] | ||
media_dir = ~/music | ||
Write new config to /home/alice/.config/mopidy/mopidy.conf? [yN] y | ||
Done. | ||
Contents of ``~/.config/mopidy/mopidy.conf`` after the conversion: | ||
|
||
.. code-block:: ini | ||
[spotify] | ||
username = alice | ||
password = secret | ||
[mpd] | ||
hostname = :: | ||
[local] | ||
media_dir = ~/music | ||
See also | ||
======== | ||
|
||
:ref:`mopidy(1) <mopidy-cmd>` | ||
|
||
|
||
Reporting bugs | ||
============== | ||
|
||
Report bugs to Mopidy's issue tracker at | ||
<https://github.com/mopidy/mopidy/issues> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,59 @@ | ||
.. _mopidy-scan-cmd: | ||
|
||
******************* | ||
mopidy-scan command | ||
******************* | ||
|
||
Synopsis | ||
======== | ||
|
||
mopidy-scan | ||
[-h] [--version] [-q] [-v] | ||
|
||
|
||
Description | ||
=========== | ||
|
||
Mopidy is a music server which can play music both from multiple sources, like | ||
your local hard drive, radio streams, and from Spotify and SoundCloud. Searches | ||
combines results from all music sources, and you can mix tracks from all | ||
sources in your play queue. Your playlists from Spotify or SoundCloud are also | ||
available for use. | ||
|
||
The ``mopidy-scan`` command is used to index a music library to make it | ||
available for playback with ``mopidy``. | ||
|
||
|
||
Options | ||
======= | ||
|
||
.. program:: mopidy-scan | ||
|
||
.. cmdoption:: --version | ||
|
||
Show Mopidy's version number and exit. | ||
|
||
.. cmdoption:: -h, --help | ||
|
||
Show help message and exit. | ||
|
||
.. cmdoption:: -q, --quiet | ||
|
||
Show less output: warning level and higher. | ||
|
||
.. cmdoption:: -v, --verbose | ||
|
||
Show more output: debug level and higher. | ||
|
||
|
||
See also | ||
======== | ||
|
||
:ref:`mopidy(1) <mopidy-cmd>` | ||
|
||
|
||
Reporting bugs | ||
============== | ||
|
||
Report bugs to Mopidy's issue tracker at | ||
<https://github.com/mopidy/mopidy/issues> |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,124 @@ | ||
.. _mopidy-cmd: | ||
|
||
************** | ||
mopidy command | ||
************** | ||
|
||
Synopsis | ||
======== | ||
|
||
mopidy | ||
[-h] [--version] [-q] [-v] [--save-debug-log] [--show-config] | ||
[--show-deps] [--config CONFIG_FILES] [-o CONFIG_OVERRIDES] | ||
|
||
|
||
Description | ||
=========== | ||
|
||
Mopidy is a music server which can play music both from multiple sources, like | ||
your local hard drive, radio streams, and from Spotify and SoundCloud. Searches | ||
combines results from all music sources, and you can mix tracks from all | ||
sources in your play queue. Your playlists from Spotify or SoundCloud are also | ||
available for use. | ||
|
||
The ``mopidy`` command is used to start the server. | ||
|
||
|
||
Options | ||
======= | ||
|
||
.. program:: mopidy | ||
|
||
.. cmdoption:: -h, --help | ||
|
||
Show help message and exit. | ||
|
||
.. cmdoption:: --version | ||
|
||
Show Mopidy's version number and exit. | ||
|
||
.. cmdoption:: -q, --quiet | ||
|
||
Show less output: warning level and higher. | ||
|
||
.. cmdoption:: -v, --verbose | ||
|
||
Show more output: debug level and higher. | ||
|
||
.. cmdoption:: --save-debug-log | ||
|
||
Save debug log to the file specified in the :confval:`logging/debug_file` | ||
config value, typically ``./mopidy.log``. | ||
|
||
.. cmdoption:: --show-config | ||
|
||
Show the current effective config. All configuration sources are merged | ||
together to show the effective document. Secret values like passwords are | ||
masked out. Config for disabled extensions are not included. | ||
|
||
.. cmdoption:: --show-deps | ||
|
||
Show dependencies, their versions and installation location. | ||
|
||
.. cmdoption:: --config <file> | ||
|
||
Specify config file to use. To use multiple config files, separate them | ||
with colon. The later files override the earlier ones if there's a | ||
conflict. | ||
|
||
.. cmdoption:: -o <option>, --option <option> | ||
|
||
Specify additional config values in the ``section/key=value`` format. Can | ||
be provided multiple times. | ||
|
||
|
||
Files | ||
===== | ||
|
||
/etc/mopidy/mopidy.conf | ||
System wide Mopidy configuration file. | ||
|
||
~/.config/mopidy/mopidy.conf | ||
Your personal Mopidy configuration file. Overrides any configs from the | ||
system wide configuration file. | ||
|
||
|
||
Examples | ||
======== | ||
|
||
To start the music server, run:: | ||
|
||
mopidy | ||
|
||
To start the server with an additional config file than can override configs | ||
set in the default config files, run:: | ||
|
||
mopidy --config ./my-config.conf | ||
|
||
To start the server and change a config value directly on the command line, | ||
run:: | ||
|
||
mopidy --option mpd/enabled=false | ||
|
||
The :option:`--option` flag may be repeated multiple times to change multiple | ||
configs:: | ||
|
||
mopidy -o mpd/enabled=false -o spotify/bitrate=320 | ||
|
||
The :option:`--show-config` output shows the effect of the :option:`--option` | ||
flags:: | ||
|
||
mopidy -o mpd/enabled=false -o spotify/bitrate=320 --show-config | ||
|
||
|
||
See also | ||
======== | ||
|
||
:ref:`mopidy-scan(1) <mopidy-scan-cmd>`, :ref:`mopidy-convert-config(1) | ||
<mopidy-convert-config>` | ||
|
||
Reporting bugs | ||
============== | ||
|
||
Report bugs to Mopidy's issue tracker at | ||
<https://github.com/mopidy/mopidy/issues> |
Oops, something went wrong.