Skip to content

Latest commit

 

History

146 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Fretz

Fretz is a native iPhone and iPad songbook for guitar and ukulele players. It keeps chord sheets and tablature together in a searchable library designed for practice and performance.

Features

  • Read chord-over-lyrics sheets and guitar tablature
  • Browse a built-in collection of songs
  • Import ChordPro (.chordpro, .chopro, .cho, .crd) and MusicXML (.musicxml, .mxl) files
  • Paste ChordPro text or import a chord sheet from a URL
  • Transpose songs by semitone or find the simplest playable key
  • View guitar and ukulele chord diagrams
  • Auto-scroll at an adjustable speed and resume where you stopped
  • Create and edit songs, then search and filter your library
  • Customize the app's appearance, tint, and default instrument

Built With

  • Swift and SwiftUI
  • SwiftData for local song storage
  • AVFoundation for chord playback

Requirements

  • iOS or iPadOS 26.0+
  • Xcode 26 with the iOS 26 SDK

Run Locally

Clone the repository:

git clone https://github.com/nlevin/fretz.git
cd fretz

Open the project in Bitrig, or generate an Xcode project from Project.json with XcodeGen:

xcodegen generate --spec Project.json
open Fretz.xcodeproj

Select an iPhone or iPad simulator and run the Fretz target.

Project Structure

  • App/Models — songs, measures, notes, tunings, and app preferences
  • App/Views — the library, readers, chord browser, editor, and settings
  • App/Import — ChordPro, MusicXML, compressed MusicXML, and web importers
  • App/Chords — chord generation and instrument-specific fingering data
  • App/Resources/DefaultSongs — the bundled starter library
  • appStoreConnect — App Store listing metadata

About

Simple iOS app for singing songs with Guitar Chords

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages