diff --git a/gitrepos/#public/st/README.md b/gitrepos/#public/st/README.md new file mode 100644 index 0000000..33ec73d --- /dev/null +++ b/gitrepos/#public/st/README.md @@ -0,0 +1,73 @@ +# Luke's build of st - the simple (suckless) terminal + +The [suckless terminal (st)](https://st.suckless.org/) with some additional features that make it literally the best terminal emulator ever: + +## Unique features (using dmenu) + ++ **follow urls** by pressing `alt-u` ++ **copy urls** in the same way with `alt-y` ++ **copy the output of commands** with `alt-o` + +## Bindings for + ++ **scrolling**: scroll up/down in history with `alt-k` and `alt-j`. ++ **zoom/change font size**: zoom in with `alt-shift-u` and out with `alt-shift-i`. ++ **copy text** with `alt-c`, **paste** is `alt-v` or `shift-insert` + +## Pretty stuff + ++ Compatibility with `Xresources` and `pywal` for dynamic colors. The `Xdefaults` file shows a usage example. ++ Default [gruvbox](https://github.com/morhetz/gruvbox) colors otherwise. ++ Transparency/alpha, which is also adjustable from your `Xresources`. ++ Default font is system "mono" at 16pt, meaning the font will match your system font. + +## Other st patches + ++ Vertcenter ++ Scrollback ++ font2 ++ updated to latest version 0.8.2 + +## Installation for newbs + +``` +git clone https://github.com/TiynGER/st +cd st +sudo make install +``` + +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. + +On OpenBSD, be sure to edit `config.mk` first and remove `-lrt` from the `$LIBS` before compiling. + +Be sure to have a composite manager (`xcompmgr`, `compton`, etc.) running if you want transparency. + +## How to configure dynamically with Xresources + +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: 0.9 +*.color0: #111 +... +``` + +The `alpha` value (for transparency) goes from `0` (transparent) to `1` (opaque). + +### Colors + +To be clear about the color settings: + +- This build will use gruvbox 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 + +- Marten Kante +- [https://martenkante.de](https://martenkante.de)