Skip to content

aartaka/stumpwm-config

Repository files navigation

My StumpWM config

This is the repo with my chaotic customisations of StumpWM. All centered in config file, with lots of features split into their own files.

config

The hub for all the configuration. Things of interest:

  • A huge setf in the begining, heavily customizing Stump to my liking.
  • Volume control with increase-volume, decrease-volume, toggle-mute.
  • Lots of keybindings for everything really.
  • screen-lock-less-mode to prevent the machine from going to sleep.
  • CUA-hiding set of Emacsy bindings with define-remapped-keys.
  • Loading of the contrib configuration (files described below):

apps.lisp

Mostly Surf (Suckless browser) wrappers for my bank/email etc. And some games.

battery.lisp, mem.lisp

Configs for respective contrib modules.

password.lisp

A lot of code for convenient password/username copying with KeePassXC. Some of the code is re-purposed from Nyxt's password-mode and its underlying password-manager library.

screenshot.lisp

Wrapper around the screenshot contrib, opening Gimp on a newly created screenshot. Because I almost always want to crop the screenshot to a restricted area, instead of saving the full one.

slynk.lisp

Starts the Slynk (Lisp dev server) at localhost:4012 and provides a comment to start an additional one at an arbitrary port. Copied from Nyxt.

binwarp-mode (binwarp.lisp)

Binwarp-mode is now a part of stumpwm-contrib! Use it from there :) What follows is a small historical reference:

The touchpad of my laptop worked well... until it didn't. So, I needed to solve this problem. And, as a good tradition goes, if you can't solve the problem at once, split it into two smaller problems, if you can't solve the smaller problem, split it in two... You've got the idea.

Binwarp stands for binary warping, because it is inspired by both binary divide-and-conquer algorithms and StumpWM built-in ratwarp and ratrelwarp commands. And the "bin" part is the key part here because it's about how binwarp-mode works -- you split your screen in two and put your mouse pointer in the center of this binwarp-area. Pretty simple, yet pretty effective.

I feel obliged to say that, although I came up with this idea all by myself, there is a much more mature solution with the same approach out there: keynav. Why bothering rewriting it all anew then? Well, I prefer customizable lisp-based systems, as you may have guessed looking at the list of the software I customize in this repo. Having a small neat function close to your heart, with as less outer dependencies as possible and written all by yourself is comfortable, fast (because CL is hella faster than most other languages!) and fun because hacking things from scratch in your config is the best unproductive activity a programmer might have, especially if it makes them more productive in their working environment! Yak shaving, you know.