The finest search you can buy for no money TM
It comes both in a command-line interface tool and as a C library, both with an easy to use interface.
|cover||Coverart (front images supported only)|
|artistphotos||Photos of a certain band (press or live)|
|artistbio||Artist biography from various sites|
|review||album reviews from various sites|
|albumlist||A list of albums from a specific artist.|
|tags||Tags, either related to artist, album or title|
|relations||links to wikipedia, myspace, musicbrainz ...|
|tracklist||tracklists of an album|
|guitartabs||guitartabs in textual form|
|backdrops||Large artist photos, suitable for backgrounds|
To prevent disambiguation the following terms are used below:
* glyrc is the command-line interface to libglyr.
* libglyr is the library behind, which may be used by your program.
* a getter is a type of metadata to download, e.g.
cover, sometimes also called fetcher
* a provider is a source libglyr queries in order to find the data.
* glyros is the ruby wrapper for this lib. Currently it is not maintained.
glyrc cover -a Foo -b Bar -n 30tries to load 30 covers of album 'Bar' by artist 'Foo'.
See the compile page.
See the examples in src/examples for a quickstart.
There's also a more gentle (and brief) introduction.
Also see the API Reference
Please note: Since version 1.0.0 the API will be stable, and will only be open for extensions.
Please refer to
glyrc -h which gives you a brief introduction to the arguments you can pass,
See the wiki for more detailed information about the options.
Indeed. Should have named it 'Glyros' (too late, damnit).
Some knowledge of C might be required, but the code is straight forward most of the time.
Bash scripts are pretty straight-forward:
glyrc cover --artist Equilibrium --album Sagas --write '/tmp/:artist:_:album:.:format:' --callback 'sxiv ":path:"'
Additionally there are bindings to Python and Ruby:
Well, as normal user you could use
glyrc to retrieve some metadata in a batchlike fashion.
As developers you have lots of option, you could write glyr-plugins for musicplayers (gmpc!), set up a webserver with this,
hack up little scripts showing covers on the desktop.. everything related to musicmetadat is possible here.
You could also extend libglyr itself but that's a little harder.
See the AUTHORS file that comes in glyr's distribution.
See also COPYING to know about your rights.
If you found one: Meh. Sorry for that.
If you file a bugreport: Hey, thank you!
Use the Issue Tracker to share your find.
Alternatively you may drop me a mail at
If you hacked one: Excellent! Send it to me via mail or see below.
If you want to add new providers you should look at the existing provider plugins to get an idea how to write one.
Starting with lib/cover/lastfm.c isn't a bad idea either, because it is one of the very simple ones.
Take the usual Git(Hub) approach:
# Fork this project
# Make your changes
# Make a Pull request
If you're not familiar with git, or just don't like it,
you can also send me the patch via mail:
Thanks for any help in advance!
May sound strange, but you're giving me a reason to maintain it, write new providers etc.
Also bugreports (well, there are no bugs, just in case) are appreciated, or just questions.
Those help to make the documentation more clear.
You also might consider a small (CS-Students are already motivated by 1 Cent ) donation if you use feel like it:
(For now only possible via Flattr or Paypal , you gonna need an account there - Sorry)
As usual, no warranty is granted that this software works like expected.
Refer to the GPLv3 copy you got with libglyr. It is here.
Glyr is just a way to find the data, it does not own any rights on the data it found.
All retrieved items are copyrighted by their respective copyright owners.
 Glyr has not been tested on Mac OSX yet. If you own a Mac, any help with 'porting' glyr is highly appreciated. My guess would be that no to almost no changes need to be done though.