← Back
graceelechi-stack

graceelechi-stack/Buffer-break

A Chrome extension that makes your tab look frozen with a fake "Page Unresponsive" message, so you can take a well-earned break. πŸ˜‰

View on GitHub β†—
Stars
3
Forks
0
Watchers
3
Open issues
0
Contributors
1
Language
HTML
License
β€”
Default branch
main
Created Oct 1, 2026Updated Oct 1, 2026

Star growth

Todayβ€”
This weekβ€”
This monthβ€”

Star history will appear here once this repo has been tracked for a couple of days.

README

Buffer Break

Go on, stretch, sip, scroll. We'll blame the browser. πŸ˜‰

Buffer Break is a Chrome extension that makes the tab you're on look frozen. It takes a real screenshot of the page, covers the page with it so nothing can be clicked or typed into, and then shows Chrome's familiar "Page Unresponsive" message. To everyone else, the page just hung. To you, it's a break.

It was built with Figma in mind, but it works on almost any website. It runs in Google Chrome, Microsoft Edge and Brave.

In your browser it appears as FocusFlow: Workspace Optimizer, so it looks like an ordinary productivity tool in your toolbar and extensions list. Its description still says what it really does.


Why I built it

It started on a Tuesday. I'd been staring at the same Figma frame for three hours. My neck had locked into a permanent "designer hunch," my coffee had gone cold, and my eyes were starting to see in 8px grids.

I wanted to stand up and stretch. Just two minutes. But the boss was doing laps, and an empty chair at the wrong moment says "not working" louder than any status update ever could.

Then I had a thought: what if the computer took the blame?

Everyone has watched a browser freeze. Nobody questions it. You just sigh and wait. So I built Buffer Break. One shortcut, and my screen locks up with a perfectly believable "Page Unresponsive" message. To the world, Chrome is having a moment. To me, it's time to roll my shoulders, refill my water, and remember I have legs.

Is it the most productive thing I've ever made? Arguably, yes. My back feels better, my eyes get a break from the glare, and science says short breaks improve focus. So technically, this is a productivity tool. That's what the name says, anyway.

You'll use it too. Maybe not today, but on that long afternoon when your spine starts filing complaints, you'll remember: Alt + Shift + F.

Stretch, sip, scroll. We'll blame the browser. πŸ˜‰


Contents

  • Why I built it
  • What it does
  • Install (about 2 minutes)
  • How to use it
  • Settings
  • Troubleshooting
  • Privacy and permissions
  • Updating and uninstalling
  • Project structure
  • The Figma plugin (experimental)

What it does

  1. You press Alt + Shift + F (or click Freeze this tab in the popup).
  2. The extension takes a screenshot of the current tab and lays it over the page. The page looks exactly the same, but nothing reacts: no clicks, no scrolling, no typing.
  3. After about 5 seconds, a "Page Unresponsive" box appears with Exit page and Wait buttons, matching your light or dark mode.
    • Wait hides the box, and it comes back 15 seconds later, just like the real one.
    • Exit page does nothing.
  4. When you're ready, press Ctrl + U and the page is back to normal instantly. You can also set a timer to unfreeze automatically.

Install (about 2 minutes)

The extension isn't on the Chrome Web Store, so you load it yourself using Chrome's Developer mode. Nothing extra needs to be installed.

1. Download it

Go to the Releases page, open the latest release, and download buffer-break-extension.zip.

Prefer the code? Click the green Code button β†’ Download ZIP, then use the chrome-extension folder inside it in step 3.

2. Unzip it

  • Windows: right-click the zip β†’ Extract All… β†’ Extract.
  • Mac: double-click the zip.

You'll get a folder called buffer-break-extension. Put it somewhere it can stay, such as your Documents folder. Don't delete or move it later: Chrome loads the extension from this folder every time it starts.

3. Load it into your browser

  1. Open a new tab and go to:
    • Chrome: chrome://extensions
    • Edge: edge://extensions
    • Brave: brave://extensions
  2. Turn on Developer mode. It's a switch in the top-right corner (in Edge, it's in the left sidebar).
  3. Click Load unpacked.
  4. Select the buffer-break-extension folder (the one that contains manifest.json) and click Select Folder.

You'll see FocusFlow: Workspace Optimizer appear in your extensions list.

4. (Optional) Pin it to your toolbar

Click the puzzle-piece icon 🧩 next to the address bar and click the pin next to FocusFlow. You don't have to: the keyboard shortcut works either way.


How to use it

Action How
Freeze the current tab Press Alt + Shift + F, or click the toolbar icon β†’ Freeze this tab
Unfreeze Press Ctrl + U (Cmd + U on Mac)
Unfreeze automatically In the popup, choose Timer and pick a duration before freezing

Quick test: open any website, press Alt + Shift + F, try clicking around (nothing happens), wait for the "Page Unresponsive" box, then press Ctrl + U.

Ctrl + U only unfreezes while a page is frozen. The rest of the time it does whatever it normally does on that site.


Settings

Click the toolbar icon to open the popup.

  • Duration: Until I unfreeze (default) keeps the page frozen until you press Ctrl + U. Timer unfreezes it automatically after 5, 10, 15 or 30 minutes, or any number of minutes you type into Other (up to 240).
  • Freeze shortcut: click the ✏️ pencil to change Alt + Shift + F. This opens Chrome's shortcut settings. Chrome requires shortcuts to include Ctrl or Alt.
  • Toolbar icon: click the Toolbar icon row to pick a different icon. You can choose from neutral icons (dots, cloud, note, leaf, ring) or emoji (β˜• 🌿 πŸ“Ž 🧊 🐒 😴 🍡 πŸ“Œ). The default is a plain grey dots icon that gives nothing away. This only changes the toolbar icon; the extensions page always shows the default.

Your settings are saved and remembered.


Troubleshooting

Problem Fix
Alt + Shift + F does nothing Another extension may already use that shortcut. Go to chrome://extensions/shortcuts, find FocusFlow, and set a different one. Or click the toolbar icon β†’ Freeze this tab.
"Chrome doesn't let extensions touch this page" Chrome blocks every extension on its own pages: chrome:// pages, the New Tab page, the Chrome Web Store and the built-in PDF viewer. Try it on a normal website.
It doesn't work on a file opened from my computer Go to chrome://extensions, click Details under FocusFlow, and turn on Allow access to file URLs.
Ctrl + U doesn't unfreeze Click once anywhere on the frozen page so the page has keyboard focus, then press Ctrl + U again. As a last resort, clicking the browser's reload button ↻ always unfreezes it (F5 won't, because every key is blocked while frozen).
"Load unpacked" or Developer mode is missing or greyed out Your device is probably managed by a school or company that blocks custom extensions. Use a personal device, or ask your IT team.
The extension disappeared after a restart The folder was probably moved or deleted. Put it back (or download it again) and repeat Load unpacked.
Chrome shows a "Disable developer mode extensions" warning That's normal for extensions loaded this way. Click the βœ• or Cancel to keep it.

Privacy and permissions

Buffer Break doesn't collect, store or send any data. It makes no network requests at all.

  • The screenshot is held only in memory while the page is frozen. It's never saved to disk or uploaded, and it's discarded the moment you unfreeze.
  • The only things saved are your settings (duration, timer length and toolbar icon), stored locally in your browser.

What each permission is for:

Permission Why it's needed
activeTab To screenshot and freeze only the tab you're on, and only when you press the shortcut or click Freeze. It gets no access to your other tabs or your browsing history.
scripting To place the frozen screenshot and the "Page Unresponsive" box on top of that page.
storage To remember your settings.

Updating and uninstalling

Update: download the new release, replace the old folder's contents with the new ones, then go to chrome://extensions and click the ↻ reload icon on the FocusFlow card.

Uninstall: go to chrome://extensions and click Remove on the FocusFlow card. You can then delete the folder.


Project structure

buffer-break/
β”œβ”€β”€ chrome-extension/        The Chrome extension (this is what you install)
β”‚   β”œβ”€β”€ manifest.json        Name, permissions and the Alt+Shift+F shortcut
β”‚   β”œβ”€β”€ background.js        Takes the screenshot and starts the freeze
β”‚   β”œβ”€β”€ freeze.js            Runs in the page: overlay, input blocking, dialog, Ctrl+U
β”‚   β”œβ”€β”€ popup.html / .js     The settings popup
β”‚   β”œβ”€β”€ icons.js             Toolbar icon options (drawn in code)
β”‚   └── icons/               Default icon images
└── figma-plugin/            Earlier Figma desktop-app version (experimental)

No build step, frameworks or dependencies: it's plain HTML, CSS and JavaScript. To work on it, edit the files in chrome-extension/, then click ↻ on the extension's card at chrome://extensions to reload it.


The Figma plugin (experimental)

figma-plugin/ contains the first version of this idea, built as a plugin for the Figma desktop app. Figma plugins can't take real screenshots, cover Figma's side panels, or hide their own title bar, so it isn't as convincing as the Chrome extension. It also still contains two diagnostic buttons (Test coverage and Test transparency) from that experiment.

To try it: in the Figma desktop app, open a design file, then go to Menu β†’ Plugins β†’ Development β†’ Import plugin from manifest… and choose figma-plugin/manifest.json. Freeze with the Freeze button and unfreeze with Ctrl + Alt + Shift + B.


Take breaks responsibly. πŸ˜‰