st/README.md

55 lines
2.2 KiB
Markdown
Raw Normal View History

2018-01-21 20:15:29 +01:00
# Luke's build of st - the simple (suckless) terminal
Forked from [https://github.com/shiva/st](https://github.com/shiva/st) for simplicity's sake, which is the [suckless terminal (st)](https://st.suckless.org/) with some patches added:
2009-05-10 14:17:09 +02:00
2018-03-11 03:52:41 +01:00
+ transparency
+ copy to clipboard (alt-shift-c)
+ Solarized colors (light and dark toggleable)
2018-01-18 08:01:16 +01:00
+ vertcenter
+ scrollback with keyboard
+ scrollback with mouse
+ updated to latest version 0.8.1
2009-05-10 14:17:09 +02:00
2018-01-21 20:15:29 +01:00
## My own additions
2009-05-10 14:17:09 +02:00
+ Default font is system "mono" at 14pt, meaning the font will match your system font.
+ Hold alt and press either ↑/↓ or the vim keys k/j to move up/down in the terminal.
+ Alt-u and Alt-d scroll back/foward in history a page at a time.
+ Alt-PageUp and Alt-PageDown scroll back/foward in history a page at a time.
+ Transparency with solarized colors by default.
2018-01-18 16:51:08 +01:00
## Terminal-specific mappings
(Additions before me.)
2018-01-18 16:51:08 +01:00
+ Scroll through history -- Shift+PageUp/PageDown or Shift+Mouse wheel
+ Increase/decrease font size -- Shift+Alt+PageUp/PageDown
2018-01-22 01:42:14 +01:00
+ Return to default font size -- Shift+Alt+Home
2018-01-18 16:51:08 +01:00
+ Paste -- Shift+Insert
## Installation for newbs
```
make
sudo make install
```
2018-02-06 05:33:39 +01:00
Obviously, `make` is required to build. `fontconfig` is required for the default build, since it asks `fontconfig` for your system monospace font. It might be obvious, but `libX11` and `libXft` are required as well. Chances are, you have all of this installed already.
## Custom changes (`config.def.h` or `config.h`)
By default, the terminal is transparent with a blackish background. There's a patch file `solarized-alpha-toggle.patch` which you can use to remove the transparency and give it a typical deep, dark blue solarized background. Just run:
```
patch < solarized-alpha-toggle.patch
```
Then, run `make` & `sudo make install` again to install the new build. You make reverse the solarized background by running the same command as above, but giving `patch` the `-R` option as well.
## Explore `config.h`
+ Change `colorname[]` array values (88 LOC), default colours are solarized.
+ Numbers of 0 - 15 are usual terminal colors. Change them to your liking.
2018-04-25 22:58:56 +02:00
+ Change `bg` to your desired terminal background color.
+ Change `fg` to your desired terminal foreground color.
+ Change `cursor` to your desired terminal cursor color.