#terminal #x11 #shell #command #emulator

app termal-term

Termal is a terminal emulator for x11

1 unstable release

0.1.0 Apr 28, 2024

#157 in GUI

Download history 78/week @ 2024-04-22 44/week @ 2024-04-29

122 downloads per month

MIT/Apache

265KB
2K SLoC

Termal - A hackable terminal emulator with unicode support

[!WARNING] Termal is still in very early development so feel free to report bugs.

About

Termal is not supposed to be the fastest terminal emulator nor the best, termal is supposed to be your own terminal emulator.

Features

  • Full vt10x support
  • C0 control codes
  • Custom CSI parser
  • utf-8 support
  • copy/paste

Installation

Termal is installed from source with build.sh.

Prequesites

In order to build termal you will need to have the rust toolchain installed and available to build.sh.

On arch-based distros the rust toolchain can be installed with the rust package.

Configuration

Termal looks for a configuration file at $HOME/.config/termal/config.toml.

[!WARNING] The default configuration assumes you have the Iosevka Nerd Font installed.

The default configuration is as following.

######################
#    Termal Config   #
######################

tab_max = 400
scrollback = 400


######################
#  Colors and looks  #
######################

# IMPORTANT: make sure to replace $HOME with your home path
bell = "$HOME/.config/termal/pluh.wav"

# xft font syntax: https://keithp.com/keithp/talks/xtc2001/xft.pdf
font = "Iosevka Nerd Font Mono:style=Regular"

foreground = "d7-e0-da"
background = "0d-16-17"

colors = [
    "0a-10-11", # black
    "e7-4b-4b", # red
    "5e-c5-87", # green
    "de-b2-6a", # brown
    "65-9b-db", # blue
    "c1-67-d9", # magneta
    "5f-d1-d5", # cyan
    "d7-e0-da", # white
]

Common Issues

If you get the following error message it's most likely caused by a invalid path for the bell inside your configuration. [+] failed to create terminal: No such file or directory (os error 2)

Todos

  • fix visual disturbances as a result of dirty xft rendering

License

Termal is licensed under the MIT license.

Dependencies

~7–45MB
~699K SLoC