What is Maestro?

Maestro is a music files library manager. It allows you to create your own music files library by importing music files (Ogg Vorbis and MP3), ripping and encoding CD track, editing tags and file paths, etc. It stands as a front-end for many command-line tools like ogg123, oggenc, cdparanoia, etc.

For now, it includes two applications:

  • a textual application called maestro-text;
  • a graphical application called maestro-gui.

What can I do with Maestro?

Maestro allows you to:

  • build your own library: Maestro scans a given root directory and extracts
comments from all Ogg Vorbis files or MP3 files found;
  • edit comments of your music files: you can change the title, the artist(s),

the album, the track number, the year, the genre and an extra comment of every Ogg Vorbis/MP3 file;

  • add music files: the Ogg Vorbis/MP3 file is copied in the library root
directory with new tags and a correct path name;
  • import MP3 files: Maestro can convert an MP3 file into an Ogg Vorbis file
and add it into the library;
  • import CD tracks: Maestro can rip a CDDA track, convert it into an Ogg
Vorbis file and add it into the library;
  • remove a music files: you can remove a music file contained in the library;
  • maintain file paths: when you edit or import a song, Maestro automatically
renames the associated file according to your own configuration;
  • search for songs: you can look for a song through the library by giving
some criterias;
  • manage your play lists: you can create play lists, put songs into it or
remove songs;
  • listen to your music: you can create your own play queue and listen to it;
  • access FreeDB: Maestro can find out tags of a CD track by querying the

FreeDB server.

Which license was chosen?

Maestro is released under the GNU GPL (General Public License). For more details, see the file LICENSE.

How can I make an RPM package for my own distribution?

First, download the source tarball. Then:

  • unarchive it and enter into the created directory;
  • edit the section ‘[bdist_rpm]’ of the file ‘setup.cfg’ and change
parameters for your own distribution;
  • type:
    python setup.py bdist_rpm

Two RPM packages (source and binary) will be built in the directory ‘dist’.

What is Ogg Vorbis?

Ogg Vorbis is a free non-patent audio coding format. Its performance is at least equal or better than the MP3, the famous but patent audio coding format. For further information, see http://www.vorbis.com/.

I have installed Maestro. What must I do now?

First, launch the graphical tool:

The textual tool (maestro-text) is quite ugly and only used for tests.

A window will appear. It contains three pages:

  • the page called “Library” which displays all songs contained in the
  • the page called “Play queue” which displays the song which is currently
played and a list of songs which will be played afterwards;
  • the page called “Tasks queue” which displays all tasks which will be


For now, all pages must be empty, except the “Tasks queue” page which might indicate two errors: no configuration files exist for now because it’s the first time you launch maestro-gui. You must build your own library.

You can be in two cases:

  • first case: you already have a pretty-well-organized directory which
contains Ogg Vorbis/MP3 files;
  • second case: you don’t have such a directory or you don’t have any Ogg

Vorbis/MP3 files (what a pity!).

In the second case, you must create a directory which will be the root of your library. For example, type in a shell:

mkdir ~/music

In all cases, click with the right button on the label “Library” and then click on the item “Refresh library...”. A new page will open. Enter the directory you have chosen for your library and click on the button “OK”. If you are in the second case, nothing special will happen but you can now import Ogg Vorbis files, MP3 files or CDDA tracks in your library. If you are in the first case, all Ogg Vorbis files contained in your directory will be scanned and their tags will be displayed in the page “Library”. You can now edit your songs, make search in your library, create a play list and even listen to it.

An error occured when I tried to access the FreeDB server and I am behind a firewall? ---------------------------------------------------------------------------

You must probably set the proxy of your organization.

You can do that by setting one of the following environment variables:

  • http_proxy if it is a HTTP proxy;
  • ftp_proxy if it is a FTP proxy;
  • gopher_proxy if it is a GOPHER proxy.
For example, under bash, type:
export http_proxy="http://my_proxy.organization.net:8080"and then
launch maestro:

Where can I browse the source code?

The source code is available on Bitbucket: https://bitbucket.org/julien1001/maestro.