Skip to content

Installation

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

Installation

This guide covers all installation methods for TERM39 across different platforms.

From crates.io (Recommended)

The easiest way to install TERM39 is via Cargo:

# Standard installation
cargo install term39

# Linux with framebuffer support
cargo install term39 --features framebuffer-backend

Requirements: Rust 1.70+ (Install Rust)

Linux

Homebrew

brew tap alejandroqh/term39
brew install term39

Fedora/RHEL (RPM)

Download from Releases:

sudo rpm -i term39-*-1.x86_64.rpm
# or
sudo dnf install term39-*-1.x86_64.rpm

Arch Linux (AUR)

# Binary package (faster)
yay -S term39-bin

# Build from source
yay -S term39

Tarball

tar xzf term39-v*-linux-x86_64.tar.gz
sudo mv term39 /usr/local/bin/

macOS

Homebrew (Recommended)

brew tap alejandroqh/term39
brew install term39

PKG Installer

Download from Releases:

  • Intel: term39-v*-macos-intel.pkg
  • Apple Silicon: term39-v*-macos-apple-silicon.pkg

Right-click the PKG file and select "Open" to install (macOS will show a security warning for unsigned apps).

DMG Installer

  • Intel: term39-v*-macos-intel.dmg
  • Apple Silicon: term39-v*-macos-apple-silicon.dmg

Right-click the DMG and select "Open", then drag the app to Applications.

Manual Installation

# Intel (x86_64)
tar xzf term39-v*-macos-64bit-x86-binary.tar.gz
sudo mv term39 /usr/local/bin/

# Apple Silicon (ARM64)
tar xzf term39-v*-macos-64bit-arm-binary.tar.gz
sudo mv term39 /usr/local/bin/

Windows

Download from Releases:

Installer (Recommended)

.\term39-v*-windows-x86_64-pc-windows-msvc-installer.exe

Portable (ZIP)

Expand-Archive term39-v*-windows-x86_64.zip
# Add to PATH (optional)
$env:Path += ";$PWD\term39-v*-windows-x86_64"

Android/Termux

For Android/Termux, build without the clipboard feature:

# Install Rust in Termux
pkg install rust

# Option 1: Install from crates.io
cargo install term39 --no-default-features

# Option 2: Build from source
git clone https://github.com/alejandroqh/term39.git
cd term39
cargo build --release --no-default-features
./target/release/term39

Note: --no-default-features disables system clipboard (not supported on Android). Copy/paste still works within the app using an internal buffer.

Building from Source

git clone https://github.com/alejandroqh/term39.git
cd term39

# Standard build
cargo build --release

# With framebuffer support (Linux only)
cargo build --release --features framebuffer-backend

# Run
./target/release/term39

Cargo Features

Feature Default Description
clipboard ON System clipboard integration (Ctrl+Shift+C/V)
framebuffer-backend ON (Linux) Direct /dev/fb0 rendering with DOS text modes
battery ON Battery status indicator in top bar

Build Combinations

# Full features (default)
cargo build --release

# Without framebuffer (Linux)
cargo build --release --no-default-features --features clipboard,battery

# Minimal (no clipboard, no framebuffer, no battery)
cargo build --release --no-default-features

# Android/Termux compatible
cargo build --release --no-default-features

Verifying Installation

term39 --version
term39 --help

Next Steps

Clone this wiki locally