Coral-Chords

Crates.ioCoral-Chords
lib.rsCoral-Chords
version0.7.3
created_at2025-08-11 18:14:59.717335+00
updated_at2026-01-21 19:40:00.550477+00
descriptionChord downloading from Ultimate Guitar and synching with media player
homepagehttps://lich-corals.de/projects/coral-chords/
repositoryhttps://codeberg.org/Lich-Corals/coral-chords/
max_upload_size
id1790544
size347,060
Jax Tibert (Lich-Corals)

documentation

README

Coral-Chords

Website Codeberg Crates Coffee Logo

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

cch_themes_transp
Tab syncing with media players 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 any media player using MPRIS
  • 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 Codeberg!

Commit count: 198

cargo fmt