metronome/README.md
Me Here 5ab2096fc4 PolyMeter — slim main: landing chooser + mobile app + notation editor
Clean, dependency-light front page. Only three things ship here:
- index.html  — two-button landing: Mobile -> mobile.html, Desktop -> pm_e-2.html
- mobile.html — touch-first PWA (+ mobile-sessions.html practice journal)
- pm_e-2.html — engraved-notation editor

build.sh/deploy.sh trimmed to just these; deploy mirrors dist/ to the web root
with rsync --delete. README/CLAUDE.md rewritten for the slim scope.

The full project (PM_E-1 editor, embeddable widget, all hardware form-factor
pages, Pico firmware editions, the Rust port, and the KiCad/SPICE hardware
design) is preserved on the `concepts` branch.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-08 11:44:45 -05:00

43 lines
1.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# VARASYS PolyMeter
A **polymetric groove trainer & metronome**. Stack as many "meter lanes" as you like —
each its own little metronome with a grouping, subdivision, drum voice and a perstep
pattern with accents. Layering lanes produces polymeter and true ratio polyrhythm.
**Live:** https://metronome.varasys.io · **Source:** https://codeberg.org/VARASYS/metronome
## What ships here
The landing page (`/`) is a simple chooser with two doors:
- **Mobile** → `mobile.html` — the touchfirst phone/tablet app (tap a beat, set the tempo,
practice). It's an installable **PWA** that works fully offline, with a practice journal
(`mobile-sessions.html`).
- **Desktop** → `pm_e-2.html` — the engravednotation editor: build rhythms on a staff with
full keyboard control. Best on a large screen.
Every **deployed page is a single, selfcontained `.html` file** with **zero runtime
dependencies** — no framework, no CDN, nothing fetched at runtime. `build.sh` inlines a shared
engine, the seed set lists, base styling and the brand assets (`assets/`) into each page. Every
voice is **synthesized** in Web Audio (no audio samples). State (set lists, the practice log,
theme) lives in `localStorage`; share links encode everything in the URL hash — nothing is
uploaded.
## Build & deploy
```sh
./build.sh # assemble the self-contained pages into dist/ (git-ignored)
./deploy.sh # build, stamp version, mirror dist/ to the Caddy web root, smoke-test
```
## The `concepts` branch
This `main` branch is intentionally lean. The **full project** — the PM_E1 editor, the
embeddable widget, the whole gallery of hardware **formfactor concepts**, the Raspberry Pi
Pico **firmware** editions, the **Rust** port, and the **KiCad/SPICE hardware** design — lives
on the [`concepts`](https://codeberg.org/VARASYS/metronome/src/branch/concepts) branch. It can
be promoted back to the front page at any time.
## License
[GNU AGPL v3](./LICENSE) © VARASYS.