Help — RetroHexChat

Bot RSS Capability

The RSS capability monitors RSS and Atom feeds and automatically posts new items to designated channels.

Commands

All of these require server administrator or operator privilege, reading the list included: a feed address is something the server itself goes out and fetches.

Command Description
!Bot rss add <url> <#channel> Add an RSS/Atom feed
!Bot rss list List all configured feeds
!Bot rss remove <id> Remove a feed by ID
!Bot rss check <id> Force-check a feed immediately

How It Works

  • Feeds are polled at a configurable interval (default: every 30 minutes)
  • Only new items since the last check are posted
  • Uses HTTP conditional requests (ETag/Last-Modified) for efficiency
  • Feed titles are auto-detected from the feed metadata
  • Items are posted as rich Markdown link previews with a source label, linked title, optional image, and optional description

Configuration

Admins can configure via /bot set:

  • rss_interval — Poll interval in minutes (default: 30)
  • rss_max_feeds — Maximum feeds per bot (default: 5)
  • rss_max_items — Maximum items posted per poll (default: 3)

Examples

!MyBot rss add https://blog.example.com/feed.xml #news !MyBot rss add https://example.com/rss news !MyBot rss list !MyBot rss check f1a2b3 !MyBot rss remove f1a2b3

Notes

  • URLs must start with http:// or https://
  • The # prefix on channel names is added automatically if missing
  • Polling timers automatically reschedule after each poll
  • Preview metadata comes from page standards such as Open Graph, Schema.org JSON-LD, and oEmbed discovery
  • Fetch errors are logged but do not stop future polls

See Also

BotService Overview · /bot Command Reference · Bot Scheduler · Link Previews

See Also

  • Restore
  • Minimize
  • Maximize
  • Close
  • Cascade Windows
  • Tile Windows Horizontally
  • Tile Windows Vertically
  • Minimize All Windows