liltype_
← Back to Documentation

Getting Started

1) Download and install

Download the latest DMG from liltype.com. Open the DMG and drag liltype to your Applications folder.

liltype runs as a menu bar app — look for it in your menu bar after launching, not in the Dock.

Approving liltype in macOS Security Settings

liltype is not yet signed with an Apple Developer certificate. macOS will block the app on first launch — this is expected. To allow it:

  1. Try to open liltype — macOS will show a warning dialog:

    liltype Not Opened — Apple could not verify liltype

  2. Open System Settings → Privacy & Security

  3. Scroll down to the Security section

  4. You will see a message about liltype being blocked — click Open Anyway:

    liltype was blocked — click Open Anyway

  5. Confirm in the follow-up dialog

You may need to repeat this after updating to a new version.

2) First-launch permission setup wizard

On first launch, complete the permission wizard:

  1. Microphone Access (required — dictation will not work without this)
  2. Accessibility (optional; required for app context capture + auto-paste)
  3. Screen Recording / System Audio (optional; required for meeting capture and system audio recording)
  4. Notifications (optional; used for meeting prompts and focus-loss fallback)

If a permission is denied, reopen macOS System Settings from the in-app action buttons and retry.

3) Download your first offline model

Go to Settings → Model and download at least one model.

You cannot run offline dictation until one model is downloaded.

Choosing a model (trade-offs)

  • Smaller model: faster, less accurate
  • Larger model: slower, more accurate
  • Start with a mid-size model, then tune based on your latency tolerance.

4) Verify microphone input

Go to Settings → System:

  • choose your input device
  • check level meter activity while speaking
  • optionally enable fast Bluetooth mic start if you use wireless mics

5) Configure your hotkey

Go to Settings → General.

  • Default hotkey: Ctrl+Shift+Space
  • Dictation modes:
    • Push to Hold (press-and-hold)
    • Toggle (press once to start, once to stop)
  • If you pick a conflicting hotkey, liltype warns you (for common conflicts like Spotlight/input source shortcuts).

6) First dictation (end-to-end)

  1. Focus any text field (Notes, Chat, editor, etc.)
  2. Trigger hotkey
  3. Speak
  4. Stop recording (release hotkey in Push to Hold mode, or press again in Toggle mode)
  5. liltype transcribes (offline by default)
  6. Result is copied to clipboard
  7. If auto-paste is enabled and Accessibility is granted, liltype inserts text into the focused app

If the focused app loses focus before transcription completes, liltype sends a notification with the result instead.

Press Escape any time during recording to cancel and discard.

7) Optional cloud mode setup (BYO keys)

Go to Settings → Model and select provider + key.

Cloud mode requires:

  • provider API key saved in Keychain
  • successful connection test
  • cloud toggles enabled (where applicable)
  • Plus or Pro subscription (cloud STT and rewrite are paid features)

For provider-specific setup, see API Keys (BYO Providers).

8) Optional meeting capture setup

Go to Settings → Meeting:

  1. Grant screen recording/system audio permission if not already done
  2. Configure detection behavior (ask / auto-start / notify only)
  3. Choose which apps to monitor (Zoom, Teams, FaceTime, WebEx, Discord, Slack)
  4. Configure mic and system audio inclusion

When a monitored app is detected, liltype will prompt or automatically start a meeting session.