FMHY Bookmarks Auto-Sync
Automated browser extension (Manifest V3) that keeps 25,000+ FreeMediaHeckYeah (FMHY) curated digital media bookmarks synchronized on your browser's Bookmarks Bar.
🌟 Overview
FMHY Bookmarks Auto-Sync is a lightweight, zero-dependency browser extension built for desktop browsers (Chrome, Edge, Brave, Opera, and Firefox). It monitors the official fmhy/bookmarks repository (or your personal GitHub fork) and automatically updates your browser's Bookmarks Bar whenever a new release commit lands on GitHub.
- Never miss updated links: Keeps your local browser bookmarks in lockstep with weekly FMHY releases.
- Top of the Bookmarks Bar: Automatically places the
FMHYbookmarks folder at Index 0 on your Bookmarks Bar for instant 1-click access. - Zero bloat: 100% Vanilla JavaScript without npm overhead or heavy dependencies.
- High Performance: Optimized with parallel batching for 1-second sync speeds on Firefox and Chromium.
Warning
🛡️ Repository Source & Security Disclaimer
Only sync from the official FMHY repository (fmhy/bookmarks) or your own personal fork that you control and manage yourself.
Do not trust or add untrusted third-party repositories. Third-party forks can be modified to include malicious, unvetted, or harmful links that are not present in the official FMHY collection. Always audit any custom fork before syncing it to your browser.
✨ Features
- ⚡ Automated GitHub Commit Tracking: Automatically monitors GitHub for new commits on browser startup and via 6-hour periodic alarms, updating bookmarks when upstream changes occur.
- 🔄 Manual "Sync Now" Trigger: Clicking Sync Now in the extension dashboard manually triggers an instant download and fresh bookmark tree synchronization on demand.
- 🎨 Apple Minimalist UI: System Default (Auto), Light & Dark Mode theme switcher, real-time commit telemetry, and custom vector icons.
- ⚙️ 2-Strategy Target Selector:
- Official FMHY Repository (
fmhy/bookmarks) — Track official community releases. - Personal Fork Repository — Track your custom personal GitHub fork and workflow runs (supports both public and private repos via optional GitHub PAT).
- Official FMHY Repository (
- 📁 Preset Selection: Choose between the Full Directory (~25,000+ links) or Starred-Only Collection (curated starred sites from the FMHY wiki).
- 🔒 Privacy-First: No external tracking, no login requirements, and zero data collection.
🚀 Installation & Usage
🌐 Chromium & Forks (Chrome, Edge, Brave, Opera)
- Download the latest
fmhy-bookmarks-extension-*.chromium.zippackage from Releases. - Extract the downloaded ZIP folder.
- Open
chrome://extensions/(oredge://extensions//brave://extensions/). - Enable Developer mode (top-right toggle).
- Click Load unpacked and select the extracted folder.
🛠️ Development / Build from Source
-
Clone the Repository:
git clone https://github.com/mian196/fmhy-bookmarks-extension.git cd fmhy-bookmarks-extension -
Build Packages:
python tools/build.py
Built packages will be generated inside the
dist/directory.
🤝 Contributing
Contributions are welcome! Please check out our Contributing Guide for instructions on local development, browser testing, and submitting pull requests.
📄 License
Distributed under the MIT License. See LICENSE for more information.