Skip to content

About

A native GUI app for connecting your MuOS devices to your [Tailscale](https://tailscale.com) tailnet. Browse your peers, send/receive files via Taildrop, and authenticate via QR code — all from your handheld.

Topics

Resources

Contributing

Stars

5 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

Rt:Tailscale-M - Tailscale for muOS Andromeda

muOS Andromeda LÖVE 11.5 Tailscale Tests MIT

Run Tailscale on your muOS handheld - and control it with the D-pad.

Rt:Tailscale-M installs the official Tailscale client as a background service and gives you a graphical app, styled after the Tailscale web client, to log in (by scanning a QR code), see your tailnet, pick an exit node, flip settings and open a web panel for your phone. It is the muOS Andromeda sibling of Rt:Tailscale-K (Knulli) and the successor of Shin RtTailscale, by SPDW Factory.

Install · Screenshots · Controls · How it works · Status · Developer guide


✨ Features

🔌 Official Tailscale The real arm64 tailscale/tailscaled, not a re-implementation. One tap updates them.
🚀 Starts at boot A muOS user init script, installed and switched on for you. A watchdog restarts anything that dies.
📱 Log in by QR code No typing on a D-pad: scan the code with your phone.
🌍 Exit nodes Highlight a device, press the button, your traffic leaves through it.
🎮 Made for the D-pad Larger type, icon-only button legend, light and dark theme, quit with MENU+START.
🌐 Web panel PIN-protected panel (status, peers, Taildrop, Serve/Funnel, CLI console) on port 8077.
📥 Taildrop Files sent to the device land in RtTailscale/taildrop/.
🧰 Works without TUN No /dev/net/tun in your kernel? It falls back to userspace networking by itself.
📦 Self-contained Ships its own LÖVE 11.5 runtime (muOS has none), like other muOS LÖVE apps. Nothing to install first.
🔁 Switch painlessly Installs over Shin RtTailscale keeping your login; Take over another Tailscale install imports the identity of another app and disables its init script.

🖼 What it looks like

Everything below is rendered by the real UI code (tests/fixtures provide the data), light and dark.


Status - connect / disconnect with one button

Devices - ping, use as exit node

Settings - service and Tailscale options

Log in - scan with your phone

Panel - PIN and QR for the web panel

System - start, stop, update, diagnostics

Dark status

Dark devices

Diagnostics

🎮 Controls

Controller legend

The app shows physical button artwork in the footer rather than a text-only key list. Face-button names follow the Nintendo layout used by many Anbernic handhelds (A = right, B = bottom); change Settings → Nintendo button layout when using a different arrangement.

  • MENU + START (MENU is SDL's guide button): quit to the muOS frontend, matching Andromeda's application shortcut.
  • SELECT + START remains available as a compatibility fallback.
  • L1 / R1 and L2 / R2: previous / next tab.
  • D-pad: move through rows; A: confirm; B: back; X: use the highlighted device as exit node; Y: refresh.

Keyboard (PC testing): arrows, Enter = A, Esc = B, X/Y = face actions, Q/E = L/R, Ctrl+Q = quit.

📦 Install

  1. Download RtTailscale-M-<version>.muxapp from Releases (or build it).
  2. Copy it to the ARCHIVE folder of an SD card (e.g. /mnt/mmc/ARCHIVE/) and open muOS → Applications → Archive Manager, or unzip it into MUOS/application/ so you get MUOS/application/RtTailscale/.
  3. Open Applications → Tailscale.
  4. Status → Log in, scan the QR code, approve the device in your Tailscale account.
  5. Settings → Start at boot → on. The app creates the init script and switches on muOS's Advanced settings → User Init Scripts if it was off.

Note

Already using Shin RtTailscale? Install over it: same folder, your login and settings stay. Using another Tailscale app? Open System → Take over another Tailscale install.

Use it without the app (SSH only)
cd /mnt/mmc/MUOS/application/RtTailscale        # or wherever the app lives
./rt install            # permissions, folders
./rt start              # daemon + watchdog + panel
./ts up                 # log in (prints a link)
./rt autostart on       # start at boot
./rt doctor             # health check
./rt                    # all commands

./ts is the real tailscale CLI bound to this daemon.

🌐 Web panel

http://<device-ip>:8077 on your LAN, or http://<tailscale-ip>:8077 from anywhere on your tailnet (preferred: nothing to open on your router). The PIN is on the app's Panel tab (with a QR code of the address) or ./rt pin. HMAC-signed session, HttpOnly/SameSite=Strict cookie, lock-out after 5 wrong PINs.

🧩 How it works

flowchart LR
  M[muOS<br/>Applications] --> L[mux_launch.sh]
  L --> UI[LÖVE app<br/>.game/main.lua]
  L -- rt ensure --> RT[rt]
  UI -- background jobs --> RT
  B[muOS boot<br/>init/rttailscale.sh] --> RT
  RT --> D[tailscaled]
  RT --> W[watchdog]
  RT --> P[web panel<br/>:8077]
  RT --> T[Taildrop receiver]
  UI -->|ts status --json| D
  Phone[phone / PC] --> P
Loading
RtTailscale/                 (MUOS/application/RtTailscale)
├── mux_launch.sh  mux_lang.ini  glyph/      what muOS needs to list and start the app
├── rt  watchdog  ts         service manager, watchdog, CLI wrapper
├── bin/                     tailscale + tailscaled (arm64)
├── state/                   node identity (keep it private)
├── config/rt.conf           settings (also editable in the web panel)
├── taildrop/                received files
├── panel/                   web panel (python3, standard library only)
└── .game/                   LÖVE app: main.lua, Inter font, icons drawn in code, bin/love + libs.aarch64

Outside that folder the app only creates init/rttailscale.sh (when you enable start at boot) and temporary files in /tmp. Uninstall: Settings → Start at boot → off, System → Stop everything, delete the folder.

🛠 Build from source

./build.sh                       # downloads Tailscale (arm64) and the pinned LÖVE runtime, builds dist/*.muxapp
./build.sh --bin-dir DIR         # use Tailscale binaries you already have
./build.sh --full-love           # ship the whole 73 MB runtime instead of the 9 libraries love needs (6 MB)
./build.sh --no-bin              # tiny archive; the app downloads Tailscale on first start
python3 tools/make_assets.py     # regenerate logo, banner, hero and the app icon

📦 Archive size

The trimmed .muxapp is ~39 MB, almost entirely the two statically linked Go binaries bin/tailscale and bin/tailscaled (~50–60 MB uncompressed). The bundled LÖVE runtime and its 9 needed libraries are only ~8 MB of that; the --full-love variant adds ~67 MB of unused Qt6/ICU/Kerberos libraries on top.

✅ Status - what is tested

Area How
Service stack with the real arm64 Tailscale 1.104.2 (under qemu-user) 21 integration checks: start, NeedsLogin, userspace mode, watchdog restart, deliberate stop, panel login, boot via the init script, taking over another app
Parsing of real tailscale status --json / debug prefs against output of the real daemon
QR encoder byte-identical to python-qrcode (v1-10) and decoded by OpenCV
Real muOS Andromeda device launch, controller, init folder, User Init Scripts, QR login, binary update — all verified on hardware
UI rendered headless with LÖVE (12 screens); the login flow starts a real tailscale up process
Packaging pinned LÖVE runtime (commit + SHA-256), executable bits, layout checked
tests/run_all.sh                                  # lint, Lua tests, QR verification, UI render
RT_BIN_DIR=/path/to/arm64/bins tests/run_all.sh   # + integration tests with the real binaries

Note

Verified on a real muOS Andromeda device — launch via SETUP_APP, the bundled LÖVE runtime, the controller mapping, the init folder /run/muos/storage/init, the User Init Scripts setting, the QR login against Tailscale's servers and the binary-update download have all been exercised on hardware. If a build does not start on your device, see docs/TROUBLESHOOTING.md; --full-love is a fallback, not the default.

📚 Documentation

Developing programs for muOS · Architecture · Troubleshooting · Changelog · Contributing · Third-party notices

🙏 Credits and legal

  • Tailscale and the Tailscale logo are trademarks of Tailscale Inc. The nine-dot mark appears unmodified (app icon and header) to show that this app works with Tailscale; this project is not affiliated with or endorsed by Tailscale Inc. or MustardOS. Colours and the Inter typeface follow the Tailscale web client (BSD-3-Clause).
  • Inter © The Inter Project Authors, SIL Open Font License 1.1.
  • Built with LÖVE; the aarch64 runtime is the one used by existing muOS LÖVE apps. Launcher conventions follow the MustardOS application format.
  • The project logo (an "M" made of dots) is original artwork. Code: MIT, © SPDW Factory.

Security notes

  • The web panel binds to PANEL_BIND (default 0.0.0.0, i.e. all interfaces). For LAN-only access set PANEL_BIND=127.0.0.1 in config/rt.conf and reach it via SSH tunnel or tailscale serve.
  • The panel uses plain HTTP on the LAN. Do not expose the port to the Internet. Use tailscale serve for remote access — it terminates TLS and authenticates via Tailscale identities.
  • PIN is 8 digits for new installs. Rotate it with ./rt pin new (also invalidates all sessions).
  • The CLI console blocks ssh, web, serve and funnel because those are interactive or have dedicated validated endpoints.

📚 Practical Wiki

The GitHub Wiki is the quick-use handbook; the tracked source lives in wiki-source/. Start with the Wiki Home, Installation, Controls or Troubleshooting. Maintainers can publish reviewed pages with sh tools/publish_wiki.sh.

About

A native GUI app for connecting your MuOS devices to your [Tailscale](https://tailscale.com) tailnet. Browse your peers, send/receive files via Taildrop, and authenticate via QR code — all from your handheld.

Topics

Resources

Contributing

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages