intake-sources/README.md

2.2 KiB

intake-sources

This repo contains programs that act as intake feed sources.

The provided NixOS module adds the default overlay to nixpkgs, providing each feed source program individually as well as the intakeSources package that provides all of them together.

intake-rss

A feed source that wraps an RSS or Atom feed.

Supported env:

  • FEED_URL: Required. The url of the RSS/Atom feed.
  • FEED_TITLE: Override the feed <title>. Item titles are in the format "[feed title]: [item title]".

intake-reddit

A feed source that fetches posts from a subreddit.

Supported env:

  • SUBREDDIT_NAME: Required. The subreddit name with no r/ prefix.
  • SUBREDDIT_PAGE: The listing page to fetch posts from. Defaults to hot. Listings that support multiple time ranges can specify as e.g. top_week.
  • REQUEST_RETRY: Attempt count for fetching posts. Retries are done with exponential backoff.
  • FILTER_NSFW: By default, NSFW posts are included. Set to a truthy value to skip them.
  • TAG_NSFW: By default, NSFW posts are tagged nsfw. Set to an empty string to suppress this.
  • FILTER_SPOILER: As FILTER_NSFW for posts marked as spoilers.
  • TAG_SPOILER: As TAG_NSFW for posts marked as spoilers.
  • MIN_SCORE: Skip posts with scores below this number.
  • TAGS: Comma-separated list of tags to add to all items.
  • AUTHOR_BLOCKLIST: Comma-separated list of usernames. Posts by these users will be skipped.
  • NO_VIDEO: Set to a truthy value to filter out v.redd.it links.

intake-hackernews

A feed source that returns stories from Hacker News.

Supported env:

  • FETCH_COUNT: Number of posts to fetch from the front page. Default 30.
  • REQUEST_RETRY: Attempt count for fetching posts. Retries are done with exponential backoff.
  • MIN_SCORE: Skip stories with scores below this number.

intake-echo

A feed source that echoes a message. This is useful with cron support to create recurring reminders.

Supported env:

  • TITLE: The title of the item.
  • BODY: The body of the item.
  • UNIQUE: If set to a truthy value, the item id will be the hash of the title, so the same item will be generated until the message is changed.