Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/beangreen247/st

My config of the simple terminal (st) from suckless.org (https://st.suckless.org/)
https://github.com/beangreen247/st

arch beangreen beangreen247 build config debian font linux opensource priority scrollback st sucless terminal transparency ubuntu xresources

Last synced: 7 days ago
JSON representation

My config of the simple terminal (st) from suckless.org (https://st.suckless.org/)

Awesome Lists containing this project

README

        

### NOTE: Stopped using st, currently using rxvt. [My rxvt config](https://github.com/BeanGreen247/My-rxvt-config)
# BeanGreen247'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-l`
+ **copy urls** in the same way with `alt-y`
+ **copy the output of commands** with `alt-o`

## Bindings for

+ **scrollback** with `alt-↑/↓` or `alt-pageup/down` or `shift` while scrolling the mouse
+ OR **vim-bindings**: scroll up/down in history with `alt-k` and `alt-j`. Faster with `alt-u`/`alt-d`.
+ **zoom/change font size**: same bindings as above, but holding down shift as well. `alt-home` returns to default
+ **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
Make sure to install these packages if you are on Ubuntu.
```
sudo apt-get install libx11-dev libxext-dev libxft-dev fonts-inconsolata ubuntu-make
```
If on Arch Linux make sure to install base-devel.
```
sudo pacman -S base-devel
```
If on Debian 10 make sure to install these packages
```
sudo apt-get install libx11-dev libxext-dev libxft-dev fonts-inconsolata make
```
## Instalation steps
```
git clone https://github.com/BeanGreen247/st
cd st
sudo make install
sudo cp Xresources ~/.Xresources && sudo cp Xdefaults ~/.Xdefaults && sudo cp bashrc ~/.bashrc
sudo xrdb -merge ~/.Xresources
```
## Uninstall steps
```
cd st
sudo make uninstall
```
## Some information
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.

### How to apply changes
sudo xrdb -merge ~/.Xresources

## Contact
All my contacts are on my website
- [https://beangreen247.github.io/](https://beangreen247.github.io/)