Commit 7eb102b7 authored by Canek Peláez's avatar Canek Peláez
Browse files

Merge branch 'master' of aztlan.fciencias.unam.mx:canek/mlm

parents c541eae8 49feff8b
Loading
Loading
Loading
Loading
+6 −0
Original line number Diff line number Diff line
@@ -6,3 +6,9 @@ compile:
  script:
    - meson build
    - ninja -C build

test:
  script:
    - meson build
    - ninja -C build
    - ninja -C build test
+24 −24
Original line number Diff line number Diff line
Music Library Maintainer
════════════════════════
========================

MLM stands for Music Library Maintainer, and is a collection of small utilities
itended to, as its name implies, maintain a music library. It does so by reading
and writting a subset of Id3v2.4.0 tags, hencefort refered as the standard
tags.
and writting a subset of Id3v2.4.0 tags, hencefort refered as the "standard
tags".

Standard tags
─────────────
-------------

The standard tags are:

 Artist (TPE1)
 Title (TIT2)
 Album (TALB)
 Album band (TPE2), usually called Album artist in other suites
 Year (TDRC)
 Track (TRCK), including the total number of tracks on the disc
 Disc number (TPOS)
 Genre (TCON), the standard 148 genres from Id3v1
 Comment (COMM)
 Composer (TCOM)
 Original artist (TOPE)
 Album and artist picture (APIC)
* Artist (`TPE1`)
* Title (`TIT2`)
* Album (`TALB`)
* Album band (`TPE2`), usually called "Album artist" in other suites
* Year (`TDRC`)
* Track (`TRCK`), including the total number of tracks on the disc
* Disc number (`TPOS`)
* Genre (`TCON`), the standard 148 genres from Id3v1
* Comment (`COMM`)
* Composer (`TCOM`)
* Original artist (`TOPE`)
* Album and artist picture (`APIC`)

Utilities
─────────
---------

The utilities are:

mlm-gui: A GNOME 3 program to edit standard tags, and perhaps playing or
* `mlm-gui`: A GNOME 3 program to edit standard tags, and perhaps playing or
  reencoding the file containing them.

mlm-accommodator: Command line tool to acommodate an MP3 file in a standard
* `mlm-accommodator`: Command line tool to acommodate an MP3 file in a standard
  hierarchical location.

mlm-analyze: Command line tool to analyze all the Id3v2.4.0 tags (not only the
* `mlm-analyze`: Command line tool to analyze all the Id3v2.4.0 tags (not only the
  standard ones) in an MP3 file.

mlm-copy-tags: Command line tool to copy the standard tags from an MP3 file to
* `mlm-copy-tags`: Command line tool to copy the standard tags from an MP3 file to
  another.

mlm-tags: Command line tool to modify or print the standard tags of a file or
* `mlm-tags`: Command line tool to modify or print the standard tags of a file or
  group of files.

mlm-verify: Command line tool to verify that an MP3 file follows the MLM
* `mlm-verify`: Command line tool to verify that an MP3 file follows the MLM
  standard.

All the command line utilities accept a --help argument that explains how to
All the command line utilities accept a `--help` argument that explains how to
use it, and include man pages.

data/test/empty.mp3

0 → 100644
+19.9 KiB

File added.

No diff preview for this file type.

data/test/full.mp3

0 → 100644
+30.7 KiB

File added.

No diff preview for this file type.

+3.63 KiB
Loading image diff...
Loading