d99kris / idntag

Automatically identify, tag and rename audio files on Linux and macOS

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Idntag

Linux Mac
Linux macOS

Idntag is a command-line tool that identifies artist and song name in specified audio files and updates their ID3-tag meta-data with correct data, and renames the files on format Artist_Name-Track_Name.

Warning: This tool modifies and renames its input files. The quality of song identification is not perfect and may have some false detections. It is therefore recommended to first make a copy of the files to be identified, so there is a backup in case the results are not good.

Example Usage

$ idntag tests/song.mp3 
tests/song.mp3 : OK : tests/Broke_For_Free-Night_Owl.mp3
$ ls tests/
Broke_For_Free-Night_Owl.mp3
$ ffprobe tests/Broke_For_Free-Night_Owl.mp3 2>&1 | grep -e artist -e title
artist          : Broke For Free
title           : Night Owl

Supported Platforms

Idntag is developed and tested on Linux and macOS.

Installation

Pre-requisites Ubuntu:

sudo apt install git cmake mp3info python3-pip libtag1-dev libchromaprint-dev libchromaprint-tools ubuntu-restricted-extras ffmpeg

Pre-requisites Debian (incl. Debian-based like Raspbian):

sudo apt install git cmake mp3info python3-pip libtag1-dev libchromaprint-dev libchromaprint-tools ffmpeg

Pre-requisites Python:

pip3 install pyacoustid pytaglib

Download the source code:

git clone https://github.com/d99kris/idntag && cd idntag

Generate Makefile and build:

mkdir -p build && cd build && cmake .. && make -s

Optionally run tests:

ctest --output-on-failure

Optionally install in system:

sudo make install

Installation - Third-Party Packages

Disclaimer: The following packages are not maintained nor reviewed by the author of idntag.

Fedora

Idntag

Usage

General usage syntax:

idntag [-k] [-l] path [path ...]
idntag -h
idntag -v

Options:

path            path of a file or directory
-h, --help      show this help message and exit
-k, --keepname  keep original filename
-l, --uselib    use chromaprint lib instead of tools
-v, --version   show program's version number and exit

License

Idntag is distributed under the MIT license. See LICENSE file.

Keywords

linux, macos, fingerprint, music, mp3, automatically tag.

About

Automatically identify, tag and rename audio files on Linux and macOS

License:MIT License


Languages

Language:Shell 47.3%Language:Python 40.0%Language:CMake 6.8%Language:Roff 5.9%