#+TITLE: st - simple terminal

* Introduction
This is my personnal build of *[[https://st.suckless.org/][st]]*,
a simple terminal emulator for X which sucks less. I've applied some
patches.

* Depedencies
- A C compiler
- ~xorg~
- ~make~

* Installation
To install this build, run these commands:

#+BEGIN_SRC shell
$ git clone git://jozanleclerc.xyz/jozan/st.git
$ cd st
$ make
# make install clean
#+END_SRC

It is installed by default in the user ~/usr/local/bin~ directory but you can
change it to something that matches more your ~$PATH~ by editing the ~PREFIX~
variable in ~config.mk~.

* Applied patches
You can find a list of patches and check what those I've applied are
doing on *st*'s [[https://st.suckless.org/patches/][patches]] page.

Here is my list:
- /anygeometry/
- /bold is not bright/
- /clipboard/
- /externalpipe/
- /hidecursor/
- /keyboard select/
- /scrollback/

* Settings
Most settings are done by editing ~config.h~ and recompiling.

** Fonts
The default font is part of the
[[https://github.com/ryanoasis/nerd-fonts][Nerd Fonts]] collection but can
be changed at ~config.h:19~.

** Colors
The colorscheme used in this build is ~gruvbox dark hard~, you can change it
at ~config.h:110~.