From d40840e22eb8fb4ce037f2074eeb773f653ed403 Mon Sep 17 00:00:00 2001 From: William Ball Date: Thu, 31 Jul 2025 21:09:52 -0700 Subject: [PATCH] update README --- README.org | 22 +++++++++++++++++----- 1 file changed, 17 insertions(+), 5 deletions(-) diff --git a/README.org b/README.org index 5f78c17..ad705c1 100644 --- a/README.org +++ b/README.org @@ -50,29 +50,41 @@ I use a custom [[https://wayland.freedesktop.org][Wayland]] desktop built around *** River The first tiling window manager I used (after a brief stint with [[https://i3wm.org][i3]]) was [[https://dwm.suckless.org][dwm]], and river strikes the best balance between maturity, usability, and similarity to dwm. The tag system is strictly superior to usual workspaces in my opinion. +*** Niri +I've started messing around with [[https://github.com/YaLTeR/niri][niri]], and it is honestly incredible. I love river, but I honestly don't see myself going back any time soon. Niri is so nice on a laptop. It suits my workflow perfectly. + *** Mako I use [[https://github.com/emersion/mako][mako]] as my notification daemon of choice. I started off on X11 using [[https://github.com/dunst-project/dunst][dunst]], but switched to mako before dunst got Wayland support, since mako's almost the same thing. *** Swaylock/Swayidle -I use [[https://github.com/swaywm/swaylock][swaylock]] and [[https://github.com/swaywm/swayidle][swayidle]] to handle my screen locking needs. I also have a couple scripts (=timeout.sh= and =toggle_caffeine.sh= in my river config), to basically enable toggling swayidle. I usually want my computer to lock automatically if I've been idle long enough, but sometimes want to be able to turn that off. +I use [[https://github.com/swaywm/swaylock][swaylock]] and [[https://github.com/swaywm/swayidle][swayidle]] to handle my screen locking needs. I also have a couple scripts (=timeout.sh= and =toggle_caffeine.sh= in my river/niri configs), to basically enable toggling swayidle. I usually want my computer to lock automatically if I've been idle long enough, but sometimes want to be able to turn that off. *** Fuzzel I use [[https://codeberg.org/dnkl/fuzzel][fuzzel]] as my launcher. It's basically [[https://github.com/davatorium/rofi][rofi]] for wayland but with less baggage and better [[https://tools.suckless.org/dmenu/][dmenu]]-like functionality. I use it in several scripts in addition to it being my launcher. +*** Bemenu +I've lately been trying out [[https://github.com/Cloudef/bemenu][bemenu]], which is a fairly straightforward [[https://tools.suckless.org/dmenu/][dmenu]] implementation that works on Wayland. bemenu : dmenu :: fuzzel : rofi. + *** Wob I use [[https://github.com/francma/wob][wob]] to show my volume and brightness when I change them. It's just a wayland version of the excellent [[https://github.com/florentc/xob][xob]]. -*** Wbg -I use [[https://codeberg.org/dnkl/wbg][wbg]] as my wallpaper setter. There are a million of these, and it doesn't really matter which you pick. +*** Swaybg +I use [[https://github.com/swaywm/swaybg][swaybg]] as my wallpaper setter. There are a million of these, and it doesn't really matter which you pick. *** Waybar I don't really like really elaborate and fancy status bars. Whatever status bar I'm using, I like to have workspaces on the left, time and date in the middle, and volume, wifi, and battery on the right. I don't know where I picked up this habit (I think an ancient [[https://github.com/LemonBoy/bar][lemonbar]] script of mine, but I don't really remember), but it's what I'm used to now, and is very easy to emulate in [[https://github.com/Alexays/Waybar][waybar]]. I've tried [[https://codeberg.org/dnkl/yambar][yambar]], but found it very confusing to configure. *** Keyd -As a heavy emacs/vim user, remapping caps lock to esc/control is absolutely necessary, and [[https://github.com/rvaiya/keyd][keyd]] is great for this. Note that =stow keyd= won't work properly. Instead you should copy =keyd/default.conf= to =/etc/keyd/= and enable the =keyd= service. [[https://gitlab.com/interception/linux/plugins/caps2esc][caps2esc]] is also great for this purpose, but I find keyd a little easier to use. +As a heavy emacs/vim user, remapping caps lock to esc/control is absolutely necessary, and [[https://github.com/rvaiya/keyd][keyd]] is great for this. Note that =stow keyd= won't work properly. Instead you should copy =keyd/default.conf= to =/etc/keyd/= and enable the =keyd= service. [[https://gitlab.com/interception/linux/plugins/caps2esc][caps2esc]] is also great for this purpose, but I find keyd a little easier to use. It's capable of way more than just what I use it for, and [[https://github.com/kmonad/kmonad][kmonad]] is even fancier, but keyd works great. *** Zathura My pdf viewer of choice is [[https://pwmt.org/projects/zathura/][zathura]], which is simply excellent. Configurable, uses vim keybindings, does exactly what I need it to out of the box and nothing more. I've tried to get into [[https://sioyek.info/][sioyek]] in the past, but never quite figured it out. *** Pianobar -[[https://github.com/PromyLOPh/pianobar][Pianobar]] is one of the most underrated pieces of software ever. It's an absolutely phenomenal cli [[https://pandora.com][pandora]] client (that skips ads btw). As just a cli, it's phenomenal, but it's also very easy to build on top of. I'm not much of a hacker, but I was easily able to throw together some scripts to let me pause, skip songs, etc. from keybinds from river, change the station with a dmenu style menu in fuzzel, and send notifications upon song changes with the album art and everything. All with a couple tiny bash scripts. If you don't want to set this up manually, there are also several pieces of software built on top of pianobar, my favorite being [[https://pithos.github.io/][pithos]] (though [[https://github.com/agrif/pianobar.el][pianobar.el]] is also a ton of fun, it just doesn't work very well for me). +[[https://github.com/PromyLOPh/pianobar][Pianobar]] is one of the most underrated pieces of software ever. It's an absolutely phenomenal cli [[https://pandora.com][pandora]] client (that skips ads btw). As just a cli, it's phenomenal, but it's also very easy to build on top of. I'm not much of a hacker, but I was easily able to throw together some scripts to let me pause, skip songs, etc. from keybinds from river, change the station with a dmenu style menu, and send notifications upon song changes with the album art and everything. All with a couple tiny bash scripts. If you don't want to set this up manually, there are also several pieces of software built on top of pianobar, my favorite being [[https://pithos.github.io/][pithos]] (though [[https://github.com/agrif/pianobar.el][pianobar.el]] is also a ton of fun, it just doesn't work very well for me). + +** Colors + +I currently use [[https://github.com/catppuccin][catppuccin]] for everything. I'm getting a little tired of catppuccin, but it has the most complete list of ports of any colorscheme I've ever seen, maybe just shy of Dracula, even compared to much older staples like Nord, Gruvbox, or Solarized. Since I've already painstakingly themed everything I use with catppuccin colors, it's too late to switch now. + +I do like [[https://protesilaos.com/emacs/modus-themes][modus-themes]] on emacs, and used gruvbox pretty heavily when starting out. There's no shortage of good themes.