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

# ultimateultimateguitar(1)

CLI to access ultimate-guitar.com

## NAME

ultimateultimateguitar - CLI to access ultimate-guitar.com

## SYNOPSIS

ultimateultimateguitar\
 ultimateultimateguitar \[OPTIONS\] URL

## DESCRIPTION

This command queries the online API provided by ultimate-guitar.com.\
 If the URL of a song is passed as parameter, it will be loaded and displayed directly.\
 Alternatively, calling it without parameter will enter interactive mode.

## INTERACTIVE MODE

### These are the commands that a user might enter in a typical interactive shell:

### EXAMPLE INTERACTION

search mysong\
 load 1\
 transpose +2\
 load 1\
 quit

###

### COMMANDS

- **quit**

  Exit the program.\
   Ctrl+D (EOF) also works.

- **search TEXT**

  Will search the online database for a matching text and return a numbered list.

- **load NUMBER**

  It will download and print the entry with the corresponding number from the last search command.

- **transpose SEMITONES**

  It will transpose the loaded song. To print it, you will have to re-issue the last load command.

- **urlopen URL**

  Loads from a URL rather than from a search.

## COMMAND LINE MODE

- **URL**

  It must be the URL of a song.

###

### OPTIONS

- **-h, --help**

  Show this help message and exit

- **--version**

  Show program's version number and exit

- **--transpose TRANSPOSE, -t TRANSPOSE**

  Transposes the chords of n semitones.\
   It can be a positive or negative integer, to transpose up or down.

## WEB

**https://codeberg.org/ltworf/ultimateultimateguitar**

## AUTHOR

```
Salvo "LtWorf" Tomaselli <tiposchi@tiscali.it>
```