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!
* optional Nautilus extension, for opening of files and directories through the
  Nautilus context menu
* 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+ 3 for the GUI


Installation
------------

### Requirements

* GLib version greater than 2.30.0 (http://www.gtk.org)
* GTK+ version greater than 3.2.1 (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')
* libnautilus-extension (https://wiki.gnome.org/Apps/Nautilus) (if not deactivated by ./configure --disable-nautilus-actions')
* 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)