Skip to content

Platform Support

Alejandro Quintanar edited this page Nov 30, 2025 · 1 revision

Platform Support

TERM39 is designed to work across multiple platforms with platform-specific features where applicable.


Supported Platforms

Platform Status Notes
Linux (x86_64) Full Support Including framebuffer mode
Linux (ARM64) Full Support Including framebuffer mode
macOS (Intel) Full Support -
macOS (Apple Silicon) Full Support -
Windows (x86_64) Full Support -
Android/Termux Supported Requires --no-default-features

Feature Matrix

Feature Linux macOS Windows Android
Terminal Backend
Framebuffer Mode - - -
Console Mouse (raw) - - -
System Clipboard
Battery Indicator
Session Persistence
All Themes

Linux

Terminal Emulators

TERM39 works with any terminal emulator supporting:

  • ANSI escape sequences
  • Mouse input (SGR or legacy mode)
  • UTF-8 encoding (for Unicode mode)

Tested terminals:

  • GNOME Terminal
  • Konsole
  • Alacritty
  • kitty
  • xterm
  • st (suckless terminal)
  • Terminator

Console (TTY)

TERM39 can run directly on Linux console (TTY1-6) with:

  • Raw mouse input via /dev/input/mice or event devices
  • Optional framebuffer rendering for pixel-perfect display
# Switch to TTY
Ctrl+Alt+F2

# Run TERM39
term39

# With framebuffer
sudo term39 -f --fb-mode=80x25

Framebuffer Mode

Requires:

  • Physical console access (not SSH or terminal emulator)
  • /dev/fb0 access (root or video group)
  • Compiled with --features framebuffer-backend

See Framebuffer Mode for details.


macOS

Supported Versions

  • macOS 10.15 (Catalina) and later
  • Both Intel and Apple Silicon

Terminal.app

Works out of the box. For best experience:

  • Enable "Use Option as Meta key" in Preferences
  • Set terminal type to xterm-256color

iTerm2

Recommended for best compatibility:

  • Full true color support
  • Better mouse handling
  • GPU-accelerated rendering

Homebrew Installation

brew tap alejandroqh/term39
brew install term39

Windows

Supported Versions

  • Windows 10 (1903+) with Windows Terminal
  • Windows 11

Windows Terminal (Recommended)

Windows Terminal provides:

  • Full ANSI/VT support
  • True color rendering
  • Proper mouse handling

Legacy Console

The legacy Windows console (cmd.exe, PowerShell ISE) has limited support. Use Windows Terminal for best results.

Installation

Download the installer or ZIP from Releases.


Android/Termux

Requirements

  • Termux app
  • Rust toolchain (pkg install rust)

Installation

cargo install term39 --no-default-features

Limitations

  • No system clipboard integration
  • Internal clipboard buffer only
  • Touch input mapped to mouse events

Keyboard

Use Termux's extra keys row or an external keyboard for function keys.


SSH/Remote Sessions

TERM39 works over SSH with some considerations:

Recommendations

  1. Use a modern terminal emulator locally
  2. Ensure TERM is set appropriately:
    export TERM=xterm-256color
  3. Enable mouse forwarding if needed

Limitations

  • Framebuffer mode not available (requires local console)
  • Performance depends on connection latency
  • Some mouse features may not work depending on terminal

Docker/Containers

TERM39 can run in containers with terminal access:

FROM rust:latest
RUN cargo install term39 --no-default-features --features clipboard
CMD ["term39"]

Run with:

docker run -it --rm term39-image

See Also

Clone this wiki locally