RSS Feed Reading Progress Badge

WHAT IT DOES

This script tracks your reading progress on RSS feed readers and news aggregator pages. It detects feed items on the page, tracks which ones you've scrolled past or read, and displays a progress badge showing total feed items and unread count. As you scroll down the page, items that have been scrolled past a configurable threshold are automatically marked as read. Read status is stored per feed item URL and persists across sessions, so you never lose track of what you've already read. The badge updates in real time as you scroll, and a detailed panel shows statistics and a list of recent items with their read status.

WHERE IT RUNS

The script works on any page that displays a list of feed items—RSS readers (Feedly, Inoreader, NewsBlur), news aggregators (Google News, Flipboard), blogrolls, and any site with a list of articles or posts. It automatically detects feed containers using common selectors and falls back to intelligent detection of link-rich content areas. The script runs on any website with a list of content items.

HOW TO USE

After installation, the script automatically detects feed items on the page. A badge appears in the corner showing unread/total items and progress percentage. As you scroll, items that pass the scroll threshold are marked as read. Use the panel to manually mark visible items as read, mark all items as read, refresh the feed list, or reset read status for the page. The panel also shows statistics (total, read, unread, progress) and a list of recent items with their read status. Configure settings including badge position, scroll threshold, progress display, colors, and whether to auto-detect feeds.

TECHNICAL MECHANISM

The script uses a multi-stage feed detection and progress tracking pipeline. First, it identifies the feed container using a prioritized selector strategy targeting common feed elements (.feed, .rss-feed, .feed-list, .entries, .items) with fallback to intelligent detection of the element containing the most links. Second, it extracts feed items by scanning for article-like elements with links, deduplicating by URL. Third, it tracks read status using a URL-based key stored in GM_setValue with per-domain scoping (rss_read_domain.com). Fourth, it marks items as read when they've been scrolled past the configured threshold percentage (default 60%) using getBoundingClientRect to calculate visible portion. Fifth, it updates the badge and panel in real time as the user scrolls. The badge displays unread count and progress with a color-coded bar, and the panel provides detailed statistics and item history.

THE PANEL

The settings panel is fully draggable and can be positioned anywhere on your screen. It automatically snaps to the nearest edge when released, keeping your workspace organized. The panel can be collapsed to a small bubble showing only a gear icon, and restored with a single click. Its position is remembered across page reloads using GM_setValue. The panel also responds to the Escape key, which instantly hides it until you click the bubble again. All settings are saved immediately when changed and persist across browser sessions.

PLEASE NOTE

This script requires the free BotGentz extension to run. Read status is stored per domain and item URL, not synchronized across devices. The script works best on standard feed layouts; complex or heavily dynamic pages may affect item detection. The script does not access, store, or transmit any personal data or browsing history. All feed tracking data is stored locally in your browser's userscript storage and never leaves your device.