Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/siduck/st
snazzy terminal (suckless + beautiful)
https://github.com/siduck/st
ligatures linux st suckless suckless-terminal terminal terminal-app terminal-emulator xresources
Last synced: 7 days ago
JSON representation
snazzy terminal (suckless + beautiful)
- Host: GitHub
- URL: https://github.com/siduck/st
- Owner: siduck
- License: mit
- Created: 2020-12-18T13:41:44.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2024-09-06T01:50:19.000Z (5 months ago)
- Last Synced: 2025-01-12T04:32:08.262Z (14 days ago)
- Topics: ligatures, linux, st, suckless, suckless-terminal, terminal, terminal-app, terminal-emulator, xresources
- Language: C
- Homepage:
- Size: 1.37 MB
- Stars: 655
- Watchers: 10
- Forks: 95
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - siduck/st - snazzy terminal (suckless + beautiful) (C)
- awesome-linux-ricing - st
README
# St (Suckless Terminal)
## Xresources live-reload demo
## Dependencies
```
# Void
xbps-install libXft-devel libX11-devel harfbuzz-devel libXext-devel libXrender-devel libXinerama-devel gd-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 )
- st-swapmouse
## 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 Copy
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 )
you can change all of these in config.h
## Themes/Fonts used
- ls-icons: https://github.com/Yash-Handa/logo-ls
- Xresources: onedark (just `xrdb merge xresourcesfile`, do this everytime you make any change to xresources file) from this repo itself.
- Font: JetbrainsMono Nerd Font + material design icon fonts
## Screenshots:
# Credits
- [live-reload](https://github.com/nimaipatel/st)
- [patch_column](https://github.com/nimaipatel/st/blob/all/patches/7672445bab01cb4e861651dc540566ac22e25812.diff)