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.
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.
Strum a chord progression with some rhythm, and Fretwise suggests melodies to play over it.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
Real screenshots from the app running on a phone.
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.
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.
MainActivityis the shell: a top bar with the instrument chip, a bottom bar (Songs, Record, Tools) and the tuner.InstrumentandTuninghold the instruments and their tunings (add one there to support another)- Songs:
ProjectsPanel(song and library lists),SongPanelandTimelineView(the editor),ProjectStoreandJamStore(saved on the phone as JSON and WAV),SongRenderer(mixes the sections) - Record:
JamPanelruns the flow;Recorder,SpectrogramView,ChordAnalyzer,MelodyGeneratorandJamMixerdo the work;Wav,MidiWriterandExporterhandle export - Tools:
PitchEnginefinds the pitch with the YIN algorithm;TunerViewandStringsViewdraw the gauge;Chord,ChordWheelViewandChordDiagramViewdraw the wheel;ToneSynthplays the chords - Plain Java and the Android framework, no third-party libraries






