Files
catcher-of-tabs/README.md

92 lines
2.3 KiB
Markdown

# TabCatcher
> *A browser extension for people who open 47 tabs and call it "research".*
TabCatcher is a tiny Microsoft Edge (and Chrome-compatible) extension that rounds up all your feral open tabs and herds them into a neat Markdown file — titles, URLs, descriptions, and all.
---
## What it does
You click a button. Your tabs become a `.md` file. That's it. That's the whole thing.
More specifically:
- Counts your open tabs and windows so you can feel something
- Fetches `<meta>` descriptions from each page (optional — it does slow things down a smidge)
- Groups tabs by window if you're the type who organizes chaos into labeled chaos
- Stamps the export with a timestamp so future-you knows exactly when past-you had 74 tabs open at 2am
---
## Installation
This extension isn't on the store (yet). Load it manually:
1. Clone or download this repo
2. Open Edge and go to `edge://extensions/`
3. Enable **Developer mode** (toggle, top-right)
4. Click **Load unpacked** and point it at this folder
5. Pin the extension and marvel at that little icon
---
## Usage
1. Click the TabCatcher icon in your toolbar
2. Pick your export options
3. Hit **Export Tabs**
4. Save the `.md` file somewhere you'll definitely find it later
### Export options
| Option | Default | What it does |
|---|---|---|
| Include page descriptions | On | Grabs `meta description` / `og:description` from each tab |
| Group by window | Off | Splits the export into sections per browser window |
| Include timestamp | On | Adds the date/time to the top of the file |
---
## Output format
The exported file looks something like this:
```markdown
# Browser Tabs Export
**Exported:** Tuesday, April 1, 2026 at 2:14 AM
**Total Tabs:** 52
---
- **How to center a div - Stack Overflow**
- URL: https://stackoverflow.com/questions/...
- Description: The definitive resource for div-centering discourse
- **cute cat videos - YouTube**
- URL: https://youtube.com/...
```
---
## Permissions
TabCatcher asks for only what it needs:
- `tabs` — to read tab titles and URLs
- `scripting` — to extract page descriptions from each tab
- `downloads` — to save the `.md` file to your disk
- `activeTab` — standard popup permission
---
## Contributing
Found a bug? Have a feature idea? Open an issue or a PR. All tabs welcome.
---
*Built because browser bookmarks are a lie we tell ourselves.*