---

Once installed and enabled, this extension will automatically suspend tabs that have not been used for a default, or user-configurable, time interval. As a result, resources such as memory and CPU that the tab was consuming are freed.

If you have suggestions or problems using the extension, please submit a bug or a feature request.

---

Chrome Web Store

The Marvellous Suspender is available via the official Chrome Web Store.

For more information on the permissions required by the extension, see kb.marvellouscode.works/docs/TMS/permissions.

---

Install as an extension from source

Requires Google Chrome 110 or later (Manifest V3).

1. Download the latest available version and unarchive to your preferred location.
2. In Google Chrome, navigate to chrome://extensions/ and enable Developer mode (toggle in the upper right corner).
3. Click Load unpacked extension....
4. Browse to the src directory of the unarchived folder and confirm.

The "welcome" page will open indicating successful installation.

Be sure to unsuspend all suspended tabs before removing any other version of the extension - suspended tabs that are removed will disappear forever.

Build from source

Dependencies: openssl, npm.

npm ci
npm run generate-key
npm run build

Output should end with:

Done, without errors.

The extension in .crx format will be inside build/crx/. You can drag it into chrome://extensions to install locally.

"This extension is not listed in the Chrome Web Store" - if Chrome prevents you from enabling the .crx, extract the .zip from build/zip/, navigate to chrome://extensions, click Load unpacked extension..., browse to the extracted folder, and confirm.

Run the tests

npm ci
npm test

Unit tests live in tests/ and run with Vitest under Node. Setup, lint, locale check and the keyless build are described in CONTRIBUTING.md.

---

Contributing

Contributions are very welcome. Feel free to submit pull requests for new features and bug fixes. For new features, please raise an issue first so we can discuss the approach - this will go a long way to ensuring your pull request is accepted.

The rules every change has to meet are in AGENTS.md; the practical guide (setup, branches, how review goes) is in CONTRIBUTING.md. Security issues go through SECURITY.md, never a public issue.

Maintainers

TMS is maintained by @gioxx (lead), @rkodey and @amargiovanni. Who decides what is in MAINTAINERS.md.

Contributing with AI tools

You can use AI tools to write code, tests or docs for TMS. What is expected of the person who opens the pull request is in AGENTS.md, under "Working with AI tools". That file is written for coding agents as well as for people, so that a tool pointed at the repository reads the same rules you do.

Localization (l10n)

Help localize the extension into your language via Crowdin: crowdin.com/project/tms.
If your language is not available, submit a feature request.

[!IMPORTANT]
Only en (English) and it (Italian) are maintained directly and can be relied upon as accurate.
All other languages were recently brought up to date with AI assistance to close large translation gaps - the result should be functional, but has not had a native-speaker review pass.
If you're fluent in one of these languages, corrections and improvements via Crowdin are very welcome.

---

License

This work is licensed under a GNU General Public License v2.

---