All docs · Feeds — news, sports, streams and any site

Documentation

Feeds — news, sports, streams and any site

Post news, sports, status pages, streamers, YouTube channels, subreddits, Steam games, GitHub releases or any website into a channel — ready-made feeds take one press, from the admin console or from a category.

What a feed does

A feed watches one source and posts each new item into a channel as a card: the headline, the picture and a short summary the source itself publishes, who published it, and a Read button that opens the full story. A stream posts once when it goes live, with Watch.

The bot checks every few minutes. The first check stays quiet: whatever a source has already published is recorded and none of it is posted, so adding a feed never floods a channel with its backlog. From then on, only what is new is posted.

Ready-made feeds

Most feeds take one press. Pick a pack, pick the channel, and press Add on any row:

Pack What is in it
🏈 Sports ESPN's top headlines, NFL, NBA, MLB, NHL, soccer and golf; CBS Sports NFL; BBC Sport football and the Premier League
🎓 College sports ESPN and CBS college football, NCAA FBS football, men's and women's college basketball
🏎️ Motorsport Formula 1, BBC Sport F1, ESPN F1 and racing, Motorsport.com F1, NASCAR, IndyCar and MotoGP, Autosport F1
🎮 Gaming PC Gamer, Polygon, Eurogamer, Rock Paper Shotgun, GameSpot, IGN, Xbox Wire, the PlayStation Blog
💻 Tech The Verge, Ars Technica, TechCrunch, Wired, Hacker News, the GitHub Blog, BBC News Technology
📰 News BBC News top stories and world, NPR, The Guardian world, The New York Times, Al Jazeera
🚦 Status pages Discord, Epic Games, GitHub and Cloudflare — every new incident and update

A row reads Added once that feed already posts in the channel you picked.

Your own feeds

Under ✨ Your own, press Set up on the kind you want and paste what you would naturally copy:

  • Twitch streamer — their name or channel link. It posts when they go live.
  • YouTube channel — the channel's link, its @handle or its channel id. It posts every new video.
  • Subreddit — just the name, like gaming.
  • Steam game news — the game's Steam store link or its app number. Patch notes and news.
  • GitHub releases — the project as owner/name, or its link. Every new release.
  • Any website — paste the site or its feed. If you paste the site, the bot finds the feed the site advertises.

The bot reads the source once when you add it, so a typo or a site with no feed is said straight away rather than discovered later.

From the admin console

/menu › Other › Admin › Settings › Feeds holds two rows:

  • Your feeds — every feed the server posts. ➕ Add a feed opens the packs; Manage on a feed lets you move it to another channel, change who it pings, pause or resume it, add a line of your own to each post, or remove it.
  • Defaults — the server's switch for feeds, the default channel and ping role, the most feeds the server may have, and whether any website may be added.

An admin's first feed turns feeds on for a server that has never set them up. If an admin has turned feeds off, a new feed is added and held until they are turned back on.

From a category

A category's Curators can add feeds to their own category: open the category, then Settings › Feeds. The feed posts in one of the category's own channels and can ping the category's own role, or nobody. A category can have up to five feeds. Feeds have to be switched on for the server first — an admin does that under Defaults.

Limits

  • 25 feeds a server by default; an admin can raise it to 100 under Defaults.
  • 5 feeds a category.
  • At most a handful of posts reach one channel at once; a burst is spread over the next few checks rather than dropped.

Pausing, moving and removing

Pause stops a feed posting without forgetting anything. Resume starts quiet, as do feeds switched back on: what appeared in the gap is not posted, only what is new after that. Move sends future posts to another channel. Remove asks once before it removes a feed for good — posts already in the channel stay, and adding the same feed again later starts quiet.

If a feed's channel is deleted, the feed pauses itself and says so on its row. Move it to another channel, then Resume it.

What isn't supported, and the alternative

X (Twitter), TikTok and Kick don't publish a feed the bot can rely on: reading them means a paid API, the creator's own sign-in, or scraping that breaks without warning. If you trust a feed bridge for one of them, add the bridge's address under Any website.

Twitch needs one application set up for the whole bot by whoever runs it. Until it is, Twitch reads Not yet — there is nothing for a server admin to change.

What the bot fetches

The bot only fetches public feeds on the standard web ports, and only the addresses the feed and the site themselves name. It never fetches anything on a private network, follows at most three redirects, reads at most 2 MB per feed, and waits between requests to the same site. Each check sends only the request for the feed itself. A feed address that carries a private key in it is never shown in full: lists, logs and posts show the site and the path, not the key.