<div align="center"> <img src="data/icons/hicolor/scalable/apps/io.github.dzheremi2.lrcmake-gtk.svg" width="128" height="128">

Chronograph

Sync Lyrics of Your Loved Songs 🕒

<a href="https://flathub.org/apps/io.github.dzheremi2.lrcmake-gtk"><img alt="Flathub Version" src="https://img.shields.io/flathub/v/io.github.dzheremi2.lrcmake-gtk?style=for-the-badge&logo=flathub&color=lightblue"></a> <a href="https://github.com/Dzheremi2/Chronograph/actions"><img alt="GitHub Actions Workflow Status" src="https://img.shields.io/github/actions/workflow/status/Dzheremi2/Chronograph/.github%2Fworkflows%2Fci.yml?style=for-the-badge&logo=github"></a>

</div>

About Chronograph

Chronograph is an open-source application designed for accurately syncing lyrics with audio timestamps.

You may notice that many of music players support synced lyrics which are highlighted line-by-line or word-by-word while playing? This app was designed to give the community an ability to be the ones who make these lyrics.

Chronograph directly supports publishing to LRCLib. As many FOSS music players use LRCLib to fetch synchronized lyrics, this integration allows users to easily contribute their work back to the open-source community.

If you have a large base of music and just want to download lyrics for all of it, Chronograph also supports mass lyrics downloading. It will try to find lyrics for each of your track on LRClib and save it depending on your settings.

Syncing Modes

• Line-by-Line (Primary): Here, every time you do sync action, timestamp is placed for the whole line of lyrics. This is the most supported format of synced lyrics.
• Word-by-Word (Advanced): Designed for true karaoke quality. It places a timestamp for every single word, enabling players to animate lyrics with precision.

Supported Formats

• OGG
• FLAC
• MP3
• M4A
• OPUS
• WAV
• AAC (reduced functionality)

Installation

Linux

Flatpak

<a href='https://flathub.org/apps/io.github.dzheremi2.lrcmake-gtk'> <img width='240' alt='Get it on Flathub' src='https://flathub.org/api/badge?svg&locale=en'/> </a>

You can download app either on Flathub or by downloading and installing bundle from the latest release

Arch Linux

The app is available on AUR as chronograph package made by Mark Wagie (@yochananmarqos)

AppImage

AppImage is only available on GitHub Releases since v49

[!TIP] See how to build AppImage here

Windows

Chronograph for Windows is only available on GitHub Releases since v5.3.1

Releases

Chronograph has three types of releases stable, release candidates (beta) and devel (alpha)

Stable

Stable releases are available on Fridays (if not a hotfix) if their develepment cycle has ended. Could be downloaded either on Flathub or via GitHub Releases

Release Candidate

RCs are published before the stable release in friday-awaiting time for users to be able to test them and report bugs before the release happens. Could be downloaded only on GitHub Releases. RCs are marked as Pre-release

Devel

Devel build are formed for every commit on any branch except for main. These build are casts of the current development state, so treat them as Alpha releases

[!CAUTION] Devel builds may be unstable or don't even launch. Use it at your own risk

Changelog

You can see full changelog for all versions here

Translation

You can help project to be internationalized using Hosted Weblate

Translation status

Plans

You can see future plans on Projects page of this repo on Chronograph roadmap.

If you have an idea or you know a bug, please, open an issue with you idea/bug and it will be added to roadmap.

If you want the app to support more file formats, create a feature request about that and attach a sample file.

Code of Conduct

The project follows the GNOME Code of Conduct

Contributing

All contribution instructions are described in CONTRIBUTING.md file.

Screenshots

<div align="center">

</div>