1README for EasyTAG
2==================
3
4Home page: https://wiki.gnome.org/Apps/EasyTAG/
5Mailing list: <easytag-list@gnome.org>
6
7Description
8-----------
9
10EasyTAG is a utility for viewing and editing tags for MP3, MP2, FLAC, Ogg
11Vorbis, Speex and Opus, MP4/AAC, MusePack, Monkey's Audio and WavPack files.
12Its simple and nice GTK+ interface makes tagging easier under GNU/Linux or
13Windows.
14
15
16Features
17--------
18
19Currently EasyTAG supports the following:
20
21* view, edit, write tags of MP3, MP2 files (ID3 tag with pictures), FLAC files
22  (FLAC Vorbis tag), Ogg Vorbis, Speex and Opus files (Ogg Vorbis tag), MP4/AAC
23  (MP4/AAC tag), MusePack, Monkey's Audio and WavPack files (APE tag)
24* can edit more tag fields : Title, Artist, Album, Disc Album, Year, Track
25  Number, Genre, Comment, Composer, Original Artist/Performer, Copyright, URL
26  and Encoder name
27* auto tagging: parse filename and directory to complete automatically the
28  fields (using masks)
29* ability to rename files and directories from the tag (using masks) or by
30  loading a text file
31* process selected files of the selected directory
32* ability to browse subdirectories
33* recursion for tagging, removing, renaming, saving…
34* can set a field (artist, title, …) to all other selected files
35* read file header information (bitrate, time, …) and display them
36* auto completion of the date if a partial is entered
37* undo and redo last changes
38* ability to process fields of tag and filename (convert letters into
39  upper case, lower case, …)
40* ability to open a directory or a file with an external program
41* CDDB support for manual or automatic search
42* a tree based browser or a view by Artist & Album
43* a list to select files
44* a playlist generator window
45* a file searching window
46* simple and explicit interface!
47* optional Nautilus extension, for opening of files and directories through the
48  Nautilus context menu
49* Brazilian Portuguese, Bulgarian, Chinese, Czech, Danish, Dutch, French,
50  German, Greek, Hungarian, Italian, Japanese, Polish, Romanian, Russian,
51  Spanish, Swedish and Ukrainian translation languages
52* written in C and uses GTK+ 3 for the GUI
53
54
55Installation
56------------
57
58### Requirements
59
60* GLib version greater than 2.38.0 (http://www.gtk.org)
61* GTK+ version greater than 3.10.0 (http://www.gtk.org)
62* libid3tag (http://www.underbit.com/products/mad) (if not deactivated by './configure --disable-mp3')
63* id3lib version greater than 3.7.12 (http://id3lib.sourceforge.net) (Recommended: id3lib-3.8.3) (if not deactivated by './configure --disable-id3v23')
64* flac (http://flac.sourceforge.net) (if not deactivated by './configure --disable-flac')
65* libogg and libvorbis (http://www.vorbis.com) (if not deactivated by './configure --disable-ogg')
66* libnautilus-extension (https://wiki.gnome.org/Apps/Nautilus) (if not deactivated by ./configure --disable-nautilus-actions')
67* opus and opusfile (http://www.opus-codec.org/) (if not deactivated by './configure --disable-opus')
68* taglib (http://taglib.github.com/) (if not deactivated by './configure --disable-mp4')
69* wavpack (http://www.wavpack.com/) (if not deactivated by './configure --disable-wavpack')
70* yelp (https://wiki.gnome.org/Apps/Yelp) is required at runtime for showing the user help
71* yelp-tools (https://git.gnome.org/browse/yelp-tools)
72* libc 6 (glibc 2.1) or greater
73* appdata-tools (https://github.com/hughsie/appdata-tools)
74* intltool (if not deactivated by './configure --disable-nls')
75
76### Compilation instructions
77
78See INSTALL.
79
80When running, if you get the following warning about the EasyTAG settings
81schema that is not installed:
82
83(easytag:19122): GLib-GIO-ERROR **: Settings schema 'org.gnome.EasyTAG' is not installed
84
85make sure that the GSettings schema and enums files can be found somewhere in
86$XDG_DATA_DIRS/glib-2.0/schemas (for example /usr/share/glib-2.0/schemas) and
87that the schema cache has been updated with glib-compile-schemas.
88
89There are two files to copy to the schema path, and the glib-compile-schemas
90command must run on the directories which have been updated. Example commands
91follow:
92
93sudo cp org.gnome.EasyTAG.enums.xml /usr/share/glib-2.0/schemas
94sudo cp data/org.gnome.EasyTAG.gschema.xml /usr/share/glib-2.0/schemas
95sudo glib-compile-schemas /usr/share/glib-2.0/schemas/
96
97If uninstalling, the files should be removed and the schema cache updated.
98
99License
100-------
101
102This program is free software; you can redistribute it and/or modify
103it under the terms of the GNU General Public License as published by
104the Free Software Foundation; either version 2 of the License, or
105(at your option) any later version.
106
107This program is distributed in the hope that it will be useful,
108but WITHOUT ANY WARRANTY; without even the implied warranty of
109MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
110General Public License for more details.
111
112(It should be included in this package in the file COPYING)
113