birdwm

birdwm - mrgrouse's daily driver fork of suckless' dwm. Contains many patches and is currently loosely maintained.
Log | Files | Refs | README | LICENSE

README (2176B)

      1 # Birdwm, dwm for birds, by a bird!
      2 Birdwm (fork based on dwm release 6.6)
      3 
      4 ## Dependencies:
      5 - libx11
      6   - libxcb
      7 - libfontconfig
      8   - libfreetype
      9   - libexpat
     10 - libxft
     11 - libxrender
     12 - imlib2
     13   - libxext
     14   - libxcb
     15 - libxinerama (optional)
     16 
     17 Birdwm does not build with tcc unfortunately.
     18 
     19 ## Patches and Features
     20 
     21 - barpadding: vertical and horizontal space between the status bar and the borders of the screen. configurable via config.h. (https://dwm.suckless.org/patches/barpadding).
     22 - birdmenu-emoji (modified): runs dmenu-emoji script (modified for birdmenu), accessible via mod + e. (https://github.com/porras/dmenu-emoji)
     23 - cool_autostart: runs programs listed in config.h upon startup. (https://dwm.suckless.org/patches/cool_autostart)
     24 - scratchpad: Accessible with mod + y. (https://dwm.suckless.org/patches/scratchpad)
     25 - systray: System tray patch for birdwm in the corner of the bar. (https://dwm.suckless.org/patches/systray)
     26 - uselessgaps: Adds useless gaps around windows, except in monocle mode. (https://dwm.suckless.org/patches/uselessgap)
     27 - winicon: Patch for birdwm to display the icon of currently focused program. (https://dwm.suckless.org/patches/winicon)
     28 - xrdb: Birdwm patch that reads Xresources colors/variables (i.e. works with `pywal`, etc.). (https://dwm.suckless.org/patches/xresources)
     29 
     30 ### Misc. features
     31 - various scripts (found in extras/): various shell scripts for things such as:
     32   - setting and getting volume for/from pulse audio
     33 
     34 - strong compatibility with my forks of other suckless programs, such as:
     35   - slstatus (https://git.mrgrouse.com/slstatus/log.html): a status bar with few patches for birdwm
     36   - slock (https://git.mrgrouse.com/slock/log.html): a simple screen lock tool with Xresources compatibility
     37   - birdmenu (https://git.mrgrouse.com/birdmenu/log.html): my dmenu fork, including Xresources, password mode, and mouse clickability.
     38   - birdterm (https://git.mrgrouse.com/birdterm/log.html): my st (simple terminal) fork, including transparency and scrollback.
     39 
     40 ## Installation for birdwm on linux distros
     41 ### See `config.h` for customization options
     42 
     43 git clone https://git.mrgrouse.com/birdwm.git
     44 cd birdwm
     45 sudo make install