Chord Provider

A ChordPro file parser and editor in SwiftUI 4

There are many "ChordPro" parsers in this world, however, none are really native in the Apple world.

I mean, in the macOS world, it is often an afterthought... Not for me. I'm mainly a mac user; the iPad version is my afterthought...

Written in SwiftUI 4, so macOS Ventura or iPadOS 16 only.

The branch 'SwiftUI-3' has an older version for macOS Monterey or iOS 15, however, I don't update that version anymore.

General

• It wil view and/or edit 'ChordPro' files.
• It recognise most of the 'ChordPro' directives, but not all.
• It can transpose a song; however, only in the View. The document will not be changed and that's on purpose.
• You can 'define' a Capo but that will not change any notes; again on purpose.
• You can click on a chord diagram and it will open s Sheet with all known versions.

macOS

• It has a 'browser' for your songs if you select a folder.
• It has a 'highlighted TextEditor'.'
• It can export your song to a PDF document.
• It can play chords with MIDI on the 'Chord Sheet'
• It has a 'quick view' plugin for 'ChordPro' files.

Limitations

Well, Chord Provider a simple application. There are a lot better 'chord' applications and I wrote this just for fun. It serves me well but I know it's not that great. It might serve you well, as a 'chord' program or as a sample for a 'document based SwiftUI' application. SwiftUI is fun and great, however, also limited and challenging; especially on macOS. There are many 'workarounds' in the code; especially for 'window handling'.

Not all chords in the database are correct; especially the more complicated chords. I wrote Chords Database for macOS Ventura to view and alter the database with all known chords.

iCloud

The iOS app will make an iCloud folder named "Chord Provider"; that's where your songs should be stored. In the macOS app, you can select a folder with your songs. If you use the same iCloud folder; updates are instantly.

Known issues

• When you switch from light to dark mode and visa-versa; the chord diagrams are not updated.
• SwiftUI 'DocumentGroup', used to show the songs, is very buggy and limited.
• 'Pinch to zoom' is buggy on macOS. Sometimes it just stops working. There is a 'zoon' toggle in the toolbar.
• The 'Browser' for macOS is not too smart; it does not update when you add or delete files in the Finder while Chord Provider is open.
• The 'song' is rendered in a SwiftUI View, so, a bit sluggish... But fancy!

Thanks

Stole code (and ideas) from:

• SongPro for Swift
• Conscriptor

Used packages

The chord diagrams are made with Swifty Guitar Chords. The macOS editor is HighlightedTextEditor

I use my SwiftlyChordUtilities package for chord handling.

How to compile

1. Clone the project.
2. Change the signing certificate to your own.
3. Build and run!