Skip to main content

Mike's Opinionated Music Tagger

Opinions are like arseholes. Everyone's got one, and they all stink.

What is this?

A tool for:

  • recursing a convention of folders and files
  • parsing artist, album, and track details from the folder and file names
  • finding and processing cover art files
  • applying everything as a standard set of tags to your music files

It basically keeps a small collection of music reasonably and consistently organized.

  • Every Artist in your collection gets a folder in your Music library. How you name them is up to you. If you prefer "Who, The", that's fine.

  • Every Album in an Artists catalogue gets a folder in the Artist's folder. These are named with:

    • a 4-digit year,
    • a space, a hyphen, and a space,
    • then the Album's title.
  • Every Track on an Album gets a file in the Album's folder. These are named with:

    • a 1–3-digit track number with zero padding if you like,
    • a space, a hyphen, and a space,
    • then the Track's title.

Why?

I like to purchase my music as MP3s from stores like Bandcamp. Not everyone uploads their music with well-formatted metadata, and some music labels seem to see fit to use the metadata tags to advertise things like their websites. Our car has a USB port in its infotainment system which handles navigation by folder and file name but then displays the tags on the dash display. The inconsistency really gets on my nerves, but running adverts on songs I've already paid for is simply unacceptable.

What is this not?

  • A tool for maintaining your carefully curated library of original files.

    This will delete all the tags from your files and replace them with a basic, standard set of tags. Any special metadata you have saved in there will be lost. Keep a copy of your original files somewhere else.

  • A tool for tagging your FLACs and your Ogg Vorbis files.

    My car doesn't play Ogg Vorbis, so that won't be supported. Honestly, if you can tell the difference between V0 MP3s and FLACs while driving, you're probably doing it wrong, and probably twice.

    You probably want Strawberry Music Player instead.

Installation

Debian

TODO: Once we've built the Debian package.

pipx or uvx

If you just want to run the command once, skip to the "Running/pipx or uvx" section. Alternatively, you can install momtag globally with pipx:

$ pipx install momtag

Running

Debian

TODO: Once we've built the Debian package.

pipx or uvx

If you installed momtag globally with pipx or uvx, you can run it like this:

$ momtag --dry-run --verbose ~/Music

If you just want to run it without installing it globally, you can use pipx or uvx to run it:

$ pipx run momtag --dry-run --verbose ~/Music

License

Documentation

momtag's Documentation (C) 2025 by Mike Coats is licensed under Creative Commons Attribution 4.0 International.

Source Code

momtag - Mike's Opinionated Music Tagger

Copyright (C) 2025 Mike Coats i.am@mikecoats.com

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Metadata

Release files for momtag 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for momtag 0.1.1
File Size Uploaded Provenance Actions
momtag-0.1.1.tar.gz 433.1 kB Without provenance Details for momtag-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for momtag 0.1.1
File Interpreter ABI Platform Actions
momtag-0.1.1-py3-none-any.whl Python 3 none any Details for momtag-0.1.1-py3-none-any.whl

Total release size: 459.2 kB

Release files / momtag-0.1.1.tar.gz

Download URL momtag-0.1.1.tar.gz
Size 433.1 kB
Tags Source
SHA-256 checksum
How to use checksums
b99b271ecdf979903ea2ff1974082bf819ac00685bcf2edc48d2c39b68ba9acd
BLAKE2b-256 checksum
How to use checksums
49b864540928655246adcf38f79099df9d9db983bfe3bb72442361ac99255c89
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Release files / momtag-0.1.1-py3-none-any.whl

Download URL momtag-0.1.1-py3-none-any.whl
Size 26.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
37c9afe934fc910f018441fd395b0dc1b2613c412616a5b775e6aa0cfc3034cd
BLAKE2b-256 checksum
How to use checksums
191fd1e3b61a9ff49ee650904116864a56d6c698d0eeef51093610b0fdb5341a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.5

Security for momtag 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page