the manual
guide
THE MANUAL · GUIDE · guide · RUNNING ARK O/S

How Pulse Reads Your Sources

sealed 2 September 2026 AD·
the guide
2 min read

Pulse watches the world for you. Every source it can watch, from a single web page to a paid search account, sits in one of four groups. None of them require guesswork. Here is what each one needs, and what it costs.

Four Kinds of Source

Works now, for free. No account, no key, nothing to set up. Point it at a page, a file, or a feed and it runs.

Works free, better with a key. These sources work out of the box. Add your own key for a service like Firecrawl or Apify and they get faster and more reliable.

Needs your own account. A handful of sources only work once you bring your own paid key: EXA, Serper, Apify, Firehose. You sign up with them directly, then paste the key into Settings.

Needs a server you run yourself. A few sources (RSSHub, SearXNG, Crawl4AI) open a much wider range of watching, but only once you run a small server on your own machine or network. No monthly fee, just the setup.

Reading the Light

Every source in Settings shows a small light. It tells you the real, current state of that source, not a guess.

Grey. Not set up yet. This is normal for anything that needs a key or a server you have not added.

Green. Working. The last check succeeded.

Amber. The last check did not work. Pulse will try again on its own next scan. One amber is noise, not a problem.

Red. This source has stopped working more than once in a row and probably needs an update. Check the key, the account, or the server behind it.

Adding a Key

Any source that needs one is added in Settings, under Feed Sources. Paste the key there and Pulse picks it up on the next scan. This guide covers why a key matters; Settings itself walks you through where to paste it.

Every Source, One Line Each

Works now, for free

  • Web page. Reads a single web page you point it at.
  • File on your Mac. Reads one Markdown or text file on your machine.
  • Folder on your Mac. Watches a folder for new notes and documents.
  • Custom URL or JSON API. Fetches raw data from a URL or a JSON feed you give it.
  • RSS or Atom. Reads any RSS or Atom feed, including ones from other tools.
  • GDELT. A free, live firehose of world news, updated every fifteen minutes.
  • Polymarket. Tracks prediction market odds and the news around them.
  • YouTube channel. Pulls titles and transcripts from a channel you follow.

Works free, better with a key

  • Website scrape (Firecrawl). Reads hard-to-scrape websites. Works free; your own Firecrawl key makes it more reliable.
  • X, formerly Twitter. Reads posts from an account. Works free; your own Apify key makes it steadier.

Needs your own account

  • EXA. Meaning-based web search. Needs your own EXA account.
  • Serper. Google search results. Needs your own Serper account.
  • Apify. Runs scraping tools for hard sites such as Instagram or TikTok. Needs your own Apify account.
  • Firehose. Real-time alerts when the web mentions something you are watching. Needs your own Firehose account and prepaid credit.

Needs a server you run yourself

  • RSSHub. Turns sites that have no RSS feed into one. Opens thousands of sources once it is running.
  • SearXNG. Searches across many engines at once, free and unlimited, once it is running.
  • Crawl4AI. Reads JavaScript-heavy sites that a plain fetch cannot. Runs on your own machine.

Nothing here is locked behind a paywall by default. Pulse works the day you install it, on the free sources alone. The paid and self-hosted ones are there for when you want more reach, not because the free ones are crippled.

Sealed by Third ARK · sha-········ · Verify this piece →