---
name: "glyrc"
section: "1"
platform: "linux"
package: "glyrc"
version: "1.0.10-2.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/glyrc"
---

# glyrc(1)

search engine for music-related metadata

## NAME

glyrc - search engine for music-related metadata

## USAGE

-

  ```
  glyrc GETTER [options]
  ```

where GETTER must be one of:

- •

  cover

- •

  lyrics

- •

  artistphoto

- •

  artistbio

- •

  similarartists

- •

  similarsongs

- •

  albumreview

- •

  albumlist

- •

  tags

- •

  relations

- •

  tracklist

- •

  guitartabs

- •

  backdrops

## GENERAL OPTIONS

### -f --from String

Providers from where to get metadata. Refer to glyrc —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:

- •

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

- •

  artist : Artist - as passed by -a

- •

  album : Album - as passed by -b

- •

  title : Title - as passed by -t

- •

  size : Size in bytes

- •

  format : The image format or \`txt' for textitems

- •

  source : The source URL of this item

- •

  prov : The Provider of this item

- •

  cksum : a md5sum of the data

- •

  rating : (Usually 0)

- •

  duration : (Only for tracks) Duration in seconds

- •

  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 —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.: “png;jpeg”

### -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 —cache.

### cache list

List all items in the database (including the artist / album / title / type). Needs —cache.

## EXAMPLES

-

  ```
  glyrc cover --artist SomeBand --album SomeAlbum
  ```

DB:

-

  ```
  # Write found items to cache; create it if not existent
  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 'A' -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 \<sahib@online.de\>, Etienne Millon.