Markcat Web App Guide

Overview

The Markcat web app is a Progressive Web App (PWA) at markcat.app. It provides the full bookmark management experience in your browser — no extension or local service needed.

Features

• Real-time feed — bookmarks appear and update via Server-Sent Events (SSE) as they’re fetched and classified.
• Category tree — hierarchical browsing, same as the extension.
• Search — find bookmarks by title, URL, or content.
• Responsive — works on desktop and mobile. Installable as a PWA.
• Themes — System, Daylight, Dusk, Midnight.

Sidebar Navigation

Use the section headings to fold Categories, Issues, Smart Filters or Tags; the browser remembers each section’s state. The magnifier beside Categories finds category names while keeping their parent context. Clear the search to restore the tree, or press Escape to close it. Use + beside the heading to add a category. Tag chips filter the library; click the selected chip again to clear that filter.

Browsing and Organizing

• Views — switch between List, Tiles and Timeline in the toolbar; in Tiles the toolbar also sets the column count.
• Preview — click a bookmark to open its preview: the full summary, its images and its translations. Middle-click it, or choose Open in new tab from its right-click menu, to open the page itself.
• Display language — the toolbar’s language menu switches the cards between the original text and your summary languages; it is the same setting as Settings → Appearance → Display language.
• Favourites — the star on a bookmark marks it; the Favourites smart filter lists them.
• Select — toggle Select in the toolbar, Ctrl-click (Cmd-click on a Mac) a bookmark, or long-press it; Shift-click then selects a range. The selection bar offers Move…, Re-extract, Re-classify and Delete. A delete can be undone from the toast that confirms it.
• Keyboard — press ? for the shortcut list.
• Per-device options — Settings → Appearance holds the theme, the tile image carousel, whether a tile click opens the preview or the page, and whether the library opens on Favourites. These are saved to the device, not to your account.

Saving Bookmarks

From the web app:

• Add URL — paste a URL into the add bookmark form.
• Android share sheet — once the PWA is installed, Markcat appears in Android’s Share menu. Share a link from Chrome (or any app) → pick Markcat → the bookmark is added and you land back in the list. No extension needed. Requires being signed in; if you aren’t, you’re sent to login and returned to the share once authenticated.
• Apple Shortcut — on iOS, use the Markcat shortcut to share a URL directly from Safari (requires a Personal Access Token).

Import / Export

Open the Import / Export dialog from the toolbar:

• Import — drop a Netscape .html bookmark file (Chrome/Firefox/Safari export format).
• Export HTML — choose the folder structure:
  • By category (classified) — folders mirror Markcat’s classified category_path (default).
  • By import folder (original browser hierarchy) — folders mirror the import_tag captured at import time, preserving the original browser layout. Bookmarks added directly (extension, manual add) land at the root.
• Export JSON — full bookmark records. The Include extracted page content checkbox controls whether content_raw (the full extracted page text) is included. It is off by default for privacy and smaller payloads.

Reviewing and Fixing Classifications

Not every page classifies cleanly. The Needs review row in Smart Filters shows the count and filters the library. Use the arrow on that row, labelled Open Review Queue, to open the review workflow. For each bookmark in the queue you can:

• Re-classify — run classification again on the already-extracted content.
• Re-extract (failed bookmarks) — re-fetch the page, then classify again.
• Dismiss — keep the current category and clear the bookmark from review.

Re-classify all and Dismiss all act on the whole queue.

The sidebar’s Issues section collects problem bookmarks: Dead links, Broken links, Bot protected, Awaiting / failed, Low confidence and Fetch failed, each shown once it has bookmarks.

Credits and Processing

Every automatic classification (fetch → summarize → categorize) consumes one classification credit, and so does Refine subcategory (bookmark context menu, on a categorized bookmark), which re-runs only the last categorization step. Storing, browsing, searching, and manually editing bookmarks never cost credits. Every plan’s monthly allowance resets each calendar month; top-up credits never expire.

When you run out of credits, new bookmarks are still saved — they wait in the queue and classify automatically once your credits refresh, or immediately after a top-up.

The Processing page (/app/processing, opened from the status indicator in the sidebar) shows the pipeline at work: per-loop queue counts (Prefetch, Classify, Favicon, OG image and Screenshot), loop states with average processing times, and the worker log. LLM response detail appears on failed classifications, and on every call when the operator has explicitly enabled bounded diagnostic payloads; prompts are never exposed through the API. A local service offers Start when its worker is stopped and Pause/Resume while it runs; hosted accounts have monitoring only.

Account & Billing

• Top-up packs (paid plans): 500 / €2.99 · 2,000 / €8.99 · 10,000 / €44.99 — one-time credit purchases that never expire.
• Annual bonus: annual plans grant bonus classification credits each billing year — 2,000 on Basic Annual, 10,000 on Pro Annual.
• Summary languages: Free and Basic generate 1, Pro up to 3.
• Manage your plan, top-ups, and invoices from Settings → Subscription & Billing (powered by Stripe).

PWA Installation

1. Open markcat.app in Chrome, Edge, or Safari.
2. Click “Install” in the address bar (or “Add to Home Screen” on mobile).
3. The app installs as a PWA. Its service worker caches the app shell. The app caches bookmark images (screenshots, page images and favicons) on this device and clears them when the account changes; bookmark lists and details always come from the server, so your library is unavailable offline.
4. On Android, installing also registers Markcat as a share target — it then shows up in the system Share sheet for adding links (see Saving Bookmarks above). Self-hosters get this too, provided the instance is served over HTTPS (a plain-HTTP LAN address is not a secure context, so neither install nor share target work).