144 lines
3.2 KiB
ReStructuredText
144 lines
3.2 KiB
ReStructuredText
.. _mopidy-cmd:
|
|
|
|
**************
|
|
mopidy command
|
|
**************
|
|
|
|
Synopsis
|
|
========
|
|
|
|
mopidy
|
|
[-h] [--version] [-q] [-v] [--save-debug-log] [--config CONFIG_FILES]
|
|
[-o CONFIG_OVERRIDES] COMMAND ...
|
|
|
|
|
|
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:: --config <file>
|
|
|
|
Specify config file to use. To use multiple config files, separate them
|
|
with a 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.
|
|
|
|
|
|
Built in sub-commands
|
|
=====================
|
|
|
|
.. cmdoption:: run
|
|
|
|
Run the mopidy server.
|
|
|
|
.. cmdoption:: 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:: deps
|
|
|
|
Show dependencies, their versions and installation location.
|
|
|
|
|
|
Extension sub-commands
|
|
======================
|
|
|
|
Additionally, extensions can provide extra sub-commands. See ``mopidy --help``
|
|
for a list of what is available on your system and ``mopidy COMMAND --help``
|
|
for command-specific help. Sub-commands for disabled extensions will be listed,
|
|
but can not be run.
|
|
|
|
.. cmdoption:: local
|
|
|
|
Scan local media files present in your library.
|
|
|
|
|
|
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 run
|
|
|
|
To start the server and change a config value directly on the command line,
|
|
run::
|
|
|
|
mopidy --option mpd/enabled=false run
|
|
|
|
The :option:`--option` flag may be repeated multiple times to change multiple
|
|
configs::
|
|
|
|
mopidy -o mpd/enabled=false -o spotify/bitrate=320 run
|
|
|
|
``mopidy config`` output shows the effect of the :option:`--option` flags::
|
|
|
|
mopidy -o mpd/enabled=false -o spotify/bitrate=320 config
|
|
|
|
|
|
See also
|
|
========
|
|
|
|
:ref:`mopidy-convert-config(1) <mopidy-convert-config>`
|
|
|
|
Reporting bugs
|
|
==============
|
|
|
|
Report bugs to Mopidy's issue tracker at
|
|
<https://github.com/mopidy/mopidy/issues>
|