Skip to content

olivertransf/Claveo

Repository files navigation

Claveo

A free music practice companion for iPhone and iPad: record sessions, run a metronome and tuner, journal practice time, and use theory tools—all in one app. No ads; optional iCloud sync across your devices.

App Store

Features

  • Recording — Practice takes with live waveform, piece library, tags, non-destructive trim, variable playback speed (0.5x–2x), search/filter, bulk export, and share
  • Live Activity — Dynamic Island and lock screen status while recording
  • Practice journal — Minutes, notes, 1–5 star ratings, streaks, week calendar, stats; link entries to recordings; daily reminder notifications
  • Metronome — Tap tempo, standard and custom time signatures, per-beat accents, saved tempos, haptics, reference tone generator
  • Tuner — Live mic pitch detection; cents deviation display; custom A4 reference (400–480 Hz)
  • Exercises — Note reading on the staff (treble/bass/alto/tenor), key signature ID, interval ear training
  • Chord & scale reference — Diatonic chords and scales by root; major and relative minor
  • Music dictionary — Searchable terms with SMuFL notation symbols, browsable by category
  • Layout — Reorder eight tabs (four on bar + More on iPhone), accent colors, light/dark mode
  • OMR (beta) — Scan sheet music from photos or PDFs with CoreML object detection
  • Sync — Optional iCloud Drive sync across iPhone and iPad, or device-only storage

Roadmap and web copy live in the repo; see the site roadmap for planned work.

Repository layout

Claveo/
├── Claveo/                 # iOS app (Swift / SwiftUI)
│   ├── Models/
│   ├── Services/
│   └── Views/
├── web/                    # Marketing site (Svelte + Vite)
│   ├── src/
│   │   ├── pages/          # Home, About, Roadmap, Privacy
│   │   └── assets/         # Bundled App Store screenshots (carousel)
│   ├── public/             # Static assets (icon, screenshots, etc.)
│   └── package.json
├── Claveo.xcodeproj
├── netlify.toml            # Build: cd web && npm install && npm run build → web/dist
└── LICENSE

Requirements

  • iOS app: Xcode 16+ recommended, deployment target iOS 17.6
  • Website: Node.js 18+ (for local dev and Netlify builds)

Development

iOS

Open Claveo.xcodeproj in Xcode, select an iPhone or iPad simulator (or device), and run.

Website

cd web
npm install
npm run dev     # http://localhost:5173
npm run build   # output: web/dist/

Production deploys use the root netlify.toml (publish web/dist, SPA fallback to index.html).

Tech stack

Area Stack
App Swift, SwiftUI, AVFoundation, CoreML (OMR)
Packages (SPM) Tuna (pitch detection), VexFoundation (staff rendering in exercises)
Site Svelte, Vite

License

Copyright (c) 2025 Oliver Tran. See LICENSE.

Contact

claveo.app@gmail.com — questions, feedback, or licensing.

Links

About

Everything you need to practice smarter. Record sessions, keep perfect tempo, tune instruments, and learn music theory—synced across devices.

Topics

Resources

License

Stars

1 star

Watchers

1 watching

Forks

Packages

 
 
 

Contributors