Capture Mode

Capture mode records your navigation session and automatically generates a conalyz.yaml file. It is the fastest way to get started — navigate your app once and you have a working config ready for automated analysis.

Android only

Capture mode requires an Android device or emulator. The generated conalyz.yaml works on both Android and iOS when you run --auto.

Running

conalyz capture

Workflow

1. Run conalyz capture — Conalyz starts your app and connects automatically.
2. Navigate your app exactly as a user would: tap buttons, fill in forms, swipe between pages, press back.
3. Press Ctrl+C when you have covered all the screens you want to audit.
4. Conalyz shows a review of everything it recorded, then writes conalyz.yaml.
5. Open conalyz.yaml, fill in any <text> placeholders, and run conalyz auto.

  ──────────────────────────────────────────
  Recording — navigate your app normally.
  Press Ctrl+C when done.
  ──────────────────────────────────────────

  Screen: "Login"
  → Screen: "Home"
  → Screen: "Settings"
^C

─────────────────────────────────────────
  Captured 3 screens  ·  8 steps

  Login
    - analyse
    - type "user@example.com" into "Email"
    - type "<text>" into "Password"    ⚠️  password
    - tap "Sign in"

  Home
    - analyse
    - tap "Settings"

  Settings
    - analyse

  1 placeholder needs attention — marked ⚠️
─────────────────────────────────────────

  Written → conalyz.yaml
  Run: conalyz auto

What gets captured automatically

User action	Captured as
Tap on a button or link	tap "Label"
Type into a text field	type "text" into "FieldLabel"
Press back	back
Horizontal swipe	swipe left or swipe right
Navigate to a new screen	new screen: entry with analyse

Password fields

Password fields always produce a <text> placeholder — the actual text is never captured. After the session, open conalyz.yaml and replace <text> with your test credentials.

- type "<text>" into "Password"    # ⚠️  password — replace with test credentials

After capture

Open the generated conalyz.yaml and:

1. Replace every <text> placeholder with real values.
2. Check the ⚠️ markers — labels marked uncertain may need verification.
3. Add wait_for steps on any screen that loads data from the network (replaces a fixed delay).
4. Run with --auto to perform the full accessibility audit.

conalyz auto

Android capture, iOS replay

Capture mode records on Android. The generated conalyz.yaml is platform-agnostic — run it with --auto on iOS to get iOS coverage from the same config without any extra recording work.