wm-scripts

by pika

What is it?

This is essentially just a script library, which adds some quality of life things for your wayland display manager (could also work with X11 but I do not test X11 stuff!)

key-highlights

• startw: This script is basically a small initializer, like startx. It uses a config file (~/.winitrc) and parses it. This is basically just a shell script, but i found out, that on jay you are forced to set the XCURSOR_THEME and .._SIZE in the shell you are running jay run from. So just set the .winitrc file and set your config file like:

    export XCURSOR_THEME="Cartoonish Bold"
    export XCURSOR_SIZE=24
  
    jay run
  

  Inside your session-manager, you can let it point to start startw. This works for me, let me know if you have any issues.

• wm-term: This script detects some of the terminal emulators to use (like: ghostty, kitty, foot, alacritty..) and on execution, just starts a new terminal instance. When executed with a command like: wm-term ssh john@some-server - it would spawn a new terminal instance with the command provided directly. Also you can force a supported terminal with setting WM_TERMINAL before executing. Like: WM_TERMINAL=alacritty wm-term youtube-tui. Keep in mind, currently we have a limited count of supported terminals. More to come..

• wm-volume: This script is really cool. It detects the audio provider, and lets you easily control volume with simple commands like:

  • wm-volume down --> lowers the volume
  • wm-volume up --> uppers the volume
  • wm-volume mute --> toggles mute for current device

• wm-wallpaper: This one is also pretty cool
  It lets you either select a wallpaper file direclty to set with wm-wallpaper select, or you can just set one randomly with wm-wallpaper random. It uses swww, awww or wbg.

  Note

  Most of the commands can also be used in conjunktion like:

  wm-term wm-wallpaper select -> to start a new terminal with the selection for the wallpaper directly getting passed

• wm-screenshot: This script only works on Hyprland and Niri instances. On niri, the default screenshot tool is used. When using hyprland, we have fallbacks for hyprshot and grim

• wm-files: This script is working like the wm-term script earlier, but with file managers. Give it the --cli or the --gui argument, to select during runtime. CLI is always preferred, and when assigning a hyprland/wm keymap for this script, it should auto use wm-term for displaying this inside a new window. When running from terminal directly, it detects that, and spawns it directly in the terminal.

find more..

You can still find more in this repo which might help you along the way. You can always make a pull request if you want to have some generalized functionality around your wayland/X11 windowmanager experience.