Skip to content

Configuration

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

Configuration

TERM39 stores configuration files in ~/.config/term39/.

Configuration Files

File Description
config.toml Application settings (auto-tiling, theme, etc.)
session.toml Saved session (window layouts, terminal content)
fb.toml Framebuffer settings (Linux only)

Application Settings

Settings are managed through the in-app settings window (press s):

Setting Description
Auto Tiling Automatically arrange windows when created/closed
Show Date Display date alongside time in clock
Theme Color theme selection
Background Desktop background character
Tint Terminal Apply theme colors to terminal output
Auto Save Save session on exit

Command-Line Options

Display Options

# Character set modes
term39 --ascii           # ASCII-compatible characters (+-|#)
term39 --single-line     # Single-line Unicode box characters (┌─┐│└┘)

# Themes
term39 --theme classic   # Default blue theme
term39 --theme dark      # Dark theme
term39 --theme dracu     # Dracula-inspired theme

# Terminal tinting
term39 --tint-terminal   # Apply theme colors to terminal output

Session Options

# Session management
term39 --no-restore      # Don't restore previous session
term39 --no-save         # Don't save session (disables auto-save)
term39 --no-exit         # Disable exit functionality

All Options

Option Description
--ascii Use ASCII characters instead of Unicode
--single-line Use single-line Unicode box characters
--theme <THEME> Set color theme
--tint-terminal Apply theme-based color tinting
--no-restore Don't restore previous session
--no-save Don't save session
--no-exit Disable exit functionality

Session Persistence

TERM39 automatically saves and restores your session:

What's Saved

  • Window positions and sizes
  • Window states (maximized, minimized)
  • Terminal content and scrollback
  • Working directories

Manual Save

Press Ctrl+S or F3 to manually save the current session.

Disable Auto-Save

# Via command line
term39 --no-save

# Via settings window
Press 's' → Toggle "Auto Save" off

Linux Console Options

See Framebuffer Mode for Linux-specific options:

term39 -f --fb-mode=80x25        # Framebuffer mode
term39 --swap-mouse-buttons      # Swap mouse buttons
term39 --mouse-sensitivity 1.5   # Adjust mouse speed

Environment Variables

TERM39 respects standard environment variables:

Variable Description
SHELL Default shell for new terminals
HOME Home directory for config storage
XDG_CONFIG_HOME Alternative config directory (defaults to ~/.config)

Example Configurations

Minimal/Kiosk Mode

term39 --no-exit --no-save --no-restore

Retro ASCII Mode

term39 --ascii --theme green_phosphor

High-Contrast Mode

term39 --theme monochrome --tint-terminal

See Also

Clone this wiki locally