MOPIDY(1)

✨ NAME ✨

mopidy — bestie, it's an extensible music server 🎶💖

---

🌸 SYNOPSIS 🌸

mopidy [-h|--help] [--version] [-q|--quiet] [-v|--verbose] [--config
PATH] [-o|--option SECTION/KEY=VALUE] [COMMAND]

---

🦋 DESCRIPTION 🦋

Okay so picture this: Mopidy is a music server, right? And she can play music from, like, multiple sources at once. Your local hard drive? Yes. Radio streams? Obviously. Spotify and SoundCloud? Bestie, absolutely. 💅

Searches pull results from all your music sources combined — no cap — and you can mix tracks from all of them together in your play queue like it's nothing. Your playlists from Spotify or SoundCloud are also there, ready to use. 👑

Running the mopidy command starts the server. That's the whole vibe.

So, the tea: vanilla Mopidy only plays music from files and radio streams. If you want more music sources, that's what extensions are for. Extensions can also add commands to this command. Check the COMMANDS section below for the details. ✨

---

💖 OPTIONS 💖

• -h, --help — shows you a help message and then peaces out.
• --version — spits out the Mopidy version number and exits.
• -q, --quiet — show less output. Only warnings and more serious messages. Lowkey minimal. 🙈
• -v, --verbose — show more output. And you can repeat it up to four times for even more. The way that scales… 📈
• --config PATH — use the given config files and directories. Separate multiple values with a colon, or just repeat the option. If two files set the same value, the later file overrides the earlier one. And if PATH is a directory, Mopidy uses every file in it that has a .conf suffix. 🎀
• -o SECTION/KEY=VALUE, --option SECTION/KEY=VALUE — set a config value right on the command line. Repeat the option to set more than one value. Anything you set here overrides the same value in the config files. Periodt. 🔥

---

🌈 COMMANDS 🌈

• config — show the config that's actually in effect. Mopidy merges all the config sources together to make this document. She masks secret values, like passwords (as she should 💅). The output does not include the config of disabled extensions.
• deps — show the dependencies, their versions, and where they're installed.

Extensions can add more commands. Run mopidy --help to see the commands that are available on your system. Heads up bestie: the list includes the commands of disabled extensions, but you cannot run those. 😭

---

🎀 FILES 🎀

• /usr/share/mopidy/conf.d/*.conf — the default config of the Debian package. Do not change these files. The files in /etc/mopidy override them.
• /etc/mopidy/mopidy.conf — the system wide config file.
• ~/.config/mopidy/mopidy.conf — your personal config file. It overrides the system wide config file.

Not me being the bearer of bad news but: when you start Mopidy as a system service, the service uses the first two paths only. It does not read the personal config file. Sorry bestie. 💀

---

⭐ EXAMPLES ⭐

Start the music server:

mopidy

Start the server with one more config file, which overrides the config files that Mopidy uses by default:

mopidy --config ./my-config.conf

Start the server and change one config value on the command line:

mopidy --option mpd/enabled=false

Change more than one config value:

mopidy -o mpd/enabled=false -o spotify/bitrate=320

Show the effect of the -o options:

mopidy -o mpd/enabled=false -o spotify/bitrate=320 config

---

🧚 SEE ALSO 🧚

mopidyctl(8)

The full documentation is at https://docs.mopidy.com/. Go read it, it's giving ✨informed✨.

---

💜 BUGS 💜

Found a bug in Debian? Report it to the Debian bug tracking system. See reportbug(1).

Found a bug in Mopidy itself? Report it to the upstream issue tracker at https://github.com/mopidy/mopidy/issues. 🫶

---

And that's the whole page, bestie! This was the Mopidy general commands manual page, dated 2026-09-12 — so if you're reading this way later, go vibe check the docs. Byeeee 💖✨🎀🦋🌸💅🌈👑