From 0bcbb47394f2bc685e89fd803b837968b350d232 Mon Sep 17 00:00:00 2001 From: B. Watson Date: Wed, 17 Aug 2016 16:08:04 -0400 Subject: multimedia/glyr: Updated for version 1.0.9, new maintainer. --- multimedia/glyr/README.html | 184 ++++++++++++++++++++++++++++++++++++++++ multimedia/glyr/glyr.SlackBuild | 37 +++++--- multimedia/glyr/glyr.info | 10 +-- 3 files changed, 216 insertions(+), 15 deletions(-) create mode 100644 multimedia/glyr/README.html (limited to 'multimedia') diff --git a/multimedia/glyr/README.html b/multimedia/glyr/README.html new file mode 100644 index 0000000000..5c77d8830e --- /dev/null +++ b/multimedia/glyr/README.html @@ -0,0 +1,184 @@ + +
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.+
Getter | Description | +
---|---|
cover | Coverart (front images supported only) |
lyrics | Songtext |
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 ... |
similarartists | similar artists |
similarsongs | similar songs |
tracklist | tracklists of an album |
guitartabs | guitartabs in textual form |
backdrops | Large artist photos, suitable for backgrounds |
Terminology:
+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 30
tries to load 30 covers of album 'Bar' by artist 'Foo'.qsratio
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.
+ +Refer to the provider's terms of use. Every item you get from libglyr contains the name and a url to the provider, so lookup there terms of use there.
+ +
+
[1] 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.
\ No newline at end of file diff --git a/multimedia/glyr/glyr.SlackBuild b/multimedia/glyr/glyr.SlackBuild index 264711b968..a9e51c8065 100644 --- a/multimedia/glyr/glyr.SlackBuild +++ b/multimedia/glyr/glyr.SlackBuild @@ -22,14 +22,24 @@ # OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF # ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +# Now maintained by B. Watson