📄 Project Overview

This UserScript is a browser enhancement tool designed to make Facebook usable without an account. Standard guest browsing is often frustrating due to constant "Log In" popups and broken navigation. This script automatically removes those annoying banners, fixes scrolling issues, and restores missing features (like Search), providing a smooth, app-like reading experience for public content.

⚠️ Compatibility & Known Limitations

🚨 Group Page (/groups/) Restrictions:
Facebook enforces strict server-side access controls on Group pages. In most cases, the server refuses to serve content to guest users immediately. This UserScript operates on the client side and cannot bypass server-side access denials.

🚨 Cloudflare WARP Incompatibility:
Users enabling Cloudflare WARP may encounter empty/blank feeds on Fan Pages. Facebook strictly limits guest access from these specific IP ranges.
Solution: Temporarily disable WARP if the feed fails to load.

Server-Side Rate Limiting:
Infinite scrolling is subject to server-side session limits. After extensive browsing, the API may stop returning new posts.
Solution: Close the window and open a new Incognito/Private window to reset the session.

💡 Pro Tip for uBlock Origin Users (Desktop)

While this script is fully standalone, using uBlock Origin (uBO) with specific custom filters is more efficient for hiding the initial login modal (CSS/Scriptlets execute faster than UserScripts).

facebook.com##+js(trusted-click-element, body > div[id^="mount"] #scrollview ~ div div[role="button"]:has(> div[data-visualcompletion="ignore"]) )
facebook.com##div[id^="mount"] div:not([id]):not([class]):not([style]) > div[data-nosnippet]
facebook.com##+js(aeld, scroll)
facebook.com##body > div[class*="__fb-light-mode"]
! click cookies
facebook.com##+js(trusted-click-element, [role="dialog"]:has([href="https://www.facebook.com/policies/cookies/"]) [aria-hidden="true"] + [aria-label][tabindex="0"], , 1000)

!   hide the fixed top-banner "send a message"
facebook.com##.rq0escxv.du4w35lb.rek2kq2y.lpgh02oy[style*="top: 56px;"]
!   un-fix the login banner (will scroll)
facebook.com##div[role="banner"] > *, div[role="banner"] > div:not(:first-child) > div > div:has([aria-label="Facebook"]):style( position: absolute !important; )
facebook.com##div[role="banner"] + div  div[style="top: 56px; z-index: 1;"]:style( position: static !important; )

📱 Mobile Web Support (m.facebook.com)

This UserScript is designed strictly for the Desktop Site. However, if you browse via m.facebook.com on mobile, you can use the following custom rules in AdGuard or uBlock Origin to hide login popups.

⚠️ Important Mobile Limitation:
These rules only hide the visual obstructions (banners/modals). Due to strict server-side blocks on the mobile site, infinite scrolling will stop working after loading exactly 9 posts (effectively leaving only 8 posts fully viewable). This cannot be fixed by client-side rules.

! Login prompt modal
m.facebook.com##div[role="dialog"][aria-modal="true"]:has(a[href*="/login/"], a[href*="/reg/"]):upward(div.fixed-container)

! Top login toolbar
m.facebook.com##div.fixed-container.top:has([role="button"][aria-label*="Log In"i], a[href*="/login/"])

! Fix page scrolling / Prevent scroll lock
m.facebook.com##body:remove-class(prevent-scrolling)
m.facebook.com##html, body:style(overflow: auto !important; scroll-behavior: auto !important;)

✨ Feature Specification

🛡️ Core Stability Enhancements

• Login Wall Removal: Detects and removes intrusive DOM elements including `Dialog` modals, sticky bottom banners, and full-screen overlays that interrupt content consumption.
• Deadlock Prevention (Media Isolation): Context: Facebook implements anti-guest logic that locks the main feed's loading mechanism if the internal media viewer (theater mode) is used excessively.
  Solution: The script intercepts click events on photos/videos and forces them to open in a New Tab. This isolates the media viewing session, preserving the integrity of the main feed's navigation.
• Scroll Position Restoration: Maintains the viewport context. When modals are closed, the script automatically restores the user's vertical scroll position, correcting the native behavior where the page often resets to the top (Y=0).
• Auto-Error Recovery: Automatically triggers a reload sequence when generic error pages ("Something went wrong") are detected.

🔍 Analysis & Transparency Tools

• ID Revealer: Extracts immutable identifiers (User ID and Page ID) by parsing the document's `meta` tags and JSON datasets. Accessible by clicking the Profile/Page title.
• Transparency Shortcuts: Injects floating buttons (bottom-left) for quick access to official transparency data:
  • Ad Library: Extracts the `asset_id` and navigates directly to the entity's active ads, bypassing the search interface and handling AdBlock warnings.
  • Page Transparency: Directly triggers the internal modal showing admin locations and history.
• Smart Permalink Copier: Appends a link button to posts. Uses a background worker to fetch the Canonical URL, ensuring the copied link is free of tracking parameters (e.g., `?set=`, `&__cft__`).

🧭 Navigation & Search

• Sequential Navigation: Implements keyboard-driven navigation (RSS-reader style).
  • Keyboard: J (Next) / K (Previous).
  • Mouse: Shift + Scroll Wheel.
  • UI: On-screen floating arrows.
• Contextual Search: Injects a toolbar containing a Google Site Search module restricted to the current Page or Group, providing a robust workaround for the lack of native search for guests.

🛠️ Interface Adjustments

• UI Cleanup: Hides non-functional interactive elements (e.g., "Like", "Comment" buttons) to reduce visual clutter.
• Post Numbering: Displays a sequence number on feed posts to track reading progress.
• Auto-Unmute: Automatically enables audio for video elements in the feed.
• Content Expansion: Automatically triggers "See more" on truncated text posts.

⚙️ Configuration

All features can be toggled via the Settings Panel.

1. Toolbar Icon: Click the Gear Icon (⚙️) on the injected toolbar (top-right).
2. Violentmonkey Menu: Open the extension menu and select "⚙️ Settings".

📚 Credits & Acknowledgements

This project incorporates logic and concepts derived from the following community resources:

• Login Wall Bypass Logic: Adapted from insights by u/AchernarB (uBlock Origin Team) on Reddit.
• Canonical ID Extraction: Regex patterns referenced from t-wy's Gist on GitHub.