Skip to content
pmsosaPublic

About

Android app for the guitarlele, ukulele and cuatro: tuner, chord wheel, and turn strummed recordings into melodies and songs.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

13 Commits

Folders and files

Repository files navigation

Fretwise

Fretwise is an Android app for small string instruments: the guitarlele, the ukulele and the Venezuelan cuatro. It tunes them, shows chords, and turns a strummed recording into melodies you can play over it. Then it lets you stitch recordings and melodies together into a whole song.

  • Songs: build a song from sections. Each section is one of your recordings plus one of its melodies, repeated. Reorder, repeat, duplicate or swap sections, then play the song or export it.
  • Record: strum a progression, trim it on a spectrogram, and get melodies over it.
  • Tools: a tuner and a chord wheel.
  • The instrument chip at the top sets the instrument everywhere.

Songs

The Songs tab has two lists: Songs and Library.

  • Library: your saved jams (a recording plus its chords, tempo, key and saved melodies) and your recent takes. Every take you record is kept automatically (the newest 12), so a recording can't be lost by mistake. Tap one to open it on the Record tab, hold to rename, ✕ to delete.
  • A song is a timeline of sections, left to right. Tap a section to move it earlier or later, copy it, remove it, repeat it ×1 to ×4, or change its melody. Add a section by picking a recording from the library, then one of its saved melodies (or none, for the recording on its own). Play song mixes everything in order, and Export writes a WAV to Downloads/Fretwise.
  • Sections can come from different recordings, so a verse, a chorus and a bridge can each be their own take.
  • Opening a song switches to the instrument it was made on.

Record

Strum a chord progression with some rhythm, and Fretwise suggests melodies to play over it.

  1. Record. Tap REC, get a 3-2-1 countdown, then strum (up to 90 seconds). Restart is always on screen: it starts a fresh 3-2-1.
  2. Trim. Your take is drawn as a spectrogram. Drag the two handles to pick where it starts and ends (the silence at either end is skipped for you). When you let go of a handle it plays just the 3 seconds around that cut: from the start handle forward, or up to the end handle. No need to sit through the whole song.
  3. Find melodies. The app works out the tempo, the chords and the key. If it heard a chord wrong, tap the chord to fix it.
  4. Shape the melody. Everything replays straight away when you change it:
    • Style: Singable, Bluesy or Bouncy.
    • Loops (×1, ×2, ×4, ×8): the melody spans that many passes of your recording, with the recording looping underneath, so a short progression becomes a longer piece.
    • Complexity: Very simple to Wild: how many notes per bar, how big the leaps are, how much it repeats.
    • Tension: Easy listening to Far out: how far it strays from what sounds settled. Easy stays on chord tones and resolves (country, rock). Jazzy adds 7ths and 9ths, chromatic notes leaning into the chord tones, and phrase endings left hanging.
    • Sound: Pluck, Piano, Marimba, Bell, Synth, Pad or Flute.
    • New melody tries again with the same settings. Tap a note in the piano roll to see which string and fret plays it on your instrument.
  5. Keep what you like. Save melody keeps the recording and the melody together (the melody is stored as notes and played from them, with the settings you used). Your saved melodies for the jam are listed below the buttons: ▶ plays one, ✕ deletes it.
  6. Export. Save to Downloads/Fretwise as a WAV (recording plus melody, or the melody on its own) or as a MIDI file with the chords as markers.

It all runs on the phone. Chords are found by matching the notes you play against major and minor chords, the tempo from where the strums land, and the key from the chords. Major and minor chords only, and it works best with a clear, steady strum.

Tools

  • Tuner: listens through the mic, finds which string you played and shows how many cents sharp or flat it is. The gauge glows green when you're in tune (within 5 cents). Auto-detects the string, or tap one to lock on.
  • Chords: start on any chord, see where it usually goes next, hear each chord and see the fingering. Guitarlele chords use the usual guitar shapes; ukulele and cuatro shapes are worked out from the strings' tuning.
  • Capo 0–7 on any instrument; each instrument remembers its own tuning and capo.
Instrument Tunings
Guitarlele A guitar tuning plus a capo. Standard, Drop D, Half step down, DADGAD, Open G. Capo 3 is the default (G C F Bb D G); capo 5 gives A D G C E A; capo 6 gives Bb Eb Ab Db F Bb
Ukulele Standard GCEA, Low G, Baritone DGBE, D tuning (ADF#B)
Cuatro venezolano A D F# B: strings 1 to 4 are A3 D4 F#4 B3, so by pitch it climbs A3 B3 D4 F#4

A guitarlele is a guitar tuned up with a capo, so it works as one: pick the guitar tuning, then the fret.

See it

Real screenshots from the app running on a phone.

Songs tab with a list of songs
Songs

Your songs in one place

Each song is a row of sections built from your recordings and melodies.
Song editor with a timeline block, section controls and play, add and export buttons
Song editor

Build a song from sections

Pick a recording and a melody for each section, repeat it, reorder it, play the whole thing.
Library tab with a recent take kept automatically
Library

Nothing gets lost

Saved recordings and melodies live in the library. Every new take is kept automatically for a while.
Record tab with the big REC button
Record

Record a strum

Strum a progression and get melodies to play over it.
Tuner for a Venezuelan cuatro
Tools · Tuner

Tune by ear

Ukulele, guitarlele (a guitar with a capo) and Venezuelan cuatro, with capo and alternate tunings.
Chord wheel with the chord box
Tools · Chords

Find the next chord

A chord wheel that plays each chord and shows how to finger it.

Build

Everything builds inside the android-build:35 Docker image; nothing is installed on the host.

docker run --rm -v "$PWD:/workspace" -w /workspace -v android-gradle:/root/.gradle \
  android-build:35 ./gradlew assembleRelease

The APK lands in app/build/outputs/apk/release/app-release.apk. Requires Android 11 (API 30) or newer.

Signing

Builds are signed with a fixed key from signing/guitarlele.jks, configured by signing/keystore.properties. The folder is not in git, so keep it safe: a different key means an update won't install over the old app. Without it the build falls back to Android's default debug signing.

The app was first called Guitarlele Tuner, so the package is still app.guitarlele.tuner. Changing it would make Android treat the app as a new one and lose the saved settings.

How it works

  • MainActivity is the shell: a top bar with the instrument chip, a bottom bar (Songs, Record, Tools) and the tuner. Instrument and Tuning hold the instruments and their tunings (add one there to support another)
  • Songs: ProjectsPanel (song and library lists), SongPanel and TimelineView (the editor), ProjectStore and JamStore (saved on the phone as JSON and WAV), SongRenderer (mixes the sections)
  • Record: JamPanel runs the flow; Recorder, SpectrogramView, ChordAnalyzer, MelodyGenerator and JamMixer do the work; Wav, MidiWriter and Exporter handle export
  • Tools: PitchEngine finds the pitch with the YIN algorithm; TunerView and StringsView draw the gauge; Chord, ChordWheelView and ChordDiagramView draw the wheel; ToneSynth plays the chords
  • Plain Java and the Android framework, no third-party libraries

About

Android app for the guitarlele, ukulele and cuatro: tuner, chord wheel, and turn strummed recordings into melodies and songs.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages