ProjectsApps
Apps, TypeScript
GuitarRemedy
Learn guitar in the Dark Forest: interactive scales on a live fretboard, full tabs, a free built-in library, song to tab breakdown, and a private Day 1–365 lesson path.
v0.3.1 released
Learn guitar in the Dark Forest.
Interactive scales · full tabs · free library · song → tabs · Day 1–365 private lessons
Quick start · Features · Wiki · Desktop · License
Hi I'm Ahmi, hope this helps!
GuitarRemedy is a local-first guitar school you can actually practice in — not a wall of PDFs. Open a scale on the fretboard, play a free-license song in tab, walk a guided 30‑minute lesson every day for a year, or drop an MP3 and get a candidate tab you can clean up and keep forever.
| Platforms | Windows (Tauri 2) · Web / PWA · Android (Capacitor scaffold) |
| Theme | Dark Forest (mint · lime · void green) |
| Data | On-device progress, favorites, Your tabs |
| Content | Public-domain / traditional / original study only |
Features
| Surface | What you get |
|---|---|
| Practice | Interactive fretboard · scales & modes · degrees · lefty · Tone.js play-along |
| Library | Scales, chords, riffs, 60+ free full-length songs · search & filters · Your tabs |
| Learn | 365 private-lesson days — warm-up → teach → guided → jam → cool-down |
| Upload | Audio → MIDI → tabs · MIDI / MusicXML solid · GP best-effort · editor · export |
| Wiki | In-app guitar & music theory encyclopedia (also under docs/wiki/) |
| About | Ahmi blurb · GitHub · Releases · Patreon · Check for updates (desktop) |
Song → tabs (honest path)
- Solid:
.mid/ MusicXML (Guitar Pro when GPIF parses) → tabs + scale map - Audio: decode → HPSS lead stem → Basic Pitch (Apache-2.0 multipitch assist, free model in
public/models/basic-pitch) or autocorrelation fallback → tempo → MIDI → fretting → auto-clean - Human loop: Edit (pitch ±1, keep first N bars, Clean up) → save to Your tabs →
.grtab.json/ MIDI / ASCII
Accepted audio: MP3, WAV, M4A, OGG/Opus, FLAC, AAC/MP4, WebM, AIFF, CAF, WMA (when the runtime can decode).
Accepted tabs: MIDI, MusicXML/MXL, Guitar Pro (best-effort), .grtab.json.
Full-band mixes race Auto stem (lead / harmonic / mix via HPSS) before pitch — still lead-biased drafts, not multi-voice studio tabs. Clean single-note leads convert best. Always confirm by ear. Guitar Pro placeholders never auto-save; prefer MIDI/MusicXML when you have them.
Third-party licenses: docs/THIRD_PARTY.md (MIT app · Apache-2.0 Basic Pitch · free content only).
Quick start
npm install npm run dev # http://localhost:5173 npm test npm run build
Desktop shell (Windows):
npm run tauri:dev npm run tauri:build
Requires Rust + WebView2.
Wiki
Deep theory and how-to live in two places:
| Place | Path |
|---|---|
| GitHub / offline markdown | docs/wiki/ |
| In the app | Wiki in the nav (searchable) |
Topics include notes & intervals, scales & modes, chords & progressions, rhythm, the fretboard & CAGED, tunings, technique, tab reading, guitar facts, the 365 path, and the upload pipeline.
Project layout
src/
components/ AppShell, Fretboard, TabView, TabEditor, ScalePicker, …
pages/ Home, Learn, Library, Practice, Upload, Profile, About, Wiki
lib/ theory, audioToMidi, midi, musicxml, guitarpro, breakdown, tabEdit, …
data/ library, freeTabs, curriculum 1–365, lessonExpand, wiki
store/ app + userTabs (localStorage)
public/assets/ Dark Forest art (ComfyUI)
docs/wiki/ Full markdown encyclopedia
src-tauri/ Tauri 2 · signed updater
.github/ ci.yml · release.yml
Desktop & updates
- About → Check for updates (desktop) uses the Tauri updater against GitHub Releases +
latest.json - Signing key lives outside the repo (
~/.tauri/guitarremedy.key) — seedocs/AUTOUPDATE.md - Packaging notes:
PACKAGING.md
# when you're ready to publish (not done until you say so) gh repo create AhmiDarrow/GuitarRemedy --private --source=. --remote=origin git push -u origin main gh secret set TAURI_SIGNING_PRIVATE_KEY < %USERPROFILE%\.tauri\guitarremedy.key git tag v0.1.0 && git push origin v0.1.0
Scripts
| Script | Purpose |
|---|---|
npm run dev |
Vite dev server |
npm test |
Typecheck + Vitest |
npm run build |
Production web build |
npm run test:rust |
Tauri crate tests |
npm run tauri:dev / tauri:build |
Desktop shell |
npm run mobile:sync / mobile:android |
Capacitor Android (after cap add) |
Stack
React 19 · TypeScript · Vite 6 · Tailwind 4 · Tone.js · Zustand · Tauri 2 · Vitest
License
MIT © Ahmi Darrow
Built-in songs are public-domain, traditional, or original study material only. User uploads and Your tabs stay on your machine.
Dependencies and the Basic Pitch model are free/open licenses only — see docs/THIRD_PARTY.md.
GitHub · Releases · Patreon
"Hope this helps" - Ahmi
This comes from the project's README. Read it on GitHub

