Martchus
/
tageditor
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
A tag editor with Qt GUI and command-line interface supporting MP4/M4A/AAC (iTunes), ID3, Vorbis, Opus, FLAC and Matroska
18 Commits 2 Branches 60 Tags 4.4 MiB
C++ 96%
JavaScript 2.5%
CMake 0.9%
C 0.6%
Go to file
Martchus b422794551 added usage 2015-06-21 22:51:25 +02:00
application First commit 2015-04-22 19:33:53 +02:00
cli First commit 2015-04-22 19:33:53 +02:00
gui call QMainWindow::eventFilter in MainWindow::eventFilter 2015-06-21 21:49:28 +02:00
misc show more details, added way to show help info 2015-06-11 00:25:10 +02:00
pkgbuild updated generation of translation files 2015-06-12 02:33:39 +02:00
renamingutility First commit 2015-04-22 19:33:53 +02:00
resources First commit 2015-04-22 19:33:53 +02:00
translations First commit 2015-04-22 19:33:53 +02:00
.gitignore updated generation of translation files 2015-06-12 02:33:39 +02:00
LICENSE Initial commit 2015-04-22 19:19:54 +02:00
README.md added usage 2015-06-21 22:51:25 +02:00
general.pri updated generation of translation files 2015-06-12 02:33:39 +02:00
tageditor.pro updated generation of translation files 2015-06-12 02:33:39 +02:00
translations.pri updated generation of translation files 2015-06-12 02:33:39 +02:00

README.md

tageditor

A tageditor with Qt GUI and command line interface. Supports MP4 (iTunes), ID3, Vorbis and Matroska.

Supported formats

The tag editor can read and write the following tag formats:

  • iTunes-style MP4 tags (MP4-DASH is supported)
  • ID3v1 and ID3v2 tags
  • Vorbis comments
  • Matroska/WebM tags and attachments

The tag editor can also display technical information such as the ID, format, bitrate, duration and timestamps of the tracks. It also allows to inspect and validate the element structure of MP4 and Matroska files.

Build instructions

The tageditor depends on c++utilities, qtutilities and tagparser. Is built in the same way as these libaries.

The following Qt 5 modules are requried: core gui script widgets webkitwidgets

Usage

GUI

The GUI should be self-explaining. Just open a file, edit the tags and save the changings.

You can set the behaviour of the editor to keep previous values, so you don't have to enter information like album name or artist for all files in an album again and again.

Checkout the settings dialog. You can customize which fields the editor shows, change some settings regarding the tags processing (ID3 version, preferred character set, ...) and more.

There is also a tool to rename files using the tag information stored in the files. The new name is generated by a small JavaScript which can be customized. An example script is provided. Before any changes are made, you can checkout a preview with the generated file names.

CLI

Checkout the available command line options with --help. Here are Bash examples which illustrate getting and setting tag information:

tageditor get title album artist --files /some/dir/*.m4a

Displays title, album and artist of all *.m4a files in the specified directory.

tageditor set "title=Title of "{1st,2nd,3rd}" file" "title=Title of "{1st,2nd,3rd}" file" "title=Title of "{4..16}"th file" "album=The Album" "artist=The Artist" cover=/path/to/image track={1..16}/16 --files /some/dir/*.m4a

Sets title, album, artist, cover and track number of all *.m4a files in the specified directory. The first file will get the name "Title of 1st file", the second file will get the name "Title of 2nd file" and so on. The 16th and following files will all get the name "Title of the 16th file". The same scheme is used for the track numbers. All files will get the album name "The Album", the artist "The Artist" and the cover image from the file "/path/to/image".