README for EasyTAG
==================
Home page: https://wiki.gnome.org/Apps/EasyTAG/
Mailing list: <easytag-list@gnome.org>
Description
-----------
EasyTAG is a 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:
* 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)
* can edit more tag fields : Title, Artist, Album, Disc Album, Year, Track
Number, Genre, Comment, Composer, Original Artist/Performer, Copyright, URL
and Encoder name
* auto tagging: parse filename and directory to complete automatically the
fields (using masks)
* ability to rename files and directories from the tag (using masks) or by
loading a text file
* process selected files of the selected directory
* ability to browse subdirectories
* recursion for tagging, removing, renaming, saving…
* can set a field (artist, title, …) to all other selected files
* read file header information (bitrate, time, …) and display them
* auto completion of the date if a partial is entered
* undo and redo last changes
* ability to process fields of tag and filename (convert letters into
upper case, lower case, …)
* ability to open a directory or a file with an external program
* remote and local CDDB support for manual or automatic search
* a tree based browser or a view by Artist & Album
* a list to select files
* a playlist generator window
* a file searching window
* simple and explicit interface!
* Brazilian Portuguese, Bulgarian, Chinese, Czech, Danish, Dutch, French,
German, Greek, Hungarian, Italian, Japanese, Polish, Romanian, Russian,
Spanish, Swedish and Ukrainian translation languages
* written in C and uses GTK+ 2 or GTK+ 3 for the GUI
Installation
------------
### Requirements
* GLib version greater than 2.30.0 (http://www.gtk.org)
* GTK+ version greater than 2.24.0 (http://www.gtk.org)
* libid3tag (http://www.underbit.com/products/mad) (if not deactivated by './configure --disable-mp3')
* id3lib version greater than 3.7.12 (http://id3lib.sourceforge.net) (Recommended: id3lib-3.8.3) (if not deactivated by './configure --disable-id3v23')
* flac (http://flac.sourceforge.net) (if not deactivated by './configure --disable-flac')
* libogg and libvorbis (http://www.vorbis.com) (if not deactivated by './configure --disable-ogg')
* opus and opusfile (http://www.opus-codec.org/) (if not deactivated by './configure --disable-opus')
* taglib (http://taglib.github.com/) (if not deactivated by './configure --disable-mp4')
* wavpack (http://www.wavpack.com/) (if not deactivated by './configure --disable-wavpack')
* yelp-tools (https://git.gnome.org/browse/yelp-tools)
* libc 6 (glibc 2.1) or greater
* appdata-tools (https://github.com/hughsie/appdata-tools)
* intltool (if not deactivated by './configure --disable-nls')
### Compilation instructions
See INSTALL.
Segfault occurs when running EasyTAG?
-------------------------------------
The best way to allow us to fix the problem, is to send a backtrace:
#### Be sure that core files are available
If `ulimit -c` returns 0, then run the command `ulimit -c unlimited`
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)