README for EasyTAG
==================

Home page: https://wiki.gnome.org/Apps/EasyTAG/
Discussion forum: https://discourse.gnome.org/tag/easytag

Description
-----------

EasyTAG is a utility for viewing and editing tags for MP3, MP2, FLAC, Ogg
Vorbis, Speex and Opus, MP4/AAC, MusePack, Monkey's Audio and WavPack files.
Its simple and nice GTK+ 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, Speex and Opus 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
* 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.38.0 (https://www.gtk.org)
* GTK+ version greater than 3.14.0 (https://www.gtk.org)
* libid3tag (https://www.underbit.com/products/mad) (if not deactivated by './configure --disable-mp3')
* id3lib version greater than 3.7.12 (https://id3lib.sourceforge.net/) (Recommended: id3lib-3.8.3) (if not deactivated by './configure --disable-id3v23')
* flac (https://xiph.org/flac/) (if not deactivated by './configure --disable-flac')
* libogg and libvorbis (https://xiph.org/vorbis/) (if not deactivated by './configure --disable-ogg')
* libnautilus-extension (https://wiki.gnome.org/Apps/Nautilus) (if not deactivated by ./configure --disable-nautilus-actions')
* libsoup (https://wiki.gnome.org/Projects/libsoup) (if not deactivated for './configure --disable-cddb')
* opus and opusfile (https://www.opus-codec.org/) (if not deactivated by './configure --disable-opus')
* taglib (https://taglib.org/) (if not deactivated by './configure --disable-mp4')
* wavpack (https://www.wavpack.com/) (if not deactivated by './configure --disable-wavpack')
* yelp (https://wiki.gnome.org/Apps/Yelp) is required at runtime for showing the user help
* yelp-tools (https://gitlab.gnome.org/GNOME/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.

When running, if you get the following warning about the EasyTAG settings
schema that is not installed:

(easytag:19122): GLib-GIO-ERROR **: Settings schema 'org.gnome.EasyTAG' is not installed

make sure that the GSettings schema and enums files can be found somewhere in
$XDG_DATA_DIRS/glib-2.0/schemas (for example /usr/share/glib-2.0/schemas) and
that the schema cache has been updated with glib-compile-schemas.

There are two files to copy to the schema path, and the glib-compile-schemas
command must run on the directories which have been updated. Example commands
follow:

sudo cp org.gnome.EasyTAG.enums.xml /usr/share/glib-2.0/schemas
sudo cp data/org.gnome.EasyTAG.gschema.xml /usr/share/glib-2.0/schemas
sudo glib-compile-schemas /usr/share/glib-2.0/schemas/

If uninstalling, the files should be removed and the schema cache updated.

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 should be included in this package in the file COPYING)