Skip to content

km0e/umile

Repository files navigation

Umile

a simple command line tool to merge info into a music file.

Installation

Release

Usage

use umile to merge metadata into a music file.

Merge audio files with metadata

Usage: umile merge [OPTIONS] <--title <TITLE>|PATH>

Arguments:
  <PATH>  Path to the audio file

Options:
  -o, --output <OUTPUT>  Output path for the modified audio file, default ${path}.merged.mp3
  -l, --lyric <LYRIC>    Path to the LRC file for lyrics
  -c, --cover <COVER>    Path to the cover image file
  -a, --album <ALBUM>    Album name to set in the ID3 tag
  -r, --artist <ARTIST>  Artist name to set in the ID3 tag
  -t, --title <TITLE>    Title to set in the ID3 tag
  -h, --help             Print help

If you specify the --title option and the configuration file exists, it will be used to set the title, artist, album, cover, and lyric. But all command line options will override the configuration file.

Features

type lyric cover album artist title
mp3 yes yes yes yes yes
flac 🚧 🚧 🚧 🚧 🚧

Configuration

We can generate a configuration file like this:

umile fc toml >config.toml

Example configuration file config.toml:

[[music]]
path = "path/to/audio/file.mp3"
output = "path/to/output/file.mp3"
lyric = "path/to/lyrics/file.lrc"
cover = "path/to/cover/image.jpg"
album = "Album Name"
artist = "Artist Name"
title = "Song Title"

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

For any issues or contributions, please open an issue or pull request on the GitHub repository. Or you can contact me via email at kmdr.error@gmail.com.