Skip to content

hallzy/st-fork

Repository files navigation

st - simple terminal
--------------------
st is a simple terminal emulator for X which sucks less.

Customizations
--------------

- Changed colours to be gruvbox like
- Changed the font
- Installed the vimbrowse patch
- Installed the spoiler patch
- Installed the newterm patch (I also fixed a compilation warning about the
  result of chrdir not being used)
- Installed copyurl patch
- Installed openclipboard patch (And fixed compile warning)
- Installed bold is not bright patch
- 'scroll' as the scroll command
- Modified normal mode for vim-browse:
  - 'H' takes you to the beginning of the line
  - 'L' takes you to the end of the line
    - This takes you to the last non whitespace character instead of the end of
      the terminal output
  - 'K' takes you up half the screen
  - 'J' takes you down half the screen

Using color emojis. In order to make this work I need a patched version of
libXft.

To do this, go to https://github.com/uditkarode/libxft-bgra and follow the
instructions for how to install.

Then, I had to rename `libXft.so.2` that is in `/usr/lib/x86_64-linux-gnu` to
`libXft.so.2.bak`. This makes gcc use my version instead of the packaged one.

May also need to install `xutils-dev` to install libXft

BRANCHES
--------

- master branch is what I use
- upstream-master is a branch I use to track the suckless repository so that I
  can easily merge updates into my build
- All remaining branches are branches for specific patches, branched from
  upstream master, so that I can merge them back in to master


Requirements
------------
In order to build st you need the Xlib header files.


Installation
------------
Edit config.mk to match your local setup (st is installed into
the /usr/local namespace by default).

Afterwards enter the following command to build and install st (if
necessary as root):

    make clean install


Running st
----------
If you did not install st with make clean install, you must compile
the st terminfo entry with the following command:

    tic -sx st.info

See the man page for additional details.

Credits
-------
Based on Aurélien APTEL <aurelien dot aptel at gmail dot com> bt source code.