Skip to content

A browser extension that tracks your web navigation like Git history — with dwell-aware snapshots, redirect graphs, and local-first privacy.

License

Notifications You must be signed in to change notification settings

premkumar127001/URLVersionControlSystem

Repository files navigation

🌐 URL Version Control System (UVCS)

License: MIT

A browser extension that tracks your web navigation like Git history.
Every page visit becomes a node with timestamps, redirects, dwell time, and snapshots (visual + textual).
Rewind your browsing, branch into new flows, and export your history as structured datasets.


✨ Features

  • ⏱️ Dwell-aware tracking
    Only creates a node when you actually spend time on a page (default ≥10s).

  • 🔗 Full navigation graph
    Records redirect chains, SPA route changes, reloads, back/forward as edges.

  • 🖼️ Snapshots

    • Visual (JPEG viewport capture, 80% quality)
    • Textual (HTML/DOM with scripts stripped, safe for viewing)
    • Manual capture button always available
  • 🧭 Git-like navigation

    • Prev/Next buttons traverse node history
    • Right-click menu: Open, Copy, View Snapshot, Download
  • 🔒 Privacy & safety first

    • No incognito snapshots (unless explicitly enabled)
    • Ignore list support (skip sensitive domains)
    • Snapshots sanitized + sandboxed in viewer
    • Local-only storage (IndexedDB)
  • 📦 Export / Import

    • Export as JSON (visits + edges)
    • Export as ZIP (JSON + HTML + JPEGs)
    • Re-import datasets and browse them like live history
    • (Future: optional Node.js backend for disk-based archival)

📸 Screenshots

Popup UI Right-Click Menu
Popup UI Right Click

🚀 Installation (Developer Mode)

  • Clone this repo:

    git clone https://github.com/premkumar127001/URLVersionControlSystem.git
    
  • Open your browser’s extensions page:

  • Chrome / Edge / Brave: chrome://extensions

  • Firefox: about:debugging#/runtime/this-firefox

  • Enable Developer Mode.

  • Click Load unpacked (Chrome/Edge/Brave) or Load Temporary Add-on (Firefox), then select the project folder.

  • You’ll see the 🌐 UVCS icon in your toolbar.


🤝 Contributing

  • Pull requests welcome! Ideas, feedback, and bug reports appreciated.
  • Open an issue or submit a PR.

📜 License


⭐ Show Support

  • If you like this project, give it a star ⭐ on GitHub — it helps others discover it!

About

A browser extension that tracks your web navigation like Git history — with dwell-aware snapshots, redirect graphs, and local-first privacy.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published