# 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.*