aboutsummaryrefslogtreecommitdiffstats
path: root/README.org
blob: 01afd561e6578dd722e1d8a8424c7e2d8ce8354a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
#+TITLE: st - simple terminal

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

* 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 yout ~$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 [[patches][https://st.suckless.org/patches/]] page.

Here is my list:
- bold is not bright
- hidecursor
- keyboard select
- scrollback
- selectioncolors

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

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

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