Menu ▾ ▴

Tree [4c1d3c] dev /
 History

HTTPS git://
HTTPS access

File Date Author Commit
 .github 2025-08-14 Linus Tibert Linus Tibert [2d9644] Update issue templates
 latex 2025-09-28 Linus Tibert Linus Tibert [4d3204] update docs
 src 2025-09-29 Linus Tibert Linus Tibert [7c7bae] add total playtime to statistics
 CHANGELOG.md 2025-09-30 Linus Tibert Linus Tibert [4c1d3c] update changelog
 Cargo.lock 2025-09-30 Linus Tibert Linus Tibert [0cd17b] update ug_scraper dependency
 Cargo.toml 2025-09-30 Linus Tibert Linus Tibert [0cd17b] update ug_scraper dependency
 LICENCE 2025-08-04 Linus Tibert Linus Tibert [703553] Create LICENCE
 README.md 2025-09-28 Linus Tibert Linus Tibert [4d3204] update docs
 TODO.md 2025-09-28 Linus Tibert Linus Tibert [ef8a5f] update todo
 coral-chords.desktop 2025-08-11 Linus Tibert Linus Tibert [70a538] add desktop file

Read Me

Coral-Chords

GitHub
Crates
Coffee Logo

An application to download and sync tabs from Ultimate Guitar with the music playing on Spotify.

cch_themes_transp
Tab sync with Spotify and an integrated search page for tabs; easy to configure and with a wide variety of themes and customization options

Features

  • Searching for tabs
  • Downloading tabs
  • Syncing tabs with Spotify
  • Control the media player and UI using keyboard shortcuts
  • Log the songs you've played locally
  • Show statistics about what you've played
  • Remind you to renew your instrument's strings

Installation

[!IMPORTANT]
Your system needs to use the D-Bus to be able to run this application.
This means it is mainly built for Linux based systems, although it may run on macOS too if the D-Bus is installed.

You can install Coral-Chords using cargo or manually.

Cargo installation

Just run the following command to install:

cargo install Coral-Chords

You can now run Coral-Chords from your terminal to launch the application.
If you want to have an entry for your system's application launcher, you need to create it yourself or follow the manual installation steps.

Manual installation

Download and extract the latest release and follow those instructions:

[!NOTE]
You can also build the binary yourself using cargo build --release in the cloned project directory.
Building this package yourself requires the development tools of openssl to be installed using your system's package manager

  1. Extract the downloaded file
  2. Copy the binary file to ./local/bin with the name coral_chords:
cp Coral-Chords ~/.local/bin/coral_chords
  1. Copy the .desktop file to `.local/share/applications/coral-chords.desktop:
cp coral-chords.desktop ~/.local/share/applications/coral-chords.desktop
  1. Make both files executable:
chmod +x ~/.local/share/applications/coral-chords.desktop ~/.local/bin/coral_chords

Now you should be able to launch the application using your system's default application launcher.

Documentation

The code is widely commented with cargo-doc compatible comments for you to either read them as they are or to build the documentation using cargo doc --no-deps.
A more general documentation and feature guide is available here.

Issues?

If you experience any bugs or have a suggestion about the application, you are welcome to submit an issue on GitHub!

MongoDB Logo MongoDB