-
Notifications
You must be signed in to change notification settings - Fork 12
/
Copy pathREADME
243 lines (179 loc) · 8.79 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
##########################
# #
# README for EasyTAG 2.1 #
# #
##########################
AUTHOR:
=======
Jérôme Couderc
E-mail: easytag@gmail.com
Home Page: http://easytag.sourceforge.net
http://sourceforge.net/project/?group_id=5216
DESCRIPTION:
============
EasyTAG is an utility for viewing and editing tags for MP3, MP2, FLAC, Ogg
Vorbis, Speex, MP4/AAC, MusePack, Monkey's Audio and WavPack files. Its simple
and nice GTK2 interface makes tagging easier under GNU/Linux or Windows.
FEATURES:
=========
Currently EasyTAG supports the following:
o View, edit, write tags of MP3, MP2 files (ID3 tag with pictures), FLAC files
(FLAC Vorbis tag), Ogg Vorbis and Speex files (Ogg Vorbis tag), MP4/AAC
(MP4/AAC tag), MusePack, Monkey's Audio and WavPack files (APE tag),
o Can edit more tag fields : Title, Artist, Album, Disc Album, Year, Track
Number, Genre, Comment, Composer, Original Artist/Performer, Copyright, URL
and Encoder name,
o Auto tagging: parse filename and directory to complete automatically the
fields (using masks),
o Ability to rename files and directories from the tag (using masks) or by
loading a text file,
o Process selected files of the selected directory,
o Ability to browse subdirectories,
o Recursion for tagging, removing, renaming, saving...,
o Can set a field (artist, title,...) to all other selected files,
o Read file header information (bitrate, time, ...) and display them,
o Auto completion of the date if a partial is entered,
o Undo and redo last changes,
o Ability to process fields of tag and file name (convert letters into
uppercase, downcase, ...),
o Ability to open a directory or a file with an external program,
o Remote and local CDDB support for manual or automatic search,
o A tree based browser or a view by Artist & Album,
o A list to select files,
o A playlist generator window,
o A file searching window,
o Simple and explicit interface!,
o Brazilian Portuguese, Bulgarian, Chinese, Czech, Danish, Dutch, French,
German, Greek, Hungarian, Italian, Japanese, Polish, Romanian, Russian,
Spanish, Swedish and Ukrainian translation languages,
o Written in C and uses GTK+ 2 or GTK+ 3 for the GUI.
INSTALLATION:
=============
1. Requirements :
=================
- GLib version greater than 2.30.0 (http://www.gtk.org)
- GTK+ version greater than 2.24.0 (http://www.gtk.org)
- id3lib version highter than 3.7.12 (http://id3lib.sourceforge.net) (Recommended: id3lib-3.8.3)
- libogg and libvorbis (http://www.vorbis.com) (if not deactivated by './configure --disable-ogg')
- flac (http://flac.sourceforge.net) (if not deactivated by './configure --disable-flac')
- taglib (http://taglib.github.com/) (if not deactivated by './configure --disable-mp4')
- wavpack (http://www.wavpack.com/) (if not deactivated by './configure --disable-wavpack')
- libc 6 (glibc 2.1) or greater
- intltool (if not deactivated by './configure --disable-nls')
2. Compilation Instructions :
=============================
2.1. Before to compile EasyTAG you need to install some libraries.
2.1.1. To install id3lib :
- recompile sources of id3lib (id3lib-3.x.x.tar.gz) (Recommended),
- or install id3lib-3.x.x.i386.rpm and id3lib-devel-3.x.x.i386.rpm
then run the command 'ldconfig' to update shared library symlinks.
(Nota: to see if links have been updated, run the command 'ldconfig -p|grep libid3'
if all is ok, it'll return lines like this :
libid3.so (libc6) => /usr/lib/libid3.so
libid3-3.8.so.2 (libc6) => /usr/lib/libid3-3.8.so.2 )
2.1.2. To install libogg and libvorbis (http://www.vorbis.com) :
Follow the same procedure as id3lib with the following packages :
- http://fatpipe.vorbis.com/files/1.0/unix/libogg-1.0.tar.gz
- http://fatpipe.vorbis.com/files/1.0/unix/libogg-1.0-1.i386.rpm
- http://fatpipe.vorbis.com/files/1.0/unix/libogg-devel-1.0-1.i386.rpm
- http://fatpipe.vorbis.com/files/1.0/unix/libvorbis-1.0.tar.gz
- http://fatpipe.vorbis.com/files/1.0/unix/libvorbis-1.0-1.i386.rpm
- http://fatpipe.vorbis.com/files/1.0/unix/libvorbis-devel-1.0-1.i386.rpm
2.1.3. To install flac (http://flac.sourceforge.net) :
2.1.4. To install taglib (http://taglib.github.com/) :
2.2. Unpack the sources of EasyTAG with
> tar xfvz easytag-x.y.z.tar.gz
(x.y.z represents the version of package, for example : 0.27.1)
2.3. Change into the new directory
> cd easytag-x.y.z/
2.4. Compile and install the program
> ./configure
> make
# make install (You need root privileges)
Notes :
- If you want to compile EasyTAG with gcc3.x, you MUST install a version of id3lib compiled
with the same version of the compiler.
- If you have the both versions of gcc installed (2.9x and 3.x), use the command './configure CC=gcc3'
for compiling with gcc3.
You may now run the program by simply typing "easytag".
(Of course the directory in which you installed it (usually /usr/local/bin) has to
be in your PATH)
3. RPM Building Instructions (RedHat 6.x 7.x) :
===============================================
If you prefer manipulate a RPM, you can build it with the following commands:
3.1. Build the RPM
# rpm -tb easytag-x.y.z.tar.gz
or
# rpm --rebuild easytag-x.y.z.src.rpm
or
copy easytag-x.y.z.tar.gz into directory /usr/src/redhat/SOURCES, get easytag.spec
into tarball, and run :
# rpm -bb easytag.spec
3.2. If succeed, you will found the rpm in /usr/src/redhat/RPM/i386/
4. RPM Building Instructions (RedHat 8.x 9) :
=============================================
If you prefer manipulate a RPM, you can build it with the following commands:
4.1. Build the RPM
# rpmbuild -tb easytag-x.y.z.tar.gz
or
# rpmbuild --rebuild easytag-x.y.z.src.rpm
or
copy easytag-x.y.z.tar.gz into directory /usr/src/redhat/SOURCES, get easytag.spec
into tarball, and run:
# rpmbuild -bb easytag.spec
4.2. If succeed, you will found the rpm in /usr/src/redhat/RPM/i386/
5. Adding a new translation file to EasyTAG :
=============================================
All catalogs are placed into po/ directory and are named as the following: fr.po for
France, de.po for Germany, and so on.
The catalogs which will be compiled with EasyTAG are set into configure.in file, into
field ALL_LINGUAS. If you have created a new translation file for your location, and
want to test it, add the corresponding code (xx for file xx.po) to this field.
Then run the script: ./autogen.sh before to recompile program (see instructions of
paragraph 2).
6. Applying a patch :
=====================
6.1. Unpack the sources (see 2.2),
6.2. Go into the directory where you unpack sources (the parent directory of easytag-x.y.z directory)
6.3. Put the patch file in this directory
6.4. Apply the patch:
for example:
> cat patch_easytag_027_027a.diff | patch -p0 (if patch file was named : patch_easytag_027_027a.diff)
(Note: the pacth file (of above example) is a diff file made with command:
diff -ruN easytag-0.27/ easytag-0.27a/ > patch_easytag_027_027a.diff
in the directory where are locate easytag-0.4 and easytag-0.4a directories)
6.5. Recompile program (see 2.3 + 2.4).
7. Segfault occurs when running EasyTAG? :
==========================================
The best way to allow us to fix the problem, is to send back a backtrace :
7.1. Be sure that core files are availables
If 'ulimit -c' returns 0, then run the command 'ulimit -c unlimited'
7.2. Get the backtrace with 'gdb easytag core' (note that on some systems, the
core file is suffixed by the pid. So use 'core._pid_number_' instead of only
'core').
> gdb easytag core._pid_number_
gdb> bt
gdb> ...
gdb> l
gdb> ...
LICENSE:
========
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
(It sould be included in this package in the file COPYING )
CONTACTS:
=========
Visit the homepage at: http://easytag.sourceforge.net
or: http://sourceforge.net/project/?group_id=5216
for more information and new releases.
This version is currently being maintained in an external version
control repository. If you wish to make a contribution please see the
HACKING document. You may still of course mail the original author any
bug reports, complaints, suggestions and comments to the main author
Jerome Couderc <easytag@gmail.com>.