Welcome to CommonRSS

1. Click Add Feed in the sidebar or go to /feeds/add
2. Paste the RSS or Atom feed URL
3. Your feed will appear in the sidebar with unread counts

OPML is a standard format for exporting and importing RSS subscriptions. If you're switching from another RSS reader, you can import all your feeds at once.

1. Export an OPML file from your current RSS reader
2. Go to Add Feed and click the Import OPML tab
3. Drag and drop your OPML file or click to browse
4. Review the import results showing successful and failed feeds

Export all your feed subscriptions as an OPML file for backup or to use with another RSS reader.

1. Go to Settings
2. Click Export OPML in the Feed Management section
3. A file named commonrss-subscriptions.opml will download

Connect your social accounts to share highlights directly to Bluesky or Mastodon. When you create a highlight, you can optionally post it to your connected accounts.

Connecting Accounts

1. Go to Settings
2. Find the Social Connections section
3. For Bluesky: Enter your handle and an App Password (not your main password)
4. For Mastodon: Enter your instance URL and an access token from your instance's Development settings

Sharing Highlights

• When creating a highlight: Select text, add a comment, then toggle the platforms you want to share to before saving
• From the social feed: Click the share button on any existing highlight to post it

• All Articles - See everything from all your feeds
• Individual Feeds - Click a feed in the sidebar to filter
• Mark as Read - Articles are marked read when you open them
• Mark All Read - Use the checkmark button in the sidebar

Press ? anywhere in the app to see all shortcuts.

Click the star icon on any article to save it. Access your starred articles from the Starred section in the sidebar. Starred articles are saved forever, even if you unsubscribe from the feed.

1. Select any text in an article
2. A popup will appear where you can add an optional comment
3. Click Save Highlight (comments up to 280 characters)
4. Your highlights appear at the bottom of the article

1. Go to Friends
2. Search for friends by name or email
3. Click Follow to see their highlights

The Social Feed shows highlights from people you follow. You can react to their highlights with emoji reactions. Click on any highlight to read the full article.

When you see a friend's highlight in your social feed, click the reaction button to add an emoji reaction. It's a quick way to show appreciation for something they found interesting.

Press Ctrl+K or click the search bar in the sidebar to search across all your articles and highlights. Search looks through article titles, content, excerpts, authors, highlight text, and comments.

The Discover page shows you:

• Popular Feeds - Most subscribed feeds across the community
• Trending This Week - Articles with the most highlights and comments
• Trending From Friends - Articles your friends are highlighting

Visit your Archive to see all your starred articles, highlights, and reading history in one place. Your interactions are preserved forever, even if you unsubscribe from a feed.