LarpLess

The LarpLess Guide

LarpLess tells you how much of your study time was really study. It watches the window in front and, if you allow it, your webcam. An AI model on your computer judges what it sees, and LarpLess turns the session into a focus score split across subjects, breaks and distractions. This guide covers every part of the app. On Windows, read Ctrl where it says ⌘ and Alt where it says ⌥.

You can come back here any time from Settings → About → Guide, from the command palette (⌘K → Open guide), or on a Mac from Help → LarpLess Guide.

Contents

Set up

The first time you open LarpLess, onboarding walks you through four short steps. You can run it again later from Settings → About → Onboarding → Run again.

  1. How powerful is this Mac or PC? LarpLess reads your screen with one of two AI models, and both run entirely on your computer. It recommends one based on your chip, memory and graphics card.

    • On-device classifier: a small model built into LarpLess. A check takes under a second on any computer and needs no other app. It's a one-time download of about 460 MB. Screens it isn't sure about count as unknown.
    • Vision LLM (Ollama): a vision language model that runs in Ollama, a free app. It's sharper, but it wants a recent Mac with 16 GB of memory, or a PC with a graphics card. The model is a 1.9 GB download.

    You can switch any time in Settings → Local AI → Screen check.

  2. Your subjects. There's nothing to pick: LarpLess already recognises dozens of subjects. You can add your own courses here or later (see Add your own courses), or choose Skip for now.

  3. Permissions.

    • Screen Recording (Mac only) lets LarpLess read the window in front. macOS applies it only after LarpLess relaunches, so use Relaunch.
    • Camera is optional. It notices when you step away or pick up your phone.
    • Notifications lets LarpLess nudge you when you drift off.
  4. Download the model. In the on-device classifier mode, download the classifier. In the Ollama mode, install Ollama (Download Ollama), then download the model. You can choose Finish anyway and download later from Settings; demo mode works without any model.

Run a study session

  1. On Home, pick a Pomodoro preset if you want one (Off, 25/5, 50/10 or Custom), then press Start session. You can also press ⌘Return or use ⌘K → Start session.
  2. Study. LarpLess checks the window in front every second without taking a screenshot. When a new window has stayed in front for a moment, it checks what's on it. Every 10 to 30 seconds it records one label for that stretch of time (see How LarpLess labels your time).
  3. The Session page shows the running timer, what you're doing now ("Studying Biology", "Distracted · YouTube", "Away"), the last check and a live breakdown. You can Pause, Resume or End session (⌘.) here or from the floating timer.

Some other things to know about sessions:

The floating timer

While a session runs, a small timer floats above your other windows. Its colour shows where you are: green while you study, red when you're distracted, blue on a break and grey while paused or away.

Pomodoro, breaks and sounds

Pomodoro presets

Preset Study Break Long break
25/5 25 min 5 min 15 min after every 4th round
50/10 50 min 10 min none
Custom 1–180 min 1–60 min none

Distraction alerts

When you drift off, the floating timer turns red right away. If you stay distracted, LarpLess nudges you:

Time away from your desk, and checks LarpLess wasn't sure about, neither trigger nor reset an alert. Turn the chimes off in Settings → Sound → Chimes & alerts.

How LarpLess labels your time

Each stretch of a session gets one of four labels:

Your focus score is study time ÷ (study time + distracted time). Away and unknown time don't count either way, so stepping out to get water doesn't hurt your score.

How often a label is recorded depends on Settings → Focus → Power:

Power One label every Good for
Eco 30 s Older or slower computers
Medium (default) 15 s Most computers
High 10 s Fast computers

If checks run slow, LarpLess steps down to a lighter level for the rest of that session on its own. Your setting stays as it is.

Many apps and sites are labelled without a screenshot. For example, Instagram, TikTok, Netflix and Steam are always distractions, and tools like Vivado or Logisim are always study. LarpLess also reuses a recent answer for the same window.

After a session: summary and history

Subjects

The Subjects page (Modules in the sidebar) lists everything LarpLess recognises: sciences, maths, computing, engineering, humanities, social sciences and business, health and medicine, and arts and design. You don't have to set anything up. LarpLess labels your time with whichever subject you study.

Add your own courses

The built-in subjects are broad. If you want a label for a specific course, like Cell Biology or Algorithms, add it as your own course with keywords that point to it.

Your own courses (optional)
NameColourKeywords
Cell BiologygreenBIO101, mitosis, Krebs cycle, organelle
AlgorithmsblueCS210, Dijkstra, dynamic programming, Big-O
Data StructurespurpleCS220, linked list, hash table, heap
+ New
A mock-up of Subjects → Your own courses with example courses. Each course has keywords the others don't.

How to add one

  1. Open Subjects (Modules in the sidebar, or ⌘K → Go to Modules).
  2. Under Your own courses (optional), click + New.
  3. Type a Name. Built-in subject names are taken, so make it specific: Cell Biology or Biology 101 rather than Biology.
  4. Click the Colour tag to cycle through colours.
  5. Type Keywords, separated by commas: BIO101, mitosis, Krebs cycle.

Changes save automatically. To remove a course, hover over its row and click the bin. Your courses also appear at the top of the subject list, where you can turn them off like any other subject.

Choosing keywords

Keywords help LarpLess decide which subject a screen belongs to. Whether you're studying at all is judged from the screen itself. In both screen check modes, the keywords that work best are words that actually appear on screen while you study the course: in the window title, the slides, the document or the web page.

Use terms that only show up in that course:

Avoid generic words that fit any subject, such as lecture, notes, chapter, exam, study, homework or slides. They show up on every course's screens, so they make your subjects harder to tell apart, not easier.

Give overlapping courses different keywords. If two of your courses are close, like Algorithms and Data Structures, give each one keywords the other doesn't have: Dijkstra, dynamic programming for one and linked list, hash table for the other. Don't put the same keyword on both.

A few more tips:

Friends

Friends is off by default, and while it's off nothing leaves your computer. Turned on, you can share the stats of finished sessions and see your friends' sessions.

  1. Open Friends and choose Turn on Friends, or switch it on in Settings → Friends.
  2. Create an account with a username (3–20 letters, numbers or underscores) and a password. You need to be 16 or older.
  3. Add a friend: on the Friends tab, type their exact username and Send request. Requests from others show up there to Accept or Decline.
  4. Share a session: on its summary, add an optional caption and press Post to friends. Posts show up in your friends' Feed.

A post carries your focus time, focus score, subject breakdown and streak. Never screenshots, window titles or app names.

Settings

Command palette and shortcuts

Press ⌘K to open the command palette. Type to filter, use the arrow keys to choose, and press Return to run a command. It can start, pause, resume or end a session, start a demo, skip a break, show the floating timer, go to any page, switch light or dark mode, sign in or out, and open this guide.

Shortcut Action
⌘K Command palette
⌘Return Start session
⌘. End session
⌥-click Start session Demo session

Privacy in short

The Privacy Policy has the details.

Troubleshooting