Skip to content

Desbeers/Chord-Provider

Repository files navigation

Chord Provider

A ChordPro viewer and editor for Linux

Icon

ChordPro

ChordPro is an open standard text format for songs with chords and lyrics.

It also has an official reference implementation.

Chord Provider is my hobby project, written mainly for my own needs as a musician and programmer.

Chord Provider

Chord Provider is written in Swift and uses Adwaita for Swift for the GUI.

Chord Provider

There are many ChordPro parsers and editors available, but very few feel truly native on Linux desktops. That is what I wanted to build.

The application started as a macOS SwiftUI project, but was later rewritten for Linux with a native GNOME interface.

Features

  • View and edit ChordPro files
  • Native Linux GUI with GNOME / libadwaita
  • Built-in chord database
  • MIDI playback for chords, grids and tabs
  • Basic metronome
  • Left-handed chord support

The icon

Of course it is based on a Telecaster.

In 2016 I fell in love with an Olympic White Telecaster. The icon shape and colors are inspired by that guitar.

Building

The recommended way to build Chord Provider is as a Flatpak application.

Clone the repository and build it with GNOME Builder.

macOS

The project originally started as a native macOS SwiftUI application.

The old macOS source code is still available in the repository, but it is no longer maintained and does not compile anymore.

The Linux version is now the primary project.

Limitations

Not all chords in the database are correct, especially some of the more advanced chords. Contributions are welcome.

This is also not a complete implementation of the full ChordPro standard.

If you need full compatibility, the official ChordPro implementation may suit you better.

I also contributed code to the official ChordPro Open Source project.

Thanks

Dependencies

Swift resources

I learned a lot from Swift blogs and mailing lists, especially:

Hopefully somebody can learn something from this project as well.

A note about Swift

I originally started learning Swift for macOS development and stayed with the language because I genuinely enjoy using it.

I moved away from Apple platforms, but kept using Swift. The language itself was never really the problem.

And yes, my very first Swift course used Taylor Swift songs in many code examples, so that is how I accidentally learned about Taylor Swift and became a real Swifty :-D

About

A ChordPro file parser and editor for Linux. Show the song with the chords for guitar, guitalele or ukulele.

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages