st/README.md

76 lines
2.6 KiB
Markdown
Raw Normal View History

2018-01-21 20:15:29 +01:00
# Luke's build of st - the simple (suckless) terminal
2009-05-10 14:17:09 +02:00
2018-08-02 06:11:23 +02:00
The [suckless terminal (st)](https://st.suckless.org/) with some additional features:
2009-05-10 14:17:09 +02:00
+ Compatibility with `Xresources` and `pywal` for dynamic colors.
2018-12-03 20:53:04 +01:00
+ Default [gruvbox](https://github.com/morhetz/gruvbox) colors otherwise.
+ Transparency/alpha, which is also adjustable from `~/.Xresources`.
2018-12-03 20:53:04 +01:00
+ Default font is system "mono" at 16pt, meaning the font will match your system font.
+ Very useful keybinds including:
+ Copy is alt-c, paste is alt-v or alt-p pastes from primary selection
+ Zoom in/out or increase font size with Alt+Shift+k/j or u/d for larger intervals.
+ Hold alt and press either ↑/↓ or the vim keys k/j to move up/down in the terminal.
+ Shift+Mouse wheel do the same.
+ Alt-u and Alt-d scroll back/forward in history a page at a time.
+ Alt-PageUp and Alt-PageDown will do the same.
2018-07-07 09:28:01 +02:00
+ Vertcenter
+ Scrollback
2018-07-07 09:28:01 +02:00
+ updated to latest version 0.8.1
2018-07-07 09:28:01 +02:00
The following additional bindings were added before I forked this:
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.
2018-11-24 15:17:12 +01:00
On OpenBSD, be sure to edit `config.mk` first and remove `-lrt` from the
`$LIBS` before compiling.
## How to configure dynamically with Xresrouces
For many key variables, this build of `st` will look for X settings set in
either `~/.Xdefaults` or `~/.Xresources`. You must run `xrdb` on one of these
files to load the settings.
For example, you can define your desired fonts, transparency or colors:
```
*.font: Liberation Mono:pixelsize=12:antialias=true:autohint=true;
*.alpha: 150
*.color0: #111
...
```
The `alpha` value (for transparency) goes from `0` (transparent) to `255`
(opaque).
### Colors
To be clear about the color settings:
- This build will use colorized colors by default and as a fallback.
- If there are Xresources colors defined, those will take priority.
- But if `wal` has run in your session, its colors will take priority.
Note that when you run `wal`, it will negate the transparency of existing
windows, but new windows will continue with the previously defined
transparency.
## Contact
- Luke Smith <luke@lukesmith.xyz>
- [https://lukesmith.xyz](https://lukesmith.xyz)