Martchus
/
tageditor
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

updated README.md

This commit is contained in:
Martchus 2015-08-10 01:19:40 +02:00
parent 35d9e1c9e4
commit 310c407cbe
1 changed files with 16 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
README.md
View File

@ -8,16 +8,13 @@ The tag editor can read and write the following tag formats:
- 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.
The tag editor can also display technical information such as the ID, format, language, bitrate,
duration, size, timestamps, sampling frequency, FPS and other information 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
The Tageditor has a GUI (Qt 5) and a command line interface.
### GUI
The GUI should be self-explaining. Just open a file, edit the tags and save the changings.
@ -26,15 +23,19 @@ You can set the behaviour of the editor to keep previous values, so you don't ha
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.
change some settings regarding the tag 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:
Usage:
```
tageditor <operation> [options]
Checkout the available operations and options with --help.
Here are Bash examples which illustrate getting and setting tag information:
```
tageditor get title album artist --files /some/dir/*.m4a
@ -50,3 +51,8 @@ Sets title, album, artist, cover and track number of all *.m4a files in the spec
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".
## 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 webenginewidgets/webkitwidgets