RepoPicks Radar

Updated every day around 23:30 UTC

Guides

satmux

Th0rgal/satmuxReviewed by AI

Checked by RepoPicks Radar on

What is satmux?

satmux is a single Python file that speeds up airplane Wi-Fi on satellite connections (Inmarsat GX, Viasat, Panasonic, SITA). It keeps twelve connections open to a small Linux server you rent near the satellite's ground station, so web pages, APIs, git and the gh command stop timing out on the plane's own proxy. It is for technical users: you rent a server, copy the file over by SSH, start it on both ends and run a script that changes your macOS proxy settings. Pure Python 3 with no extra packages. It does not get you past the paid Wi-Fi login.

How easy is it to install satmux?

D · terminal, several tools or a specific graphics card · macOS

  • macOS D
  • Linux D

There is no installer or release: on macOS, the best-documented side, you clone the repository, generate a key with openssl, rent a Linux VM, copy the file over with scp, start it over SSH as root and run the client plus a proxy script. Linux works the same way but has no helper script to switch the system proxy on and off, so you would wire that up yourself.

Coming soon: install in 1 click with the RepoPicks app.

satmux on GitHub

Stars
1,030on Nov 10, 2026
Downloads
—all releases
Growth
+1,030stars in 3 days

Stars over time

1,0001,0101,0201,0301,040 Nov 9Nov 10 1,0001,0101,0201,0301,040 Nov 9Nov 10

Facts

Runs on
macOS, Linux
You need to install
Python
Disk space
not determined
Accounts or keys
None
Cost
Free · The program is free (MIT). The README says you also need to rent a Linux VM, "$0.01–$0.03/h", and an already paid inflight Wi-Fi session.
License
MIT (Permissive)
Last change on GitHub
Nov 7, 2026

satmux risk signals (6)

  • Attentionroutes around onboard network controls

    README.md: it keeps "12 pre-warmed TCP connections open to a Linux VM near the satellite ground station, bypassing the cabin :443 proxy and onboard DNS" on port 8444 because "Non-443 TCP ports pass through untouched". It uses your paid lease and the README says "it does not bypass captive portals", but going around the operator's own equipment can conflict with the airline's or provider's terms of use.

    AI review

  • Attentionhand rolled encryption

    README.md describes the link to the ground server as "an encrypted (BLAKE2b-512 stream + HMAC-SHA256) request frame" with a shared key you create yourself (`openssl rand -hex 32 > mux.psk`). That is a home-made scheme built on hash functions rather than a reviewed protocol like TLS, and all ground-fetch traffic passes through it in plain form on the server.

    AI review

  • Attentionchanges system and tool settings

    README.md: `bin/satmux-macos on` sets the system Wi-Fi proxy and, on teardown, "Restores macOS Wi-Fi proxy settings, ~/.gitconfig, gh http_unix_socket, and launchctl env vars". If you forget `bin/satmux-macos off` after landing, your Mac, git and gh keep pointing at a server that is gone.

    AI review

  • Attentionground server sees decrypted traffic

    README.md: in the "1-RTT ground fetch (127.0.0.1:8081)" mode "The ground VM performs DNS, verified TLS 1.3, and HTTP redirects on fiber" and "compresses plaintext responses with zlib", so for that mode the rented server, not your laptop, holds the TLS connection and the page contents. The SOCKS5 mode keeps TLS end to end.

    AI review

  • Infoserver started as root

    README.md Setup step 2 copies the script to the VM and runs it as root: `ssh root@<SERVER_IP> 'nohup env SATMUX_PSK=$(cat /root/mux.psk) python3 /root/satmux.py server --port 8444 ...'`, with TCP port 8444 open to the internet.

    AI review

  • Infovery new repository

    Created 2026-11-07 with its last commit the same day, already 922 stars, no releases, no tests directory and 0 open issues; the whole program is one file, satmux.py.

    AI review

Evidence is shown in its original language.

What Radar could not check about satmux

  • Whether the speed numbers in the README (3.6x faster, fixed timeouts) happen on other airlines, satellites or seats
  • Whether the home-made key-based encryption of the carrier link holds up, since no review or test suite is in the repository
  • What satmux.py actually sends to the ground server, and whether it logs requests there
  • Whether `bin/satmux-macos off` restores every macOS, git and gh setting it changed
  • The real cost of the rented VM and of the inflight Wi-Fi session on a given flight

Similar projects

The RepoPicks app

Coming soon: install in 1 click with the RepoPicks app.

Before you download

See the release page on GitHub