# Focus Room

> A calm room for your screen: ambience playlists, gentle effects, slow visuals and a timer. Focus Room plays Soundscape Atlas ambience scenes as a playlist with smooth crossfades, shapes them with a master equalizer, room reverb and stereo width, and fills the screen with slow, seamlessly repeating generative backgrounds. A Pomodoro, 52/17 or custom focus timer rings gentle chimes, a sleep timer fades everything out, and a local session log shows your week as a heatmap. Nothing plays until you press Play, and nothing leaves your device.

Focus Room (Ambience player & focus timer) is a premium app of usefulweb.app (https://usefulweb.app/): a full program that runs in the browser. Its engine is deterministic and the same functions are exposed as tools, so an agent can compute exactly what the app shows.

## Use it
- Landing page: https://focusroom.usefulweb.app/
- Workspace (browser app): https://focusroom.usefulweb.app/app - open a project with https://focusroom.usefulweb.app/app#project=<base64url-encoded project JSON> or a template with https://focusroom.usefulweb.app/app#template=<id>
- Project file format (JSON Schema): https://focusroom.usefulweb.app/project.schema.json
- Tutorials: https://focusroom.usefulweb.app/tutorials
- JSON API: POST https://focusroom.usefulweb.app/api/v1/tools/<toolId>/calculate (catalog: https://focusroom.usefulweb.app/api/v1/tools)
- OpenAPI: https://focusroom.usefulweb.app/openapi.json
- MCP (Streamable HTTP): https://focusroom.usefulweb.app/mcp

## Engine tools
- [Focus Room Playlist Renderer](https://focusroomplaylistrender.usefulweb.app/): Mix a playlist of generated ambience scenes with crossfades and master effects into a WAV. Part of [Focus Room](https://focusroom.usefulweb.app/) (ownerApp: focusroom). API: POST https://focusroom.usefulweb.app/api/v1/tools/focusroom-playlist-render/calculate · MCP tool `focusroom_playlist_render`
- [Focus Room Focus Timer Planner](https://focusroomfocustimer.usefulweb.app/): Plan Pomodoro, 52/17 or custom focus blocks and export them as a calendar file. Part of [Focus Room](https://focusroom.usefulweb.app/) (ownerApp: focusroom). API: POST https://focusroom.usefulweb.app/api/v1/tools/focusroom-focus-timer/calculate · MCP tool `focusroom_focus_timer`
- [Ambience Generator (rain, wind, stream, fire, hum, drone)](https://soundscapeambiencegenerator.usefulweb.app/): Synthesize rain, wind, water, fire, room hum or a drone as a seamless-loop WAV. Part of [Soundscape Atlas](https://soundscape.usefulweb.app/) (ownerApp: soundscape). API: POST https://focusroom.usefulweb.app/api/v1/tools/soundscape-ambience-generator/calculate · MCP tool `soundscape_ambience_generator`
- [Noise Generator (white, pink, brown)](https://soundscapenoisegenerator.usefulweb.app/): Make white, pink, brown, blue or violet noise as a WAV file and check its spectrum. Part of [Soundscape Atlas](https://soundscape.usefulweb.app/) (ownerApp: soundscape). API: POST https://focusroom.usefulweb.app/api/v1/tools/soundscape-noise-generator/calculate · MCP tool `soundscape_noise_generator`
- [Room Reverb for WAV Files](https://soundscapereverb.usefulweb.app/): Add room, hall, cathedral or cave reverb to a WAV file with a known reverberation time. Part of [Soundscape Atlas](https://soundscape.usefulweb.app/) (ownerApp: soundscape). API: POST https://focusroom.usefulweb.app/api/v1/tools/soundscape-reverb/calculate · MCP tool `soundscape_reverb`

## Formats
- Import: Focus Room room (.focusroom.json), Soundscape Atlas scene (.soundscape.json, file or App Bridge), Share link (#project=)
- Export: WAV (16-bit stereo, playlist with crossfades and effects), Focus Room room (.focusroom.json), Calendar file of the focus plan (.ics), Session log (.csv), Credits of the recordings (.txt), Share link

## Limits
- Playback follows the browser’s audio clock; phones may pause audio and timers in background tabs or with the screen off.
- Crossfades are triggered by a page timer: in background tabs a change can start up to about a second late.
- The limiter is a soft clipper (tanh knee), not a look-ahead broadcast limiter; very loud mixes can still sound compressed.
- Recordings come from Wikimedia Commons and need a connection; the server playlist tool renders only generated scenes.
- The WAV render is limited to 12 scenes and 10 minutes; long rooms are rendered with shortened scenes.
- Wake lock and full screen depend on the browser; some browsers ignore them or ask first.
- The session log lives in this browser only and is not part of backups made with room files.
- Generated scenes imitate rain, surf or a café with filtered noise; they are not recordings of those places.