Releases: gorlix/sn-tcp-tunnel
Release list
v1.2.0
v1.2.0 — Tunnel actually works now (permission fix) + polish
Bug fix (important)
- The tunnel's outbound relay leg was silently blocked by the host's
plugin permission system: it opened the listen socket fine, but any
connection to the target host/port failed with "no NETWORK
permission". The plugin never declared or requested Internet access.
Declared plugin.permission.INTERNET in PluginConfig.json and the
plugin now requests it on first tunnel start, with a clear error if
denied. Confirmed end-to-end on real hardware: relay connects and
serves traffic correctly.
Polish
- Plugin list now shows a real icon instead of the default
create-react-native-library puzzle piece placeholder. - Plugin name in Settings > Apps > Plugins is now "TCP Tunnel" instead
of the raw "sn-tcp-tunnel" package slug.
Maintenance
- Updated react (patch), jest, prettier, markdownlint-cli, and
sn-plugin-lib to their latest compatible versions.
- Download sn-tcp-tunnel.snplg from the assets below
- Copy it to your Supernote → PluginHost → Install Plugin
- Tap the TCP Tunnel button and start sharing over USB
Full usage guide in the README.
v1.1.1
v1.1.1 — File Transfer port fix
Bug fix
- The "Browse & Access" preset used port 8081, which was wrong. The
Supernote's official File Transfer service actually listens on 8089,
so the preset never reached it. Renamed to "File Transfer" and set
the correct port 8089.
Note
- The official File Transfer service is tunneled correctly through the
TCP relay as well. It works — though the practical use is unclear,
since the Supernote is already connected to the PC over USB when the
tunnel is running.
v1.1.0
sn-tcp-tunnel v1.1.0 — Automatic IP detection
This release makes the plugin dramatically easier to use: you no longer
need to know or type your Supernote's IP address.
A new Auto IP toggle (ON by default) lets the plugin detect the
device's WiFi IP automatically when you start the tunnel. Just pick the
port you want to expose — the plugin handles the rest.
- Auto IP ON (default): the plugin resolves the device WiFi IP at
start time and relays to it. The detected IP is shown in both the
control panel and the settings screen so you always know what's in use.
Falls back to 127.0.0.1 if WiFi is unavailable. - Auto IP OFF: a manual host field reappears for advanced setups
(e.g. relaying to a Tailscale or external address).
This means a teacher or presenter can simply:
- Plug in the USB cable
- Pick the port (8080 Screen Mirroring / 8081 Browse & Access)
- Tap Start — no IP to look up, no configuration
- Fixed transparent/invisible plugin view (pluginKey now matches the
registered component name) - Replaced native Switch with a custom toggle that renders reliably on
the Supernote e-ink display - Settings screen now scrolls, so all options are reachable
- Restored content padding (UI was flush against the left edge)
- Detected IP displayed in multiple places for clarity
- Download
sn-tcp-tunnel.snplgfrom the assets below - Copy it to your Supernote → PluginHost → Install Plugin
- Tap the TCP Tunnel button and start sharing over USB
Full usage guide in the README.
v1.0.0
Initial Public Release — sn-TCP-Tunnel v1.0.0
Use your Supernote's Screen Mirroring and Browse & Access over USB — no Wi-Fi needed!
Sometimes Wi-Fi is unreliable, slow, or restricted (like on campus or in an office). This plugin allows you to seamlessly use your Supernote's built-in web features through a simple USB cable.
✨ Key Features
- USB Connection Only: Share your screen or browse files without relying on a Wi-Fi network.
- Simple Control Panel: Easily start or stop the connection right from your Supernote. The app will show you the exact command you need to type on your computer—no guesswork required.
- Fully Customizable: Comes with ready-to-use presets for both Screen Mirroring (port 8080) and Browse & Access (port 8081).
- Smart Error Handling: If a connection gets stuck in the background, the plugin automatically detects and fixes it. If it can't, it gives you clear instructions on what to do next.
- Native Look & Feel: Designed to perfectly match the Supernote UI. It supports both English and Italian, automatically adapting to your system language.
🚀 How to Install and Use
- Download the
snTCPTunnel.snplgfile from the assets below. - Copy it to your Supernote and install it via the PluginHost app.
- Tap the TCP Tunnel button on your Supernote toolbar and hit "Start".
- Connect your Supernote to your PC via USB.
- Open your computer's terminal/command prompt and type the exact
adbcommand shown on your Supernote screen (usuallyadb forward tcp:8080 tcp:8888). - Open your PC browser and go to `