Getting Started

Install Termina, open a tab, and learn the few keys that do most of the work.

Install

Download the package for your platform from the releases page. Each one bundles its own Java runtime, so you need nothing else. Verify a download against checksums_sha256.txt on the same page.

Homebrew and winget packages are planned but not published yet; releases are on GitHub only.

Linux

# Debian / Ubuntu
sudo apt install ./Termina-*.deb

# Fedora
sudo dnf install ./Termina-*.rpm

The packages add a launcher entry in the TerminalEmulator category, so Termina appears in the application menu and desktops can offer it where a terminal is wanted. See Command line.

macOS

Open the .dmg and drag Termina to Applications.

The app is not yet signed with an Apple Developer ID or notarized, so macOS refuses to open it the first time. Allow it once under System Settings → Privacy & Security → Open Anyway.

Windows

Run the .msi. It installs for the current user and adds a Start menu entry. The installer is unsigned, so SmartScreen may warn on the first run: choose More info → Run anyway.

First launch

The window opens with one tab running your login shell, started with -l so your profile sets up PATH the way it does in any other terminal. A few things to know:

• The tab strip is hidden while there is only one tab. Open a second and it appears; the row is given back to the terminal when you are down to one again.
• The menu bar is in the window on Linux and Windows, and in the screen menu bar on macOS.
• Right-click gives Copy, Paste, Select All, Clear Scrollback, zoom and Settings, unless a program running in the terminal has taken the mouse. Hold Shift to get the menu anyway.
• An update check asks GitHub for the newest release at most once a day. Settings → Advanced → Updates turns it off.

The keys to learn first

Termina’s own commands use Ctrl+Shift on Linux and Windows, because plain Ctrl+letter belongs to the shell: Ctrl+C is still SIGINT and Ctrl+W still deletes a word. On macOS they use Cmd.

You do not need to memorize more. The palette shows each command’s chord beside its name, and Help → Keyboard Shortcuts lists the rest, including the keys the terminal handles itself. The full table is on the Keybindings page.

Where settings live

Settings are one plain properties file, ~/.termina/settings.properties, on every platform (%USERPROFILE%\.termina on Windows). The Settings window writes it as you change things — there is no OK button — and the file is meant to be readable and editable by hand while Termina is closed. A value that does not parse falls back to its default, and numbers are clamped when they are read.

• Settings → Advanced → Files shows the path, and Help → About names it too.
• Another folder: start Termina with --config-dir DIR, or set TERMINA_CONFIG_DIR.
• The debug log (Settings → Advanced → Diagnostics) keeps this session’s warnings and errors and mirrors them to termina-session.log beside the settings file.
• Reset to Defaults asks first, and keeps your shell profiles.

Build from source

Termina needs JDK 25. Everything else, Maven included, is fetched by the wrapper.

git clone https://github.com/adriandeleon/Termina.git
cd Termina
./mvnw javafx:run      # run it
./mvnw test            # run the tests

To build a self-contained app image with its own runtime:

./mvnw clean -Pdist -DskipTests package     # => target/dist/Termina (Termina.app on macOS)

clean is required, not optional. jpackage builds only for the platform it runs on, so each platform’s image has to be built there.