John Siu Blog

Tech - Business Tool, Personal Toys

Id3go - ID3v2 Tag Editor

☰ Table of Content

Provide easy viewing and updating of media file tags from command line.

id3go use go-taglib for easy viewing and updating of media file tags.

Features

  • Minimalistic output for easy batch processing
  • Support file list, wildcard filename(shell globing)
  • Support unicode through TagLib
  • Display and update following tags
    • Album
    • Artist
    • Comments
    • Title
    • Track
    • Year

Dependencies

Alpine

1
apk add taglib-dev libc-dev

MacOS

1
brew install taglib

Ubuntu

1
apt-get install libtagc0-dev

Install

1
2
3
go get github.com/J-Siu/id3go
cd $GOPATH/src/github.com/J-Siu/id3go
go install

Usage

Get

Display tags of files.

1
id3go get <files>

Examples:

1
2
id3go get media.mp3
id3go get *.mp3

Set

Set tags of files.

1
id3go set [flags] <files>

Flags:

shortlongusage
-S–Savesave to file. Without this flag, set will not writing to files (dry run).
-A–album stringset album
-a–artist stringset artist
-c–comment stringset comments
-h–helphelp for set
-t–title stringset title
-T–track stringset track
-y–year stringset year

Examples:

1
2
3
4
5
6
7
8
# Set artist="me", title="A song title", in dry run mode (default)
id3go set -a me -t "A song title" song.mp3

# Set artist="me", title="A song title", and saving (-S) to file
id3go set -a me -t "A song title" -S song.mp3

# Set album="My Record" to all mp3 in current dir, dry run only
id3go set --album "My Record" *.mp3

Repository

Contributors

Changelog

  • 1.0
    • Initial release
  • 1.1
    • Add GitHub workflow
    • Use Go module
  • 1.2
    • Use Go 1.16
  • 1.3
    • Remove GitHub workflow due to taglib dependency
  • v1.3.3
    • Use Go 1.18
    • Update packages

License

The MIT License

Copyright (c) 2022 John Siu

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

John Siu

Update: 2022-05-18
comments powered by Disqus