First commit

2026-08-11 10:52:35 +02:00
commit a1d46f5e32
7 changed files with 802 additions and 0 deletions
@@ -0,0 +1,67 @@
+# Backgammon Clock
+
+A two-player match clock with **simple delay you can actually see**. Reserve time
+plus a fixed number of free seconds each turn that never carry over — the
+Backgammon Galaxy control. Defaults to 3:00 + 15s.
+
+Plain HTML, CSS and JavaScript. No frameworks, no fonts, no images, no network.
+
+## Getting it onto your phone
+
+Chrome will only offer a real install over HTTPS, so the file needs a host.
+GitHub Pages is free and takes about two minutes:
+
+1. Create a new public repository, e.g. `bgclock`.
+2. Upload all six files to the root: `index.html`, `manifest.webmanifest`,
+   `sw.js`, `icon-192.png`, `icon-512.png`, `icon-maskable-512.png`.
+3. **Settings → Pages → Source: Deploy from a branch → `main` / `(root)` → Save.**
+4. Wait a minute, then open `https://<you>.github.io/bgclock/` in Chrome on Android.
+5. Chrome menu (⋮) → **Add to Home screen** → **Install**.
+
+Open it from the home-screen icon and it runs fullscreen with no browser
+chrome, offline, with the screen kept awake while a game is on.
+
+If you're using a different path than `/bgclock/`, edit the `"id"` field in
+`manifest.webmanifest` to match, or just delete that line.
+
+To try it before hosting, open `index.html` in any browser — everything works
+except installation and the service worker.
+
+## Using it
+
+- **Tap your own half** to end your turn and start your opponent's clock.
+  At the start, whoever taps first sets the *other* player going.
+- The waiting player's taps are ignored, so a stray hand won't stop the clock.
+- The bar under the big time is the delay draining. When it empties you get a
+  soft tick and your reserve starts moving. That's the moment worth hearing.
+- **Reset** returns to the starting position. **Pause** freezes mid-turn and
+  resumes exactly where it stopped, delay included.
+
+Backgammon clocks pause between games, and after a cocked die the delay is
+normally restarted — use pause and reset for those.
+
+## Settings
+
+| Setting | Range | Default |
+| --- | --- | --- |
+| Time | 0:15 – 99:00 | 3:00 |
+| Delay | 0 – 60 s | 15 s |
+| Colour | Sage, Brass, Slate, Teal, Plum | Sage |
+| Sound | on / off | on |
+
+Brass is the colour in the chess.com app, if you want the exact original look.
+Changing time or delay resets the clock. Settings are remembered on the device.
+
+## Sounds
+
+All three are generated with the Web Audio API, so there are no audio files to
+download and nothing to attribute.
+
+- **Turn change** — a soft rising fifth with an octave partial, marimba-like.
+- **Delay expiry** — a single quiet 300 Hz tick, deliberately easy to miss unless
+  you're listening for it.
+- **Time out** — a falling triad, loud and unambiguous.
+
+## Licence
+
+Do whatever you like with it.