USAGE

  • glyrc GETTER [options]
    
    

where GETTER must be one of:

\[bu]

cover

\[bu]

lyrics

\[bu]

artistphoto

\[bu]

artistbio

\[bu]

similarartists

\[bu]

similarsongs

\[bu]

albumreview

\[bu]

albumlist

\[bu]

tags

\[bu]

relations

\[bu]

tracklist

\[bu]

guitartabs

\[bu]

backdrops

GENERAL OPTIONS

-f --from String

Providers from where to get metadata. Refer to glyrc \[em]list for a full list

-w --write Path

Write metadata to the dir d, or filename d, special values stdout, stderr and null are supported.

Certain escapes are escaped inside the filename in the form :X:, where X may be one of:

\[bu]

type : The getter used in this query (e.g. cover)

\[bu]

artist : Artist - as passed by -a

\[bu]

album : Album - as passed by -b

\[bu]

title : Title - as passed by -t

\[bu]

size : Size in bytes

\[bu]

format : The image format or `txt' for textitems

\[bu]

source : The source URL of this item

\[bu]

prov : The Provider of this item

\[bu]

cksum : a md5sum of the data

\[bu]

rating : (Usually 0)

\[bu]

duration : (Only for tracks) Duration in seconds

\[bu]

number : An index incremented with each item (starting with 1)

The default format is ':artist::album::title::type::number:.:format:' Strings containing `/' are replaced with `|' automatically, so \[em]write ':artist:' for AC/DC will result in AC|DC

-n --number Integer

Download max. n items. Amount of actual downloaded items may be less.

-l --lang String

Language settings. Used by a few getters to deliever localized data. Given in ISO 639-1 codes like `de'

-o --only-lang

Only use providers that offer language specific data, this only applies for text items.

-z --fuzzyness Integer

Set threshold for level of Levenshtein algorithm.

-q --qsratio Float

How to weight quality/speed; 1.0 = full quality, 0.0 = full speed.

-x --plugmax Integer

Maximum number od download a plugin may deliever. Use to make results more vary.

-v --verbosity Integer

Set verbosity from 0 to 4. See online README for details.

NETWORK OPTIONS

-p --parallel Integer

Define the number of downloads that may be performed in parallel.

-u --useragent String

The useragent to use during HTTP requests

-r --redirects Integer

Define the number of redirects that are allowed.

-m --timeout Integer

Define the maximum number in seconds after which a download is cancelled.

-k --proxy String

Set the proxy to use in the form of [protocol://][user:pass\@]yourproxy.domain[:port]

PROVIDER SPECIFIC OPTIONS

-d --download

Download Images.

-D --skip-download

Don't download images, but return the URLs to them (act like a search engine)

-a --artist String

Artist name to search for

-b --album String

Album name to search for

-t --title String

Songname to search for

-e --maxsize Integer

(images only) The maximum size a cover may have.

-i --minsize Integer

(images only) The minimum size a cover may have.

-F --formats String

A semicolon separated list of imageformats that are allowed. e.g.: \[lq]png;jpeg\[rq]

-8 --force-utf8

Forces utf8 encoding for text items, invalid encodings get sorted out

MISC OPTIONS

-L --list

List all fetchers and source providers for each and exit.

-h --help

This text you unlucky wanderer are viewing.

-V --version

Print the version string.

-U --update

Updates libglyr if new version is available.

-g --as-one

(Textitems only) Output all results as one (useful for tracklist and albumlist).

-G --no-as-one

Disables --as-one (Default)

-y --color

Enables colored output for glyrc (Default)

-Y --no-color

Prints no colored output

-s --musictree-path p

p is a path to your music directory. Glyr might fetch things like folger.jpg from there

-j --callback Command

Set a bash command to be executed when a item is finished downloading; The special string <path> is expanded with the actual path to the data.

DATABASE OPTIONS

-c --cache folder

Creates or opens an existing cache at folder/metadata.db and lookups data from there.

cache select [Query]

Selects data from the cache; you can use any other option behind this.

cache delete [Query]

Instead of searching for this element, the element is deleted from the database. Needs \[em]cache.

cache list

List all items in the database (including the artist / album / title / type). Needs \[em]cache.

EXAMPLES

  • glyrc cover --artist SomeBand --album SomeAlbum
    
    

DB:

  • # Write found items to cache; create it if not existant
    glyrc lyrics -a A -b B --cache /tmp
    
    # List all in the cache
    glyrc cache list --cache /tmp
    
    # Delete artist/album
    glyrc cache delete cover -a Equilibrium -b Sagas --cache /tmp
    
    # Search for two items in cache and print them
    glyrc cache select lyrics -a Knorkator -t \[aq]A\[aq] -n 2 --cache /tmp
    
    

With each item received you get a link to the original source, please refer to the individual terms of use, copying and distributing of this data might be not allowed.

A more detailed version of this help can be found online: https://github.com/sahib/glyr/wiki/Commandline-arguments

AUTHORS

Christopher Pahl <[email protected]>, Etienne Millon.