OPML Viewer
Browse OPML feed groups, preview recent posts from matched feeds, and compare one merged timeline in the docs app.
Source: apps/web/content/docs/guides/opml-viewer.mdx
OPML Viewer
The downloads page includes an optional OPML preview so you can inspect the exported feed bundles, preview recent posts from matched feeds, and scan one merged timeline before importing anything into Feedly, Inoreader, NewsBlur, or another reader.
Open the live viewer here: Downloads and OPML viewer.
Start Here
Use the downloads page in one of two ways:
| Goal | Best path |
|---|---|
| Import the full collection right away | Stay in Quick Downloads and grab the OPML or JSON file you need. |
| Check that the bundle contains the right feeds | Open the OPML preview and browse the feed list or folder groups. |
| Spot-check one source before importing | Use View Recent Posts on a matched feed. |
| Compare what is publishing now across many feeds | Use Load Merged Timeline, then adjust Timeline options only if you need a different depth. |
The preview is optional. If you already know which file you need, you can skip straight to the download cards.
What it shows
Flat OPML: a single list of feed subscriptions.Categorized OPML: the same feed catalog arranged into folders based on the repository taxonomy.Recent posts: fetches recent entries for a selected matched feed and renders them inline.Merged timeline: combines the newest posts from the currently visible matched feeds into one list.Timeline options: set the merged timeline size, limit how many posts come from each feed, and choose between a reused snapshot or a forced live refresh.Sort controls: reorder the feed list or the currently visible post list without leaving the page.- Feed metadata from the canonical catalog when the OPML label matches a feed we can preview live.
- Raw OPML samples so you can inspect the exported XML shape directly.
What the labels mean
Live preview ready: the feed maps back to a catalog entry the app can use for recent-post previews.Export only: the feed appears in the OPML export, but the viewer cannot fetch a live preview for it in this page.Merged timeline: one combined list of recent posts from the visible feeds that support live previews.Refresh live: bypasses the short-lived timeline snapshot and fetches again.
Why this exists
OPML files are useful for readers, but they are awkward to inspect by hand once the export grows large. The viewer gives you a readable preview of:
- how many outlines are in each export
- which entries have recognizable catalog metadata
- which folders appear in the categorized export
- whether any OPML entries are unnamed or incomplete
Typical workflow
- Open the downloads page.
- Switch between
Flat OPMLandCategorized OPML. - Search for a feed, topic, or source type.
- Use
Feed orderto keep the OPML order, sort alphabetically, or rank already-loaded feeds by their newest or oldest post date. - Click
View recent postson a feed to fetch recent items. - Use
Load merged timelinewhen you want one recent view across the visible matched feeds. - Open
Timeline optionsif you want a wider or narrower merged view. - Use
Refresh livewhen you want to bypass the short-lived timeline snapshot and fetch again. - Use
Sort poststo switch between newest-first, oldest-first, and title ordering. - Expand folders to inspect the actual entries that will be imported.
- Download the export you want.
Notes
- The viewer is both an OPML preview surface and a lightweight live feed inspector for matched feeds.
- The merged timeline fetches a small number of recent items per visible source and then merges them by publish date.
- The merged timeline snapshot is short-lived and meant to avoid repeating the same expensive live scan while you adjust filters or sorting.
- On very large visible source sets, using the search filter first will make the aggregated live scan return sooner.
- Catalog links and badges come from the canonical feed dataset when a matching title exists.
- If an OPML label does not map back to a catalog record, the viewer marks it as export-only so it is easy to spot.
When to use each export
| Export | Best for | Notes |
|---|---|---|
Flat OPML | Fast import into a reader that does its own organization | Smallest decision surface, one list of feeds. |
Categorized OPML | Readers where folder structure matters during import | Mirrors the repository taxonomy more closely. |
JSON Feed Data | Scripts, apps, or custom tooling | Includes structured metadata instead of reader-focused OPML. |