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

added usage

This commit is contained in:
Martchus 2015-06-21 22:51:25 +02:00
parent 0b52813f81
commit b422794551
1 changed files with 32 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
README.md
View File

@ -16,3 +16,35 @@ It also allows to inspect and validate the element structure of MP4 and Matroska
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".