Skip to content

olivertransf/Claveo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

77 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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 a piece library, tags, non-destructive trim, playback speed, search, and export/share
  • Practice journal — Minutes, notes, ratings, streaks, and stats; optional links to recordings
  • Metronome — Tap tempo, standard and custom time signatures, accents, saved tempos, optional haptics, reference tone
  • Tuner — Live pitch from the mic; custom A4 and optional Hz readout
  • Exercises — Note reading on the staff, key signatures, interval ear training
  • Chord & scale reference — Diatonic chords and scales by root
  • Music dictionary — Searchable terms and definitions
  • Layout — Reorder tabs (four on the bar, rest in More), accent colors, light/dark mode
  • OMR (beta) — Scan sheet music from photos or PDFs for experimental digitization workflows

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

Watchers

Forks

Packages

 
 
 

Contributors