suckless-setup/README.md

Table of Contents

1. Suckless Setup
   1. Installation
      1. Distribution/OS specific instructions
   2. Changes from the default configuration
      1. dwm
      2. st
      3. dmenu
      4. slstatus
   3. Changes from the last update
      1. General
      2. dwm
      3. slstatus
   4. Links

Suckless Setup

My personal suckless configuration. It includes code and installation notes for my personal builds of dwm, st, dmenu and slstatus.

Installation

Go to the directory of the program you want to install and run sudo make install on your terminal.

Distribution/OS specific instructions

• Void Linux:

  • Make sure you have the necessary devel packages installed (base-devel, X11-devel, libXft-devel and libXinerama)
  • Change the paths for the X11INC and X11LIB variables in config.mk to /usr/include/X11 and /usr/lib/X11 respectively before compiling.

• FreeBSD / GhostBSD:

  • Change the paths for the X11INC and X11LIB variables in config.mk to $(PREFIX)/include and $(PREFIX)/lib respectively before compiling.
  • Uncomment the FREETYPEINC line for OpenBSD.
  • Make sure you have ncurses installed on your system before installing st.
  • Add the -lkvm flag in LDFLAGS before installing slstatus.

Changes from the default configuration

dwm

• The default modifier key is set to Mod4 (Super)
• The col_cyan color variable is switched with another color variable (col_gray5)
• The default font is set to Unifont 12
• The Mod+Shift+Enter keybinding launches st by default
• The following patches were applied:
  • alpha (version 20201019) - Adds transparency on dwm (a compositor like picom is needed)
  • fullgaps (version 20200508) - Adds gaps around and between windows
  • centretitle (version 20200907) - Aligns the window title on the center of the bar
  • titlecolor (version 20210815) - Allows the color of the title to be set separately from the tabs color

st

• The default font is set to Unifont 16
• The default TERM value is set to xterm-256color
• The default colors are slightly changed (based on the campbell theme I used on alacritty)
• The following patches were applied:
  • alpha (version 20220206) - Adds transparency on st (works similarly to the alpha patch for dwm)
  • anysize (version 0.8.4) - Resizes st to fill the entire space
  • bold is not bright (version 20190127) - Renders bold text without affecting its color

dmenu

• The default font and color configuration is set from dwm
• A default prompt is set

slstatus

• Updates interval is set to 100ms
• The following status indicators were added:
  • Wi-Fi percentage
  • Volume percentage - for OSS and PulseAudio (disabled)
  • Battery percentage (disabled)
  • Keymap and keyboard indicators
  • Date and time

Changes from the last version

General

• Changes to README.md

dwm

• Changed the default rules for GIMP and Firefox

slstatus

• Added a variation of the Wi-Fi indicator, useful for some Linux systems

Links

Suckless.org

Suckless.org - Hacking

dwm

st

dmenu

slstatus