Scroll Stopper

Stop doomscrolling on X/Twitter. See your tweets, then take a break.

What It Does

Scroll Stopper helps you set a hard limit on how many tweets you see before X/Twitter is blocked with a break reminder.

• Counts real tweets on the page using MutationObserver
• Supports separate limits for the For You and Following tabs
• Shows a blocking overlay after you hit your limit
• Lets you configure tweet limits from 5 to 50
• Lets you configure reset intervals from 1 to 24 hours
• Skips promoted tweets so ads do not count against your limit
• Displays a badge with your remaining tweet count
• Leaves the rest of X usable, including DMs, search, and posting

Screenshot

Screenshot placeholder.

Installation

Chrome Web Store

Link coming soon. (TBD)

Manual Install

1. Clone this repository
2. Run npm install
3. Run npm run build
4. Open Chrome and go to chrome://extensions
5. Enable Developer mode
6. Click Load unpacked
7. Select the dist/ folder

Configuration

Use the extension popup to configure your limits and reset interval. You can set different tweet limits for the For You and Following tabs, then adjust how often those counters reset.

Privacy

All data is stored locally using chrome.storage.local. Nothing is sent anywhere. There are no analytics, no tracking, and no external data collection.

Tech Stack

• TypeScript
• Chrome Extension Manifest V3
• esbuild

License

MIT. See LICENSE.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Open a pull request