Requirements

• Option 1. Download a Simple CLI

  npm install -g tabsync-cli 
  or
  pip install tabsync-cli (planned)

• Option 2. Download Desktop App

Sourcetabsync-desktop

• Mandatory: Download Extension

Sourcetabsync-extension

Quick Start CLI

tabsync

Once started, the CLI will:

• Detect your local IP address
• Launch a lightweight Express + WebSocket server
• Show a QR code - scan it on your mobile to open the TabSync page

What It Does

• The server (server.js) keeps track of all connected devices and their open tabs.
• Each device (desktop or mobile) connects via WebSocket and automatically syncs tab URLs.
• When a device goes offline for more than 5 minutes, it’s cleaned up automatically and disappears from the screen (may require refresh).
• You can also add URLs manually using the input box on the web page.

CLI Options

Usage: tabsync [options]

Options:
  --port <num>         Use a specific port instead of a random one
  --no-qr              Skip showing QR code
  --env <path>         Load environment variables from a custom file
  --version, --v       Show the current version
  --help               Show this help message

Examples:
  tabsync
  tabsync --port 3210
  tabsync --env .env
  tabsync --no-qr --port 8080

Web Interface

Open your browser at:

http://<your-local-ip>:port

You’ll see:

• A list of devices connected to your TabSync session
• Their open tabs as clickable links
• A field to add new URLs to sync instantly

The UI updates in real time whenever devices connect, disconnect (may require refresh), or share new tabs.

Screenshot

How It Works

• server.js -> Express + WebSocket server handling connections and sync
• index.html -> Frontend UI that receives live updates and renders devices/tabs
• CLI script -> Spawns the server, detects IP, and shows QR code for easy connection

Auto Cleanup

Inactive devices (no activity for 5 minutes) are automatically removed, and all clients update instantly (may require refresh).

Stop the Server

Press Ctrl + C in the terminal to shut it down gracefully.

Changelog

• For all the important changelog vist Changelog

Contributing

Contributions are always welcome!

See Contributing for ways to get started.

Please adhere to this project's Code Of Conduct.

Support

Support by donating to the project so I can buy a laptop.For issues, open a new issue.

License

This project is licensed under the MIT License