Skip to main content

The ultimate tool for managing your music library.

Project description

Moe is our resident Music-Organizer-Extraordinaire who’s sole purpose is to give you full control over your music library by streamlining the process between downloading/ripping music to your filesystem and listening to it with your favorite music player.

In short, Moe maintains a database of your music library that can be updated with various metadata sources, queried, edited, etc. through either an API or command-line interface. All of these features, and more, are made available by a highly extensible plugin ecosystem.

Because all of this functionality is available as a python API which doesn’t always require a database of music to operate on, Moe also provides an extensive suite of tools for handling and operating on music files. This can greatly simplify or enhance any other script/program that deals with music.



Moe comes with a command-line interface which is how most users will take advantage of the library management features. Below is a screenshot of Moe importing an album from the filesystem and adding it to the underlying database all while fixing tags, relocating the files, and anything else you can imagine.


Once added to Moe, querying your library or manipulating your music by editing tags, renaming files, etc. is all just a single command away. The ultimate goal is to automate away any tedius and time-consuming steps you have in your workflow without sacrificing the attention to detail. With the help of an extremely flexible plugin system, you can easily fine-tune your music library exactly how you like.


As previously mentioned, all of Moe’s music management logic and functionality is also available as a python library. As an example, below is a standalone script that takes an album directory and Musicbrainz release ID from the command-line, and then updates the underlying files’ tags with any changes from Musicbrainz.

#!/usr/bin/env python3

import argparse
import pathlib

from moe.config import Config, ConfigValidationError
from moe.library import Album
from moe.write import write_tags
import moe_musicbrainz

def main():
        config.Config(config_dir=Path.home() / ".config" / "my_script", init_db=False)
    except config.ConfigValidationError as err:
        raise SystemExit(1) from err

    parser = argparse.ArgumentParser(
        description="Update an album with musicbrainz tags."
    parser.add_argument("path", help="dir of the album to update")
    parser.add_argument("mb_id", help="musicbrainz id of the album to fetch")
    args = parser.parse_args()

    album = Album.from_dir(pathlib.Path(args.path))

    album.merge(moe_musicbrainz.get_album_by_id(args.mb_id), overwrite=True)

    for track in album.tracks:

if __name__ == "__main__":

This is just a small taste of what Moe is capable of and how it can make your life easier when dealing with music.

If you want to learn more, check out the Getting Started docs.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

moe-2.1.1.tar.gz (48.5 kB view hashes)

Uploaded source

Built Distribution

moe-2.1.1-py3-none-any.whl (70.5 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page