Skip to content

Repository files navigation

Tablet VNC Manager

Shell Tauri React Rust License

Tablet VNC Manager hero

Tablet VNC Manager is a Linux desktop toolkit for using tablets as Hyprland extended displays over VNC. It combines shell launchers for the actual runtime with a Tauri/React control panel for saved device profiles, display placement, and two-slot live orchestration.

Highlights

  • Two runtime slots: USB tether mode and IP mode.
  • Saved device library for more devices than the two live outputs the current runtime can run at once.
  • Drag-based layout manager for left, right, top, and bottom tablet placement.
  • Profile persistence under $XDG_STATE_HOME or $HOME/.local/state.
  • Tauri backend writes sanitized profile files and starts/stops the shell runtime scripts.
  • Old one-off NotebookLM/browser automation research artifacts were removed from the publishable repo.

Current Scope

This is a Linux/Hyprland project. The code can be cloned and built on a normal development machine with Node.js and Rust, but the runtime commands need a Wayland/Hyprland session plus VNC/display tooling.

Expected runtime tools:

  • hyprctl
  • wayvnc
  • wlr-randr
  • adb for USB-tether workflows
  • notify-send for desktop notifications

Repository Layout

scripts/
  tablet-vnc              USB/tether runtime profile
  tablet-vnc-top          IP/top-display runtime profile
  tablet-vnc-stack        Starts/stops both runtime slots and opens the GUI
tablet-vnc-gui-tauri-react-2026-03-23/
  src/                    React manager UI
  src-tauri/              Rust/Tauri command backend
tablet-vnc-gui-2026-03-21/
  tablet_vnc_gui.py       Older GTK control panel kept for reference/fallback
assets/
  hero.png                README hero image

Quick Start

Build the Tauri manager:

git clone https://github.com/dakshdoesdev/Laptop-Tablet-VNC-.git
cd Laptop-Tablet-VNC-/tablet-vnc-gui-tauri-react-2026-03-23
npm install
npm run build
cargo check --manifest-path src-tauri/Cargo.toml

Install the runtime scripts into your user bin directory:

cd ..
install -Dm755 scripts/tablet-vnc "$HOME/.local/bin/tablet-vnc"
install -Dm755 scripts/tablet-vnc-top "$HOME/.local/bin/tablet-vnc-top"
install -Dm755 scripts/tablet-vnc-stack "$HOME/.local/bin/tablet-vnc-stack"

Open the manager during development:

cd tablet-vnc-gui-tauri-react-2026-03-23
npm run tauri dev

Use the CLI stack directly:

tablet-vnc-stack status
tablet-vnc-stack gui
tablet-vnc-stack start
tablet-vnc-stack stop

Configuration

The manager writes profile files here by default:

$XDG_STATE_HOME/tablet-vnc/profile.env
$XDG_STATE_HOME/tablet-vnc-top/profile.env
$XDG_STATE_HOME/tablet-vnc-manager/devices.json

If XDG_STATE_HOME is not set, the scripts use $HOME/.local/state.

The stack launcher also supports overrides:

TABLET_VNC_LEFT_SCRIPT=/path/to/tablet-vnc \
TABLET_VNC_TOP_SCRIPT=/path/to/tablet-vnc-top \
TABLET_VNC_GUI_TAURI=/path/to/tablet-vnc-manager \
tablet-vnc-stack gui

Verification

Checked before publishing:

  • bash -n for all shell launchers.
  • npm install
  • npm run build
  • npm audit --audit-level=high
  • cargo check for the Tauri backend.
  • npm run tauri build for Linux .deb and .rpm bundles.
  • Repo scan for local machine paths and private runtime data references.

Notes

The app is intentionally local-first. Keep private runtime data outside this repository.

About

Linux/Hyprland toolkit and Tauri manager for using tablets as VNC extended displays.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages