ultimateultimateguitar(1)

📦 version 1.9, in debian trixie, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ ultimateultimateguitar(1) ✨

okay bestie, so this is a page from the General Commands Manual and it's about a lil CLI called ultimateultimateguitar and honestly? it's giving main character energy for anyone who lives on ultimate-guitar.com 💅

🎸 NAME 🎸

ultimateultimateguitar — a CLI to access ultimate-guitar.com 🦋

🫶 SYNOPSIS 🫶

ultimateultimateguitar
ultimateultimateguitar [OPTIONS] URL

💖 DESCRIPTION 💖

So basically this command goes and queries the online API that ultimate-guitar.com provides. no cap, it's just vibing with the internet for you 🌈

If you pass the URL of a song as a parameter, it'll get loaded and displayed directly, right there, instantly, iconic behaviour ⭐

ORRR, if you call it with no parameter at all, it drops you into interactive mode instead 🎀 and that's where the fun really starts.

🧚 INTERACTIVE MODE 🧚

🌸 EXAMPLE INTERACTION 🌸

These are the commands a user might type into a typical interactive shell, just to give you the vibe:

search mysong
load 1
transpose +2
load 1
quit

see? chill. cute. effortless. obsessed 🍓

👑 COMMANDS 👑

  • quit — Exit the program. lowkey the easiest one. Ctrl+D (EOF) also works, so whichever you're feeling 💜
  • search TEXT — Will search the online database for a matching text and hand you back a numbered list. take notes bestie, you'll need those numbers ✨
  • load NUMBER — It'll download and print the entry with the corresponding number from the last search command. yes, the numbers from before — that's the whole point 🎯
  • transpose SEMITONES — It will transpose the loaded song. and listen, this is important: to actually print it, you'll have to re-issue the last load command. the way that it doesn't just show up on its own 😭 so don't panic, just load again 🫶
  • urlopen URL — Loads from a URL rather than from a search. when you already know exactly what you want 💅

🎀 COMMAND LINE MODE 🎀

  • URL — It must be the URL of a song. like, specifically a song. that's the rule 📌

🌟 OPTIONS 🌟

  • -h, --help — Show this help message and exit. the classic. the legend 💫
  • --version — Show program's version number and exit. cute little flex 👑
  • --transpose TRANSPOSE, -t TRANSPOSE — Transposes the chords of n semitones. It can be a positive or negative integer, to transpose up or down. so like, up for the glow-up, down for the sad girl era, your call 🌸

🌈 WEB 🌈

https://codeberg.org/ltworf/ultimateultimateguitar

go look, it's right there, iykyk 🦋

💜 AUTHOR 💜

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

and that's the whole page bestie, no notes, periodt 💅

mwah 💖 this was the CLI for ultimate-guitar.com, brought to you on Mar 24, 2024, as part of ultimateultimateguitar(1) — go forth and shred 🎸✨

📦 where this page comes from