Repository navigation
Releases: KORA612/Juggler
Release list
Juggler v1.6.2
Install on Windows (no Python, no internet needed)
- Download
Juggler-1.6.2-windows-x64.zipbelow. - Right-click it → Extract All…, open the folder, double-click
Install.bat. If you see "Windows protected your PC", click More info → Run anyway. - From then on, open Juggler from your Desktop or Start menu.
Linux: download the .tar.gz, extract it, run ./install.sh.
Upgrading from 1.5: extract over your old folder (or use a new one) and run Install.bat again. Your remembered configs carry over automatically.
What's new since 1.5.0
Connect in one click
- The system proxy is now a big Connect button at the top. A ring around it counts down to the next source fetch. "Connected" means Windows apps go through Juggler; until then the config shows as "Ready".
- Connect needs Juggler running on Windows. If you start it inside WSL, the button says so instead of just greying out.
Faster, more honest switching
- Use (or double-clicking a row) now switches at once. It used to wait for the background test that was running, often 10+ seconds. The same goes for automatic failover when the config in use stops working.
- Ping shows the latest measurement, so a test that just found 306 ms shows 306 ms. Ranking still uses the average.
- A speed test that couldn't download anything no longer counts as a passed check (it was lifting Health and delaying failover).
Site check
- Type a site under Working configs → + Check a site (e.g.
chatgpt.com). Every config is tried and the site gets its own tab with ✓ and response time, or ✗, per config. Working ones come first. The last 10 sites keep their tabs. These checks don't change Health or ranking.
Dashboard
- Health now includes how many sites load through a config (YouTube counts double). The YT/G/IG/TG chips are gone from the table.
- Ping and Speed are separate columns, shown as coloured numbers.
- Test and Test all show live progress on each row: Queued, Testing, ✓ 612 ms, ✗ Failed, ? No answer, or ! Offline when your own internet was down.
- × on every row (two clicks) removes a config. Share is an icon. Double-click a row to use it.
- The top card holds the source funnel and Safe mode as a shield toggle. The phone card has short setup steps, a sync status and one copy row per address.
- Background work is a quiet spinner in the corner instead of a pill that never went away.
Connection log
- Live log → ● Record connections (or start with
--log-connections) shows every new connection asdevice → site · route, e.g.this PC → www.instagram.com:443 · 🇩🇪 DE vless. Repeats are folded; it's kept in memory only and is off by default.
Known issue: if Windows shuts down, restarts or signs out while you're connected, or Juggler is ended from Task Manager, the Windows proxy can stay set until you start Juggler again. Start Juggler once, or turn off the proxy in Windows Settings → Network → Proxy. A self-healing fix is planned.
Files
| File | For |
|---|---|
Juggler-1.6.2-windows-x64.zip |
Windows 10/11, everything included (offline install) |
Juggler-1.6.2-linux-x64.tar.gz |
Linux x86_64 |
Juggler-chrome-extension-1.1.0.zip |
Chrome / Edge companion (unchanged) |
Public configs are strangers' servers: keep safe mode on, prefer HTTPS sites, and keep sensitive logins off them.
Juggler v1.5.0
Install on Windows (no Python, no internet needed)
- Download
Juggler-1.5.0-windows-x64.zipbelow. - Right-click it → Extract All…, open the folder, double-click
Install.bat. If you see "Windows protected your PC", click More info → Run anyway. - From then on, open Juggler from your Desktop or Start menu.
Linux: download the .tar.gz, extract it, run ./install.sh.
Upgrading from 1.4: extract over your old folder (or use a new one) and run Install.bat again. Your remembered configs carry over automatically.
What's new
Resilience: no more 15-minute reset
- Configs live in a scored pool that is checked continuously. Every check updates rolling scores, so one failed handshake never drops a working config. A config is retired only after repeated failures over 10+ minutes, and it's retried later (30 min, 2 h, 6 h, 24 h).
- The config in use is sticky. It's checked with real traffic every 20 s and switches only after two failures in a row, never just because a "faster" config appeared.
- Xray is updated live (configs added and removed without a restart), so videos and calls keep going.
- If your own internet drops, results are discarded instead of punishing every config.
Testing that matches real use
- Every config is checked with real requests to YouTube, Google, Instagram and Telegram (shown as chips). Ranking is reliability first, site coverage second, latency third, speed last.
- Failed checks are retried once with a longer timeout before they count. Fewer parallel handshakes.
- An hourly sample of retired configs measures the false-negative rate. Test bandwidth (MB/h) is shown in the dashboard: about 60–110 MB/h, down from up to ~900 MB/h.
Dashboard
- Test any config, Test all, + Add configs (paste links or a subscription; never auto-deleted), and a Share button (QR + copy).
- The Phone card lists every address of the PC and a
/pingpage to check reachability from the phone.
Also
- Memory: ~1 GB → ~340 MB peak (one shared TLS context instead of one per request).
- Tor fallback: bridge / lyrebird errors are summarised in one line instead of flooding the log.
- Chrome / Edge extension (
Juggler-chrome-extension-1.1.0.zip): routes only the browser through Juggler, shows the config in use, switch configs in one click. Install it fromchrome://extensions→ Developer mode → Load unpacked (pick theextensionfolder inside Juggler). - New icon.
Files
| File | For |
|---|---|
Juggler-1.5.0-windows-x64.zip |
Windows 10/11, everything included (offline install) |
Juggler-1.5.0-linux-x64.tar.gz |
Linux x86_64 |
Juggler-chrome-extension-1.1.0.zip |
Chrome / Edge companion (store-ready ZIP) |
Public configs are strangers' servers: keep safe mode on, prefer HTTPS sites, and keep sensitive logins off them.