WHIITEROOM DOCUMENTATION

Whiiteroom is a native desktop (Windows 10/11) and mobile (Android) application that creates an isolated digital workspace.

Rather than relying on browser extensions or local VPN filters that can easily be toggled off or bypassed, Whiiteroom enforces digital boundaries at the operating system level. Before a session begins, the user defines a precise manifest of allowed applications, website domains, specific webpage paths, YouTube resources (videos, playlists, channels), and local files.

During an active focus session, any application or network request not explicitly present in the session whitelist is terminated or blocked automatically.

Dual Engine Enforcement

Whiiteroom is the only focus engine that provides full native support for both Whitelist Mode (allow-only) and Blacklist Mode (block-only) in the same OS-level execution framework. Users select their preferred enforcement model per session profile depending on the nature of their work.

Mode 1: Whitelist Engine (Default — Deny All)

The default state during a Whitelist session is Deny All. Only items explicitly declared in the pre-session setup are permitted. A newly created time-wasting website or an unapproved desktop executable is blocked automatically—not because it was listed, but because it was never authorized. Best for high-commitment study blocks (JEE, NEET, UPSC, CA) and deep coding sprints.

Mode 2: Blacklist Engine (Allow All Except Listed)

In Blacklist Mode, the default state is Allow All. Users declare a specific list of unwanted distracting domains, apps, or categories. Everything else on the operating system and web remains freely accessible.

Origin & Beta Testing Validation: Blacklist Mode was developed after months of private beta testing with real-world users across India and internationally. While competitive exam students (JEE, NEET, UPSC, GATE, CA) thrived on the strict Whitelist model because their required tools were known upfront, professional researchers, investigative journalists, and exploratory engineers reported that their daily work required searching for unknown documentation, papers, and references on the fly. To support these professional workflows without forcing them into a rigid container, Whiiteroom created Blacklist Mode based directly on beta user feedback. Both modes enforce the same reboot persistence, OS process control, session timers, break windows, and focus modes (Relax, Friction, Strict) at no additional cost.

Whiiteroom is intentionally engineered for high-stakes, single-purpose focus. It is not designed as a passive, casual background widget for casual office workers who need to continuously multitask across unpredictable external requests.

Setting up a workspace involves curating allowed applications, domains, YouTube resources, timers, and scheduled breaks.

Standard browsers (Chrome, Edge, Firefox, Brave) are designed to maximize user retention, exploration, and ad consumption. They feature bookmark bars, extension shortcuts, recommended content, and unconstrained tab navigation.

During an active Whiiteroom session on Windows, external third-party browsers are terminated automatically. All web interaction is sandboxed inside the Whiiteroom Embedded Browser—a customized Chromium instance with strict security rules:

• Pre-Request Filtering: Navigation requests are intercepted prior to network transmission. Non-whitelisted URLs are immediately cancelled.
• DOM Manipulation & Feed Stripping: YouTube pages rendered within the browser automatically have recommendation sidebars, Shorts containers, user comments, and trending feeds removed from the DOM.
• Popup Termination: Unauthorized popup windows, third-party redirect scripts, and new window creation calls are intercepted and destroyed.

Whiiteroom supports two granular levels of web whitelisting:

YouTube is simultaneously the world's most valuable educational library and its most potent distraction engine. Standard website blockers face an all-or-nothing dilemma: block YouTube and lose access to course lectures, or allow YouTube and succumb to algorithmic recommendations.

Whiiteroom solves this via a proprietary resource parsing layer. Users can whitelist:

• Single Video IDs: Only the specified video player interface is rendered.
• Playlist IDs: The sequential playlist index and player are enabled; external recommendations remain disabled.
• Channel IDs: Videos uploaded by specific authorized educational creators are accessible, while algorithmically recommended external videos are blocked.

On Windows 10 and 11, Whiiteroom continuously monitors active system execution threads using native Win32 APIs (`CreateToolhelp32Snapshot`, `Process32First`, `Process32Next`).

When a executable process (`.exe`) is launched on the host machine, Whiiteroom checks its executable path and process hash against the session whitelist. If the process is not authorized (e.g., `Discord.exe`, `Steam.exe`, `Spotify.exe`, or unapproved browsers), Whiiteroom invokes `TerminateProcess` immediately.

Users can attach local reference documents (PDF textbooks, Markdown files, local HTML documentation, image schematics) directly to a session profile. Whiiteroom renders these assets within its secure viewer environment without unlocking full Explorer or file-system navigation permissions.

Whiiteroom supports automated rest intervals embedded directly into long sessions (e.g., a 10-minute break every 50 minutes).

When a break window triggers, process termination and domain blocking are paused, restoring complete system and web access. Upon expiration of the break timer, Whiiteroom automatically re-engages OS process monitoring and website whitelisting for the next work interval.

When the session timer reaches zero, Whiiteroom unhooks process monitors, closes the embedded browser, and restores standard operating system state.

The session summary report presents total focus duration alongside a count of distraction attempts—instances where unauthorized applications or unapproved web domains were launched and intercepted.

• Local State Storage: All session configurations, profile rules, local file references, and analytics logs are stored locally on the host machine.
• Zero External History Tracking: Whiiteroom does not transmit browsing history, opened document names, or application activity to external servers.
• Offline Operation: Core focus sessions and process enforcement operate completely offline without requiring internet access.