id3tool/README.md

id3tool

a simple cli tool to clean id3 tags (v23 / v24) from '.mp3' and '.flac' files.

usage

id3tool [options] <directory>

options

• -h | --help: print help
• -d | --debug: enable debug mode
• -f | --frames: frames to keep (comma separated list)

note:

if nothing is specified via the --frames option the following frames will be kept:
APIC, TALB, TCON, TDAT, TDRC, TIT2, TPOS, TPE1, TPE2, TRCK

available frames

v23:

• Attached picture -> APIC
• Chapters -> CHAP
• Comments -> COMM
• Album/Movie/Show title -> TALB
• BPM -> TBPM
• Composer -> TCOM
• Content type -> TCON
• Copyright message -> TCOP
• Date -> TDAT
• Playlist delay -> TDLY
• Encoded by -> TENC
• Lyricist/Text writer -> TEXT
• File type -> TFLT
• Time -> TIME
• Content group description -> TIT1
• Title/Songname/Content description -> TIT2
• Subtitle/Description refinement -> TIT3
• Initial key -> TKEY
• Language -> TLAN
• Length -> TLEN
• Media type -> TMED
• Original album/movie/show title -> TOAL
• Original filename -> TOFN
• Original lyricist/text writer -> TOLY
• Original artist/performer -> TOPE
• Original release year -> TORY
• Popularimeter -> POPM
• File owner/licensee -> TOWN
• Lead artist/Lead performer/Soloist/Performing group -> TPE1
• Band/Orchestra/Accompaniment -> TPE2
• Conductor/performer refinement -> TPE3
• Interpreted, remixed, or otherwise modified by -> TPE4
• Part of a set -> TPOS
• Publisher -> TPUB
• Track number/Position in set -> TRCK
• Recording dates -> TRDA
• Internet radio station name -> TRSN
• Internet radio station owner -> TRSO
• Size -> TSIZ
• ISRC -> TSRC
• Software/Hardware and settings used for encoding -> TSSE
• Year -> TYER
• User defined text information frame -> TXXX
• Unique file identifier -> UFID
• Unsynchronised lyrics/text transcription -> USLT

convenience:

• Artist -> TPE1
• Title -> TIT2
• Genre -> TCON

v24:

• Attached picture -> APIC
• Chapters -> CHAP
• Comments -> COMM
• Album/Movie/Show title -> TALB
• BPM -> TBPM
• Composer -> TCOM
• Content type -> TCON
• Copyright message -> TCOP
• Encoding time -> TDEN
• Playlist delay -> TDLY
• Original release time -> TDOR
• Recording time -> TDRC
• Release time -> TDRL
• Tagging time -> TDTG
• Encoded by -> TENC
• Lyricist/Text writer -> TEXT
• File type -> TFLT
• Involved people list -> TIPL
• Content group description -> TIT1
• Title/Songname/Content description -> TIT2
• Subtitle/Description refinement -> TIT3
• Initial key -> TKEY
• Language -> TLAN
• Length -> TLEN
• Musician credits list -> TMCL
• Media type -> TMED
• Mood -> TMOO
• Original album/movie/show title -> TOAL
• Original filename -> TOFN
• Original lyricist/text writer -> TOLY
• Original artist/performer -> TOPE
• Popularimeter -> POPM
• File owner/licensee -> TOWN
• Lead artist/Lead performer/Soloist/Performing group -> TPE1
• Band/Orchestra/Accompaniment -> TPE2
• Conductor/performer refinement -> TPE3
• Interpreted, remixed, or otherwise modified by -> TPE4
• Part of a set -> TPOS
• Produced notice -> TPRO
• Publisher -> TPUB
• Track number/Position in set -> TRCK
• Internet radio station name -> TRSN
• Internet radio station owner -> TRSO
• Album sort order -> TSOA
• Performer sort order -> TSOP
• Title sort order -> TSOT
• ISRC -> TSRC
• Software/Hardware and settings used for encoding -> TSSE
• Set subtitle -> TSST
• User defined text information frame -> TXXX
• Unique file identifier -> UFID
• Unsynchronised lyrics/text transcription -> USLT

fallback:

• Date -> TDRC
• Time -> TDRC
• Original release year -> TDOR
• Recording dates -> TDRC
• Size -> ``
• Year -> TDRC

convenience:

• Artist -> TPE1
• Title -> TIT2
• Genre -> TCON