1=====================
2Tagging from Filename
3=====================
4
5I added this feature to id3ren, because i never found a good utility
6to set tags to my untagged mp3s. Nearly all useful informations were
7already available in the filenames, and i didn't want to do the job twice.
8
9The tagtemplate can contain the following identifiers :
10 %a - Artist       %c - Comment  %g - Genre  %s - Song Name
11 %t - Album title  %y - Year     %d - Dummy
12
13Example :
14
15My mp3s are stored in a directory for each album. Each song is prefixed
16by the track number.
17
18bash-2.01$ find "/mp3/vast - visual audio sensory theater"
19/mp3/vast - visual audio sensory theater/
20/mp3/vast - visual audio sensory theater/01 here.mp3
21/mp3/vast - visual audio sensory theater/02 touched.mp3
22/mp3/vast - visual audio sensory theater/03 dirty hole.mp3
23/mp3/vast - visual audio sensory theater/04 pretty when you cry.mp3
24/mp3/vast - visual audio sensory theater/05 i'm dying.mp3
25/mp3/vast - visual audio sensory theater/06 flames.mp3
26/mp3/vast - visual audio sensory theater/07 temptation.mp3
27/mp3/vast - visual audio sensory theater/08 three doors.mp3
28/mp3/vast - visual audio sensory theater/09 the niles edge.mp3
29/mp3/vast - visual audio sensory theater/10 somewhere else to be.mp3
30/mp3/vast - visual audio sensory theater/11 .mp3
31/mp3/vast - visual audio sensory theater/12 you.mp3
32
33I want to tag all thoses mp3s :
34
35id3ren -tagonly -tag -tagfromfilename -tagtemplate="/mp3/%a - %t/%n %s.mp3" \
36-genre Alernative -nocomment -year 1998 \
37"/mp3/vast - visual audio sensory theater/*.mp3"
38
39If your mp3s are stored in a directory for the artist and a subdirectory for
40the album name you could use the following tagtemplate : "%a/%t/%n %s.mp3".
41As long as you have a fixed separators between fields, you should be ok.
42
43
44===================================
45Creating Directories while renaming
46===================================
47
48id3ren can now automatically create directory entries if the template contains
49"/". You could use a template like "%a/%t/%n %s.mp3" to create a tree for
50your mp3s, the first level would be the artist, the second the album title,
51and then each file would be composed of the track and the song name.
52It is useful to set a default field to handle blank fields (for example
53-default="unknown").
54
55
56================
57id3 v1.1 Support
58================
59
60id3ren, from version 1.1 and up supports id3 v1.1 transparently.
61An id3 v1.1 tag will be created only if a track number is present.
62
63
64==============================
65Copying tags from another file
66==============================
67
68id3ren can import tags from another tagged file. Use the -copytagfrom
69option along with one or several -copy... (tag field) options.
70Several source files can be used in sequence, like in this example :
71-copytagfrom=/my/first.mp3 -copysong -copyartist \
72-copytagfrom=/my/second.mp3 -copyalbum -copycomment
73