User Guide
FeedElity is a personal-first, video-oriented RSS client for following creators across YouTube, Odysee, and PeerTube. This guide covers everything you need to browse content, manage subscriptions, organize playlists, and control your viewing experience.
The Three-Column Layout
FeedElity uses a high-density three-column interface designed for power users who want to scan and consume content quickly:
Left Column — Creators & Sources
Browse all creators in the global catalog or view only your subscribed creators. Search by name. Select a creator to load their content in the middle column. Use the add-source controls to subscribe to new channels.
Middle Column — Content List
Shows content items for the selected creator, subscription, or favorites view. Each item displays the title, thumbnail, duration, source indicator, and status badges (opened, played, favorite). Use search, filters, and the hide-played toggle to narrow the list.
Right Column — Content Viewer
Displays the selected content item with full metadata, video playback, description, source switching, and action buttons. Switch between available playback sources (YouTube embed, Odysee native, PeerTube embed) when multiple sources exist.
Browsing the Catalog
FeedElity maintains a global catalog of creators, feeds, and content items from all sources. You do not need an account to browse. Anonymous users can explore the full catalog, select creators, and view content details including playback.
- Creator list — Click any creator in the left column to load their content. The search field filters creators by display name.
- Content list — Browse content items for the selected creator. Items show title, thumbnail, publication date, duration, and source type indicator.
- Content detail — Click a content item to open it in the viewer. See full description, metadata, and playback options.
Subscription actions (subscribe, unsubscribe), status tracking (opened, played, favorite), and playlist management require a signed-in account. These actions are hidden or gated for anonymous browsers.
Managing Sources
Adding a Source
Paste a URL into the add-source input. FeedElity supports the following source types and URL forms:
- YouTube — Channel URLs and channel RSS feed URLs. The adapter normalizes channel identity, video metadata, thumbnails, and produces privacy-friendly no-cookie embed links for playback.
- Odysee — Channel URLs and RSS feed URLs. The adapter normalizes channel identity, video metadata, duration, and provides native media URLs for playback.
- PeerTube — Video URLs, channel URLs, and account URLs from any PeerTube instance. The adapter uses instance APIs for metadata and provides embed URLs for playback.
FeedElity auto-detects the source type from the URL. You do not need to specify whether a URL is YouTube, Odysee, or PeerTube.
Batch Adding Sources
Add multiple source URLs at once using the batch-add feature. Paste one URL per line. FeedElity processes each URL independently and reports per-item results: successful additions, duplicates (already subscribed), and failures with reasons.
Refreshing Content
FeedElity uses manual refresh. There is no automatic background refresh in the current version. You control when content is updated:
Normal Refresh
Respects stored refresh cadence metadata. Only fetches feeds that are due for a refresh based on their schedule. Use this for routine checks. Available for all sources or for a single creator.
Force Refresh
Bypasses cadence metadata and fetches all feeds regardless of when they were last refreshed. Use this when you know new content is available or want a complete update.
- Refresh all — Triggers a refresh across every feed known to the server (the whole catalog), not just the creators you subscribe to.
- Refresh creator— Refreshes only the feeds belonging to a specific creator, using the per-creator refresh control in the left column.
Refresh status and results are visible after each run. The report shows how many feeds were requested, skipped, succeeded, and failed, along with counts of discovered, created, and updated content items.
Feed Health
The feed health dashboard shows how every feed is behaving: each feed's current success or failure streak and the last time a refresh succeeded. Feeds that keep failing can be unsubscribed in bulk straight from the dashboard, so a broken source does not sit in your subscriptions forever.
Subscriptions & Favorites
Subscriptions
Subscribing to a creator adds them to your personal subscription list. Your subscriptions appear in the left column, letting you quickly access content from creators you follow. Subscriptions are private to your account.
- Subscribe — Click the subscribe action on a creator card or from the content viewer.
- Unsubscribe — Remove a creator from your subscriptions. This does not delete the creator or their content from the global catalog.
- Subscribed content— Switch to the subscribed-content view to see items from all your subscribed creators in a unified list.
- Unread counts — Each subscribed creator shows an unread badge for items you have not opened yet. Mark a single creator as read from their controls, or use the mark-all-as-read action to clear every unread badge at once.
Favorites
Mark any content item as a favorite. Favorites are a separate status from opened and played, so you can favorite an item you want to return to without marking it as watched.
- Toggle favorite— Click the favorite action from the content list or content viewer. The toggle adds or removes the favorite status.
- Favorites view— Access the favorites-only view from the sidebar to browse all your favorited content in one place.
Creator Collections
Collections let you group creators into your own sets, independent of your subscriptions. The Collections tab in the left column lets you create, rename, and delete collections and add or remove creators from them. Selecting a collection focuses on its creators' content.
Content Status & History
FeedElity tracks three content statuses per item, scoped to your account:
| Status | Description |
|---|---|
| opened | You selected and viewed the content item. Set automatically when you open an item in the viewer, or toggle manually. |
| played | You watched or consumed the content. Set automatically when playback nears the end (within 30 seconds of the end or past 90% of the video) or ends, and still toggleable manually from the content list or viewer. |
| favorite | You bookmarked the item for later. Independent of opened and played status. |
Use the hide played toggle in the content list to filter out items you have already marked as played. Status badges are displayed on each content item in the list.
Your watch history is browsable: the library includes Opened and Played views that list the items you have opened or completed, so you can catch up on what you started or re-find what you watched.
Content Playback
FeedElity is video-oriented. When you select a content item, the viewer shows the video player along with metadata and actions.
- YouTube — Plays through a privacy-friendly YouTube no-cookie iframe embed. No tracking cookies from YouTube are set.
- Odysee — Plays through native media URLs provided by the Odysee RSS feed.
- PeerTube — Plays through PeerTube embed URLs from the originating instance.
Some content items have multiple sources (for example, a video mirrored on both YouTube and Odysee). When multiple sources are available, use the source switcher in the viewer to change the playback source without leaving the content item.
- Resume playback — Your playback position is saved automatically. Reopening a partially watched video offers to resume where you left off ("Resume at ...").
- Copy stream URL — A button in the viewer copies the selected source's media URL to the clipboard, handy for opening a video in an external player.
Keyboard Shortcuts
The app shell is fully navigable from the keyboard. Shortcuts are disabled while you are typing in a text field or a dialog is open.
| Key | Action |
|---|---|
| j / k | Move the selection down / up in the content list. |
| Enter | Open the selected content item in the viewer. |
| / | Focus the creator search field. |
| Escape | Clear the current selection or close the open panel. |
| f | Toggle favorite on the selected content item. |
| g then l | Go to the Library. |
| g then c | Go to the Catalog. |
Playlists
Create playlists to organize content items into curated collections. Playlists are private to your account.
- Create a playlist— Provide a name and optional description. Choose a sort mode: manual ordering, publication date ascending or descending, or added-date ascending or descending.
- Add items — Add content items to a playlist from the content list or viewer. Items are appended at the end in manual sort mode.
- Reorder items — Move items up or down with the reorder buttons when the playlist uses manual sort mode.
- Remove items — Remove individual items from a playlist. This does not delete the content item from the catalog.
- Edit or delete — Rename a playlist, change its description or sort mode, or delete the entire playlist.
Account & Settings
Creating an Account
FeedElity uses local email and password authentication. Sign up with your email and a password. No external identity provider is required. Your account data (subscriptions, favorites, history, playlists, settings) is private and scoped to your user.
Settings
Account settings let you configure app-level preferences. Settings are stored as key-value pairs scoped to your account. Changes are saved immediately and persist across sessions.
Layout preferences — the hide-played toggle, creator and content source filters, pane widths, and your view mode — are kept on your device and also persist across sessions.
Export & Import
Settings can export all of your user data — subscriptions, history, playlists, collections, and settings — to a single JSON file, and import it back. Importing the same file again is safe: the round-trip is idempotent, so repeated imports do not create duplicates.
Migrated Accounts
If you imported data from the previous version of FeedElity, your account will require a new password setup on first login. This is a security measure — old password hashes are not carried over during migration. Once you set a new password, your account works normally with all imported subscriptions, favorites, history, and playlists preserved.