diff options
| author | Mohamed Bassem <me@mbassem.com> | 2025-12-22 15:46:32 +0200 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2025-12-22 13:46:32 +0000 |
| commit | 903aa5e96c6252121c69c2a740400415c66d71f3 (patch) | |
| tree | 79abdacb92eba963493978f122356bda7d2207a6 /docs | |
| parent | dc8ab86279e302c9865fb5d5b670a62280b097c6 (diff) | |
| download | karakeep-903aa5e96c6252121c69c2a740400415c66d71f3.tar.zst | |
docs: add RSS feeds integration documentation (#2288)
* docs: add RSS feeds integration documentation
Add detailed documentation for RSS feed integration covering:
- Publishing lists as RSS feeds with authentication tokens
- Consuming external RSS feeds with automatic bookmark creation
- Feed scheduling and management features
- Configuration options and troubleshooting guides
- API access and best practices
* changes
---------
Co-authored-by: Claude <noreply@anthropic.com>
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/docs/05-integrations/06-rss-feeds.md | 50 |
1 files changed, 50 insertions, 0 deletions
diff --git a/docs/docs/05-integrations/06-rss-feeds.md b/docs/docs/05-integrations/06-rss-feeds.md new file mode 100644 index 00000000..e633813c --- /dev/null +++ b/docs/docs/05-integrations/06-rss-feeds.md @@ -0,0 +1,50 @@ +# RSS Feeds + +Karakeep offers RSS feed integration, allowing you to both consume RSS feeds from external sources and publish your lists as RSS feeds for others to subscribe to. + +## Publishing RSS Feeds + +You can publish any of your lists as an RSS feed, making it easy to share your bookmarks with others or integrate them into RSS readers. + +### Enabling RSS for a List + +1. Navigate to one of your lists +2. Click on the list settings (three dots menu) +3. Toggle the "RSS Feed" switch to enable it +4. Copy the generated RSS feed URL + +### What Gets Published + +RSS feeds include: +- **Links**: Bookmarks of type "link" with their URL, title, description, and author +- **Assets**: Uploaded files (PDFs, images) are included with a link to view them +- **Tags**: Bookmark tags are exported as RSS categories +- **Dates**: The bookmark creation date is used as the publication date + +Note: Text notes are not included in RSS feeds as they don't have an associated URL. + +### Security Considerations + +- Each RSS feed requires a unique token for access +- Tokens can be regenerated at any time, which will invalidate the old URL +- Disabling RSS for a list immediately revokes access + +## Consuming RSS Feeds + +Karakeep can automatically monitor RSS feeds and create bookmarks from new entries, making it perfect for staying up to date with blogs, news sites, and other content sources. + +### Adding an RSS Feed + +1. Go to **Settings** → **RSS Feeds** +2. Click **Add Feed** +3. Enter the feed details: + - **Name**: A friendly name for the feed + - **URL**: The RSS/Atom feed URL + - **Enabled**: Toggle to enable/disable the feed + - **Import Tags**: Enable to import RSS categories as bookmark tags + +### How It Works + +- Karakeep checks enabled RSS feeds **every hour** +- New entries are automatically created as bookmarks +- Duplicate entries are automatically detected and skipped |
