No Description

Luke Smith 4a9b405ab0 Merge pull request #109 from sarpik/patch-1 6 years ago
.Xdefaults 7150fd6b35 Add background, foreground, cursor color example 6 years ago
.gitignore 30a6a001fe dumb 6 years ago
.travis.yml c50850028b Enable travis build 8 years ago
LICENSE 059106186b Revert "Update LICENSE" 7 years ago
Makefile 84d49f527d copy output of command with alt-o 6 years ago
PKGBUILD 19c95dd96c get version from config.mk 6 years ago
README.md 5728d045eb apply font2 patch 6 years ago
arg.h 0ad3d4eddf Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 7 years ago
config.h fb95bcb8a6 additional Xresources item compatible with font2 patch 6 years ago
config.mk 3cd91894ec Updated st to 0.8.2 6 years ago
st-copyout 1264ad0515 fix excessive slurping when prompt starts w/ space(s) 6 years ago
st.1 84d49f527d copy output of command with alt-o 6 years ago
st.c da13ef1246 external pipe eternal 6 years ago
st.h 3cd91894ec Updated st to 0.8.2 6 years ago
st.info 0ad3d4eddf Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. 7 years ago
win.h 3cd91894ec Updated st to 0.8.2 6 years ago
x.c 5728d045eb apply font2 patch 6 years ago

README.md

Luke's build of st - the simple (suckless) terminal

The suckless terminal (st) 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 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/LukeSmithxyz/st
cd st
sudo make install

Users of Arch-based distros can also install it from the AUR as st-luke-git.

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