MiniScale

An unofficial Tailscale client for the Miyoo Mini Plus. It puts the device on your tailnet, so the other MiniDeck apps (and your own) can reach the servers on it, and it works like the Tailscale apps on a phone. Part of MiniDeck.

• Log in by scanning a QR code with your phone; connects by itself at boot.
• Devices with their addresses, connection type and ping; exit nodes; subnet routes; Tailscale DNS and SSH; shields up; several accounts.
• Taildrop: files sent to the Miyoo land in Media/Taildrop.
• A status icon in the Onion menu.
• Tailscale 1.104.4 built from source down to 18.9 MB, with its state on the card only encrypted, with a key kept in the device's own flash.

Using it

Open Apps > MiniScale and press A. L1/R1 switch between Devices, Exit node, Settings and Account; X connects and disconnects.

The device has no TUN interface, so Tailscale runs in userspace mode and other programs reach the tailnet through it: through its SOCKS5 proxy (127.0.0.1:1055) or HTTP proxy (127.0.0.1:1056), as the MiniDeck apps do, or through a port forward for apps that can't use a proxy. List forwards in App/MiniScale/forwards.conf:

8096  homeserver:8096      # Jellyfin

Settings that apply before the first login (the device name, Tailscale SSH, the proxy ports) are in App/MiniScale/miniscale.conf. With MiniScale on, the CLI is /tmp/miniscale/tailscale --socket=/tmp/miniscale/tailscaled.sock.

MiniScale is not made or supported by Tailscale Inc.

Install

• MiniMart: open MiniMart, then Apps > MiniScale. It checks the download and keeps your settings on updates.
• Zip: download miniscale-VERSION.zip from Releases, unzip it onto the root of the SD card, and restart.
• Every MiniDeck app at once: minideck-all.zip.

Requirements

A Miyoo Mini Plus on Onion OS 4.4, with Wi-Fi. A Tailscale account. Other devices and firmwares aren't supported.

Building

make check                     # vet, tests, scripts
make package VERSION=1.0.0     # dist/: the release zip, app.json, SHA256SUMS
make deploy HOST=root@miyoo    # build and copy to a device over SSH

Go runs in Docker unless you pass GO=go (Go 1.27). The interface, themes and networking come from the MiniDeck library; see its development notes and contributing guide.

License

MIT. Third-party components are listed in NOTICE. Not made by or affiliated with Miyoo.