# St (Suckless Terminal)
## Xresources live-reload demo
## Dependencies
```
# Void
xbps-install libXft-devel libX11-devel harfbuzz-devel libXext-devel libXrender-devel libXinerama-devel
# Debian (and ubuntu probably)
apt install build-essential libxft-dev libharfbuzz-dev libgd-dev
# Nix
nix develop github:siduck/st
# Arch
pacman -S gd
# Fedora (or Red-Hat based)
dnf install gd-devel libXft-devel
# SUSE (or openSUSE)
zypper in -t pattern devel_basis
zypper in gd-devel libXft-devel harfbuzz-devel
# Install font-symbola and libXft-bgra
```
## Try it out!
Before you install st on your system, you might want to try it out first.
To do so, simply run (requires [Nix](https://nixos.org/download.html))
`nix run github:siduck/st`
## Install
```
git clone https://github.com/siduck/st.git
cd st
(change the compiler if you cant use c99 to compile: sed -i 's/^#\ CC\ =\ c99/CC=gcc/' config.mk)
sudo make install
xrdb merge pathToXresourcesFile
```
(note : put the xrdb merge command in your wm's autostart or similar)
### Using Nix flakes
Add `st.url = "github:siduck/st";` to your inputs and install `inputs.st.packages."${system}".st-snazzy` package
## Fonts
- Install JetbrainsMono Mono Nerd Font or any nerd font from [here](https://www.nerdfonts.com/font-downloads)
## Patches:
- Ligatures
- sixel (check sixel branch)
- scrollback
- Clipboard
- Alpha(Transparency)
- Boxdraw
- patch_column ( doesnt cut text while resizing)
- font2
- right click paste
- st desktop entry
- newterm
- anygeometry
- xresources
- sync patch ( Better draw timing to reduce flicker/tearing and improve animation smoothness )
- live reload ( change colors/fonts on the fly )
and more...
## Xresources live-reload
```
# make an alias for this command
alias rel="xrdb merge pathToXresourcesFile && kill -USR1 $(pidof st)"
```
## Ram usage comparison with other terminals and speed test
( note : This benchmark was done on my low-end machine which has a pentium cpu so the speed results might vary )
## Default Keybindings
ctrl + shift + c Copyyou can change all of these in config.h
ctrl + shift + v Paste
right click on the terminal ( will paste the copied thing ) (Zoom) alt + comma Zoom in
alt + . Zoom out
alt + g Reset Zoom
(Transparency) alt + s Increase Transparency
alt + a Decrease Transparency
alt + m Reset Transparency
alt + k scroll down alt + j scroll up mod + shift + enter open a new terminal with same cwd ( current working directory )