Skip to content

Releases: gorlix/sn-tcp-tunnel

v1.2.0

Choose a tag to compare

@github-actions github-actions released this 02 Sep 08:51
4f0cf3a

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.
  1. Download sn-tcp-tunnel.snplg from the assets below
  2. Copy it to your Supernote → PluginHost → Install Plugin
  3. Tap the TCP Tunnel button and start sharing over USB

Full usage guide in the README.

v1.1.1

Choose a tag to compare

@github-actions github-actions released this 06 Jun 11:03
4535d06

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

Choose a tag to compare

@github-actions github-actions released this 06 Jun 07:16
23145fe

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:

  1. Plug in the USB cable
  2. Pick the port (8080 Screen Mirroring / 8081 Browse & Access)
  3. 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
  1. Download sn-tcp-tunnel.snplg from the assets below
  2. Copy it to your Supernote → PluginHost → Install Plugin
  3. Tap the TCP Tunnel button and start sharing over USB

Full usage guide in the README.

v1.0.0

Choose a tag to compare

@github-actions github-actions released this 05 Jun 21:23
d0de6f7

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

  1. Download the snTCPTunnel.snplg file from the assets below.
  2. Copy it to your Supernote and install it via the PluginHost app.
  3. Tap the TCP Tunnel button on your Supernote toolbar and hit "Start".
  4. Connect your Supernote to your PC via USB.
  5. Open your computer's terminal/command prompt and type the exact adb command shown on your Supernote screen (usually adb forward tcp:8080 tcp:8888).
  6. Open your PC browser and go to `