
BetterTerminal
Improves GTFO terminals with fuzzy search, pipelines, consumable tracking, localization, history, and configurable visuals.BetterTerminal
BetterTerminal expands GTFO's computer terminals with faster search, command pipelines, item tracking, configurable visuals, localization, and an extended command history.
Development disclosure: this project was created with assistance from OpenAI Codex. Design decisions, testing, packaging, and publication remain the author's responsibility.
Main features
- Fuzzy completion for commands and terminal item identifiers.
- Common-prefix completion or interactive arrow selection for ambiguous matches.
- Configurable Levenshtein distance.
- Searchable extended command history inspired by interactive shells.
LISTandQUERYsupport for ID ranges and result limits.- Typed pipelines with filtering, sorting, limiting, querying, pinging, marking, and text processing.
- Terminal registration,
QUERY,PING, and map markers for uncollected consumables. - Runtime settings through
CONFIG; most changes apply without restarting GTFO. - JSON localization with runtime language switching and custom language files.
- Configurable neofetch-style terminal status.
- Optional sleeping-terminal image and interactive background customization.
- Optional STFO scripting support through the separate STFO package.
Installation
Mod manager
Install BetterTerminal through r2modman or Thunderstore Mod Manager. Required dependencies are installed automatically.
Manual
Install the GTFO BepInEx pack, then place BetterTerminal.dll inside:
GTFO/BepInEx/plugins/BetterTerminal/
Getting started
Use these commands in any GTFO terminal:
COMMANDS
HELP
CONFIG
NEOFETCH
IDLESCREEN
Examples:
LIST MEDIPACK 3
LIST MEDIPACK_100-500
QUERY MEDIPACK 2
LIST GLOW_STICK | WHERE ZONE 49 | TAKE 1 | PING
LIST TOOL_REFILL | SORT ID | TAKE 3 | QUERY
COMMANDS | WHERE TEXT PING
Press Up on an empty command line to open searchable history. Type to narrow results, use Up/Down to select, then press Enter.
Consumable tracking
BetterTerminal can expose supported consumables that vanilla terminals do not normally list. Only items still present in the level are tracked. Supported categories include:
- Fog repellers
- C-Foam grenades
- Lock melters
- Glow sticks
- Long-range flashlights
- I2-LP syringes
- IIx syringes
- Explosive tripmines
- C-Foam tripmines
This feature is experimental and can be disabled per category through CONFIG or BetterTerminal.cfg.
Localization
Language files are created under:
BepInEx/config/BetterTerminal/Localization/
English and Spanish are included. template.json can be copied and translated to add another language. Change language at runtime:
CONFIG LANGUAGE EN
CONFIG LANGUAGE ES
CONFIG RELOAD
Terminal appearance
BetterTerminal exports replaceable files under:
BepInEx/config/BetterTerminal/neofetch.txt
BepInEx/config/BetterTerminal/idle-screen.png
Neofetch output is configurable. Sleeping-terminal replacement and interactive background are experimental and disabled by default. Image rotation, flipping, opacity, intensity, color behavior, and terminal text color can be adjusted through CONFIG or BetterTerminal.cfg.
Multiplayer and achievements
- BetterTerminal is client-side for its interface and convenience features.
- Other players do not need it for you to use local terminal improvements.
- GTFO does not officially support mods; use a modded profile and private sessions.
- BetterTerminal does not intentionally disable Steam achievements.
- Tracking and pipeline features may expose information unavailable through vanilla terminal commands.
STFO compatibility
STFO is optional. BetterTerminal works without STFO. STFO requires BetterTerminal and declares it as a Thunderstore dependency.
Support
When reporting a problem, include:
BepInEx/LogOutput.log- BetterTerminal version
- GTFO rundown/version
- Command entered
- Relevant configuration values
- Reproduction steps
Issues and source: github.com/AlexanderMakunin/BetterTerminal
Credits
- Code and project: AlexanderMakunin
- Icon artwork: hawry
- AI-assisted development: OpenAI Codex
License
MIT License.