ArcGlyph User Guide
Version 1.0 – Last updated June 11 2025
Welcome to ArcGlyph! This guide takes you from your very first circle to advanced workflows linking multiple spells together. Every interaction in ArcGlyph is performed with a single, quick poke (touching with index finger). There are no double‑clicks or long‑presses in the app.
Table of Contents
- Getting Started
- Summoning Your First Circle
- The Main Circle & Its Buttons
- Color Customization
- Labelling Circles
- Moving & Minimizing Circles
- Spells Overview
- Linking Circles
- Applying Delays
- Spell Reference
- Sample Workflows
- Tips & Troubleshooting
- Glossary
Getting Started
- Launch ArcGlyph. You’ll see a splash screen with the ArcGlyph logo.
- Grant Passthrough permission (first run only). Accepting lets ArcGlyph overlay circles in your real space.
- Once permission is granted you’ll see your room—ArcGlyph waits quietly until you create your first circle.
Summoning Your First Circle
- Raise your left hand with the palm facing you.
- Pinch (touch thumb to index finger) quickly.
- A new circle appears at your fingertip. Its edge shows the label “New Spell” and six buttons surround it.
Reminder: A quick poke is a click. That same gesture is used to press every button in the interface.
Color Customization
Selecting Color opens a larger circle with:
- Centre – Back.
- Inside rim – 5 Saturation steps on the left (100 % → 0 %).
- Inside rim – 5 Value steps on the right (100 % → 0 %).
- Outer ring – 12 Hue buttons: Red · Orange · Yellow · Chartreuse Green · Green · Spring Green · Cyan · Azure · Blue · Violet · Magenta · Rose.
The chosen colour tints the circle edge, its text, and any link lines that originate here.
Labelling Circles
Press Label to open the circular keyboard.
Keyboard Anatomy
- Back – returns to the main circle.
- Caps Lock, Symbol 1, Symbol 2 – toggle between lowercase, uppercase, and symbol sets.
- Delete – removes the last character.
- Space – inserts a space.
- Letter layout follows the frequency‑ordered sequence
etaoin shrdlu
(vowels and common consonants first for fast typing).
Type a new name; it instantly replaces the “New Spell” placeholder.
Moving & Minimizing Circles
Move Mode
- Choose Move.
- Pinch on the blank centre (or make a fist) and drag anywhere in your room.
- Press Back to lock its new position.
Minimize
- Press Minimize to collapse to a single labelled dot.
- Click that dot to expand back to the full circle.
Pro tip: Minimize counters you want visible but rarely adjusted.
Spells Overview
Inside Spell you’ll see:
- Back – returns to the main circle.
- Remove Spell – clears any spell but keeps links & delay settings.
- Link – connects this circle to others (see Linking Circles).
- Measure – toggles length read-outs on links. Pick one unit (cm · m · mm · km · in · ft · yd · mi).
- Delay – lets the circle (or its outbound signals) wait before acting.
- Ten Spells you can add:
- Counter
- Delayed Counter
- Alarm Counter
- Stopwatch
- Pomodoro
- Information
- Bell
- Recorder
- Toggle
- Hide
Choose one spell per circle. The circle’s centre will transform into the appropriate spell button or readout.
Linking Circles
- Open Spell → Link.
- Press Start Link (button brightens).
- On the target circle open Link and press Accept Link. A coloured line appears between them.
- Toggle Send to have this circle transmit its clicks; toggle Receive for it to react to incoming signals.
- Delete Links removes all existing links from this circle.
A gradient line fades from the colour of the sender to the receiver, making networks easy to trace.
Measurement: When Measure is enabled, every link displays its real-world length beside the line, using the unit you selected.
Applying Delays
Open Spell → Delay.
- Centre – Back and Delete (clear last digit).
- Middle ring – pick the unit: Seconds · Minutes · Hours · Days.
- Outer ring – digits 0‑9. Pinch digits in order to build the number (e.g. 0 → 0 → 5 gives “005”).
Delays affect:
- The circle’s own centre button (it won’t react until the countdown reaches 0).
- Outbound signals: a linked circle receives the click only after the delay expires.
Spell Reference
1. Counter
- Use: Tap to increment the number.
- Links: With Send toggled, a tap here triggers linked circles.
2. Delayed Counter
- Setup: Choose a delay (seconds/minutes/hours/days) then press Start.
- Behaviour: Counts down, sounds an alarm, then switches to counting up on each tap (and restarts the countdown).
3. Alarm Counter
Setup wizard:
- Hours (0‑12)
- Minutes (0‑59)
- AM / PM
- Active Weekdays (toggle any of the seven).
- Press Start.
Behaviour: At scheduled times it rings until tapped; each tap also adds 1 to the count.
4. Stopwatch
- First tap starts counting up.
- Second tap stops.
5. Pomodoro
- Delay A – work session length.
- Delay B – break length.
- After you set both delays, the centre shows State 1 (work) counting down.
- When it reaches 0 it rings, then flips to State 2 (break) automatically.
- Rinse and repeat for continuous Pomodoro cycles.
6. Information Spells
Icon | What it shows |
---|---|
Clock | Current time |
Date | Current date |
Battery | Headset battery % |
Online | Internet status (online / offline) |
Signal | Wi‑Fi strength bars |
Moon | Current moon phase |
These update automatically; they do not react to taps unless linked.
7. Bell
- Tap to start ringing.
- Tap again to silence.
- Handy as a manual alert or synced chime when linked.
8. Recorder
- Record: First press starts recording; press again to save the clip.
- Start: Spawns the spell. A ▶ button appears in the centre.
- Play: Tap the centre button to replay your saved audio.
- Stop: Halts any current recording or playback.
- Delete: Permanently removes the recording from storage.
9. Toggle
- Use: Tap to switch between On (bright) and Off (dim).
- Links: Always sends a signal on tap, regardless of state.
- Tip: Pair with two Hide circles to flip between constellations.
10. Hide
- Use: Tap to hide all target circles (they become invisible & untouchable).
- Propagation: If a target is itself a Hide circle, its entire hide-tree is also hidden.
- Un-hide: Tap any hidden circle (or its parent Hide spell) again to reveal.
- Links: Ignores Send/Receive flags of targets; hide action happens instantly.
Sample Workflows
- Chained Timer Board: Link a Delayed Counter (5 min) → Bell → Counter. When the timer ends it rings the bell and increments your tally.
- Morning Routine: Use three Alarm Counters (wake‑up, coffee, stretch) set to different times and colours. Link them to play in sequence or all at once.
- Focus Sessions: Create a Pomodoro circle, then link its Send to a Bell so you get an audible cue for work-and-break transitions.
Tips & Troubleshooting
- Lighting: Hand-tracking works best in even, bright rooms.
- Stay in view: Keep your hands inside the Quest 3 cameras’ field.
- Accidental pinches: If circles appear unintentionally, use Close → Close to remove them.
- Battery check: Add a Battery information spell to watch headset charge.
- Colour coding: Reserve hues for categories (e.g. red = timers, blue = info).
Glossary
Term | Meaning |
---|---|
Circle | The primary UI element containing buttons or readouts. |
Click | A quick index poke. |
Spell | A functional module (counter, timer, info widget, etc.). |
Link | A connection that lets one circle trigger another. |
Delay | A timed pause before a circle—or its signal—activates. |
Minimize | Collapse a circle to a label-only dot. |
Measure | Circle attribute that shows the physical length of each link in a chosen unit. |