st/README.md

# 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:

+ transparency
+ copy to clipboard
+ ~~Solarized colors (light and dark toggleable)~~ (Change to your own colors, see no value of toggle)
+ vertcenter
+ scrollback with keyboard
+ scrollback with mouse
+ updated to latest version 0.8.1

## My own additions

+ Default font is system "mono" at 14pt
+ Alt-k and Alt-j scroll back/foward in history one line at a time
+ Alt-u and Alt-d scroll back/foward in history a page at a time
+ Applied colors, insipred by Pop! OS colors.

## Terminal-specific mappings

(Additions before me.)

+ Scroll through history -- Shift+PageUp/PageDown or Shift+Mouse wheel
+ Increase/decrease font size -- Shift+Alt+PageUp/PageDown
+ Return to default font size -- Shift+Alt+Home
+ Paste -- Shift+Insert

## Installation for newbs

## Requirements for build

Install `base-devel` - compiler and stuff (most distros have).

Install code depndencies (voidlinux - most distro should have something similar) 

+ `fontconfig-devel` 
+ `libX11-devel` 
+ `libXft-devel`


```
make
sudo make install
```

## Custom changes (`config.def.h` or `config.h`)

+ change `alpha`
+ chnage colors in `colorname` added comments with numbers `0`-`15` colors and also `bg`, `fg` and `cursor` color.
readme changes 2018-01-21 19:15:29 +00:00			`# Luke's build of st - the simple (suckless) terminal`
backport of local changes 2009-05-10 12:17:09 +00:00
readme changes 2018-01-21 19:15:29 +00:00			`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:`
backport of local changes 2009-05-10 12:17:09 +00:00
transparency now default 2018-03-11 02:52:41 +00:00			`+ transparency`
readme now personalized 2018-01-18 07:01:16 +00:00			`+ copy to clipboard`
Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. Created run-patches.sh, runs all patches on clean st 0.8.1 code. All old patches remvoed, including trasparency diff. Not including solarized theme, don't see value of it. Commented colornames array with color indexs from 0-15, includes index 255, and afterwards bg, fg and cursor, change those for background, foreground and cursor color. Seems better than solarized toggle. Updated README. 2018-04-25 20:15:11 +00:00			`+ ~~Solarized colors (light and dark toggleable)~~ (Change to your own colors, see no value of toggle)`
readme now personalized 2018-01-18 07:01:16 +00:00			`+ vertcenter`
			`+ scrollback with keyboard`
			`+ scrollback with mouse`
Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. Created run-patches.sh, runs all patches on clean st 0.8.1 code. All old patches remvoed, including trasparency diff. Not including solarized theme, don't see value of it. Commented colornames array with color indexs from 0-15, includes index 255, and afterwards bg, fg and cursor, change those for background, foreground and cursor color. Seems better than solarized toggle. Updated README. 2018-04-25 20:15:11 +00:00			`+ updated to latest version 0.8.1`
backport of local changes 2009-05-10 12:17:09 +00:00
readme changes 2018-01-21 19:15:29 +00:00			`## My own additions`
backport of local changes 2009-05-10 12:17:09 +00:00
alt-u & alt-d: up & down in history; readme update 2018-01-19 02:33:28 +00:00			`+ Default font is system "mono" at 14pt`
			`+ Alt-k and Alt-j scroll back/foward in history one line at a time`
			`+ Alt-u and Alt-d scroll back/foward in history a page at a time`
Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. Created run-patches.sh, runs all patches on clean st 0.8.1 code. All old patches remvoed, including trasparency diff. Not including solarized theme, don't see value of it. Commented colornames array with color indexs from 0-15, includes index 255, and afterwards bg, fg and cursor, change those for background, foreground and cursor color. Seems better than solarized toggle. Updated README. 2018-04-25 20:15:11 +00:00			`+ Applied colors, insipred by Pop! OS colors.`
alt-u & alt-d: up & down in history; readme update 2018-01-19 02:33:28 +00:00
key bindings stated in README 2018-01-18 15:51:08 +00:00			`## Terminal-specific mappings`

alt-u & alt-d: up & down in history; readme update 2018-01-19 02:33:28 +00:00			`(Additions before me.)`

key bindings stated in README 2018-01-18 15:51:08 +00:00			`+ Scroll through history -- Shift+PageUp/PageDown or Shift+Mouse wheel`
			`+ Increase/decrease font size -- Shift+Alt+PageUp/PageDown`
spelling 2018-01-22 00:42:14 +00:00			`+ Return to default font size -- Shift+Alt+Home`
key bindings stated in README 2018-01-18 15:51:08 +00:00			`+ Paste -- Shift+Insert`
readme explains transparency installation 2018-01-19 21:32:00 +00:00
			`## Installation for newbs`

Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. Created run-patches.sh, runs all patches on clean st 0.8.1 code. All old patches remvoed, including trasparency diff. Not including solarized theme, don't see value of it. Commented colornames array with color indexs from 0-15, includes index 255, and afterwards bg, fg and cursor, change those for background, foreground and cursor color. Seems better than solarized toggle. Updated README. 2018-04-25 20:15:11 +00:00			`## Requirements for build`
readme explains transparency installation 2018-01-19 21:32:00 +00:00
Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. Created run-patches.sh, runs all patches on clean st 0.8.1 code. All old patches remvoed, including trasparency diff. Not including solarized theme, don't see value of it. Commented colornames array with color indexs from 0-15, includes index 255, and afterwards bg, fg and cursor, change those for background, foreground and cursor color. Seems better than solarized toggle. Updated README. 2018-04-25 20:15:11 +00:00			Install `base-devel` - compiler and stuff (most distros have).

			`Install code depndencies (voidlinux - most distro should have something similar)`

			+ `fontconfig-devel`
			+ `libX11-devel`
			+ `libXft-devel`
readme explains transparency installation 2018-01-19 21:32:00 +00:00

			```
			`make`
			`sudo make install`
			```
transparency explanation added 2018-02-06 04:33:39 +00:00
Updated st 0.8.1. Used new patches, scrollblock and alpha fixed. Created run-patches.sh, runs all patches on clean st 0.8.1 code. All old patches remvoed, including trasparency diff. Not including solarized theme, don't see value of it. Commented colornames array with color indexs from 0-15, includes index 255, and afterwards bg, fg and cursor, change those for background, foreground and cursor color. Seems better than solarized toggle. Updated README. 2018-04-25 20:15:11 +00:00			## Custom changes (`config.def.h` or `config.h`)

			+ change `alpha`
			+ chnage colors in `colorname` added comments with numbers `0`-`15` colors and also `bg`, `fg` and `cursor` color.