Skip to content

A TrimUI Brick app that starts a browser-based remote terminal.

License

Notifications You must be signed in to change notification settings

josegonzalez/trimui-brick-remote-terminal-pak

Repository files navigation

trimui-brick-remote-terminal.pak

A TrimUI Brick app that starts a browser-based remote terminal.

Requirements

  • Docker (for building)

Building

make release

Installation

  1. Mount your TrimUI Brick SD card.
  2. Download the latest release from Github. It will be named Remote.Terminal.pak.zip.
  3. Copy the zip file to /Tools/tg3040/Remote Terminal.pak.zip.
  4. Extract the zip in place, then delete the zip file.
  5. Confirm that there is a /Tools/tg3040/Remote Terminal.pak/launch.sh file on your SD card.
  6. Unmount your SD Card and insert it into your TrimUI Brick.

Usage

Just launch it and access the device on port 8080.

daemon-mode

By default, remote-term runs as a foreground process, terminating on app exit. To run remote-term in daemon mode, create a file named daemon-mode in the pak folder. This will turn the app into a toggle for remote-term.

port

The terminal runs on port 8080. To utilize a different port, create a file named port in the pak folder with the port number you wish to run on.

shell

The terminal runs /bin/sh as the shell by default. To utilize a different shell, create a file named shell in the pak folder with the full path to the shell you wish to execute.