Bluesky Feed Algorithm Toggle

WHAT IT DOES

Bluesky Feed Algorithm Toggle gives you instant control over how your Bluesky feed is sorted. It detects the current feed mode and provides a toggle switch to switch between the chronological "Following" feed and the algorithmic "Discover" feed. On page load and after feed updates, the script automatically switches to your preferred default mode—so you never have to manually click the feed button again. A panel overlay displays the current feed mode, lets you change your default preference, and provides buttons to manually switch feeds at any time. An optional floating indicator shows your current feed mode in the corner of the screen. This gives you complete control over your Bluesky experience, letting you choose between seeing posts in the order they were published (Following) or discovering new content through the algorithm (Discover).

WHERE IT RUNS

This script runs exclusively on Bluesky web pages (*.bsky.app/*). It operates entirely within your browser tab, detecting and interacting with the page's feed navigation elements and buttons. The script cannot access other tabs, your browsing history, bookmarks, downloads, or any data outside the current page. All settings—including default feed mode, auto-switch preference, indicator visibility, re-apply on scroll preference, and refresh interval—are stored locally using GM_setValue and never transmitted anywhere.

HOW TO USE

After installing with the BotGentz extension, choose your default feed mode from the dropdown: "Following (Chronological)" or "Discover (Algorithmic)". Enable "Auto-switch Feed Mode" to automatically set your feed to the default mode on page load and after any feed updates. The panel shows your current feed mode with a status indicator. Click "Switch to Following" or "Switch to Discover" to manually change feeds at any time. Toggle the floating indicator on or off to see your current mode in the corner of the screen. Enable "Re-apply on Feed Scroll" to re-check and re-apply your default mode as you scroll through the feed. Adjust the refresh interval to control how often the script checks the feed mode (default 10 seconds).

THE REAL MECHANISM

The script detects the current feed mode by scanning the page for feed navigation elements—tab buttons, navigation items, or link elements that contain "Following" or "Discover" text. It checks for active indicators like aria-selected attributes, active class states, or data-selected attributes. If the URL path contains "/following" or "/discover", that's also used as a fallback detection. To switch feeds, the script simulates a click on the corresponding button element. If the button isn't found (due to UI changes), the script falls back to URL navigation by updating the page's URL path. A MutationObserver watches the feed container for new content and re-applies the default mode when new posts are loaded. A scroll listener checks the mode as the user scrolls, and a periodic refresh interval provides a fallback to catch any mode changes. The floating indicator updates dynamically to reflect the current state. All DOM interactions use safe methods with no innerHTML from untrusted content.

THE PANEL

The Bluesky Feed panel is a BGPanel component that you can drag anywhere on your screen by its header. It snaps to the nearest edge when released, keeping your workspace organized. The panel collapses to a small bubble showing only the emoji icon when minimised—click to expand it again. You can resize the panel horizontally to see more of the settings. Press the Escape key to collapse the panel instantly. Your panel position and size are saved per-site.

PLEASE NOTE

This script requires the free BotGentz browser extension to function. Bluesky regularly updates its web interface, which may change the structure of feed buttons and navigation elements—the script may require updates to maintain compatibility. The script relies on detecting feed buttons by their text content ("Following" and "Discover"); if Bluesky changes these labels, the script may not work as expected. The URL navigation fallback may cause a page reload when switching feeds if the buttons aren't found. The script never reads or writes password fields, hidden inputs, or file inputs. It stores only your default feed mode, auto-switch preference, indicator visibility, re-apply on scroll preference, and refresh interval locally. No feed data, account information, or personal information is ever collected, transmitted, or shared.