First 5 Minutes with Capcat

Install and collect your first articles.

Install

pipx install capcat

Requires Python 3.9+.

Verify

capcat list sources

You should see 10+ config-driven sources and the custom sources (hn, lb, etc.).

Your First Fetch

capcat fetch hn --count 5 --html

This fetches 5 articles from Hacker News with HTML output.

View the Output

News/
  hn/
    index.html          ← open this in a browser
    2026-05-06-article-title/
      article.html
      article.md
      comments.html
      comments.md

Open News/hn/index.html in your browser to browse the fetched articles.

Next Steps