HOW WHIITEROOM WORKS
Step-by-step walkthrough of setting up your workspace, configuring timers, choosing focus modes, and completing your session.
Select Apps, Websites, Files & YouTube
Choose everything you need for your task before you begin. You can add:
- Applications: Desktop software (e.g., VS Code, Obsidian) or mobile apps on Android.
- Websites & Pages: Entire web domains (e.g., `github.com`) or specific webpage links.
- Local Files: PDF books, notes, diagrams, or project folders on disk.
- YouTube: Single video links, course playlists, or creator channels.
Save your setup as a reusable workspace profile if you plan to use it again.
Pre-Session Account Sign-In
Log into your required accounts (e.g. Google, GitHub, ChatGPT) before launching your session. This ensures all your logins are authenticated and ready inside the Whiiteroom Browser without authentication interruptions during deep work.
Set Focus Timer & Scheduled Breaks
Choose your total session length (e.g. 25m, 50m, 90m, or custom duration). Configure scheduled break intervals (e.g. a 5-minute break every 50 minutes) so you can rest periodically without breaking session continuity.
Choose Your Focus Mode
Select your desired commitment level:
- Relax Mode: Flexible session that you can end whenever you want.
- Friction Mode: Solves impulsive exits by requiring a challenge before leaving early.
- Strict Mode: Locks your workspace boundaries until your timer expires.
Review & Start Session
Review your complete list of approved apps, websites, files, YouTube links, and timer rules. Once you confirm, click Start Session to launch your distraction-free workspace.
Workspace Enforcement & Deep Focus
Whiiteroom locks your workspace into action. Only your approved apps and websites remain available. If you try opening an unapproved application or visiting an unapproved URL, Whiiteroom automatically blocks or closes it.
Scheduled Breaks & Auto Resume
When a scheduled break starts, restrictions pause temporarily so you can relax or stretch. As soon as the break timer reaches zero, Whiiteroom automatically restores your focus session and continues with your remaining work time.
Session Finish & Return to Normal
When your session timer finishes, Whiiteroom automatically removes all workspace restrictions. Your device returns to its normal state instantly.
Optional: Use the Auto-Start Scheduler
New FeatureInstead of manually going through Steps 1–8 every time, you can use the Session Scheduler to define a weekly focus calendar. Whiiteroom will automatically start your session at exactly the right time — no manual action needed.
- Set a day and time: Choose one or multiple days of the week and a specific start time.
- Recurring or One-Time: Mark sessions as Permanent (repeats weekly) or One-Time (fires once and is removed).
- Per-session custom lists: Each scheduled session has its own whitelist or blacklist — separate from your global one.
- Pre-launch notification: Get a heads-up 1–15 minutes before enforcement begins.