Doors are sturdier than windows

This is my personal desktop environment that is:

Reliable
Fast
Made from readily available components
Simple (see above)
Decent looking

I try to use the terminal as much as possible for performance and also so it's the same experience whether you're at the computer or connected via ssh.

If it's not here then you probably don't need it.

Most Features

Shell/Base

Yay - Package manager with AUR support (Arch only)
rsync - For my 'push' alias
sl - For when you're too fast
btop - Top++
neovim - Edit text blazingly fast (even over ssh)
byobu - Comfy multiplexer
Oh My Zsh - Community enhancements for zsh. Easier than DIY
nnn - Lightning fast file manager
lf - File manager like ranger but faster
mosh - MObile SHell, like ssh but better with a bad connection

Graphical environment

Business:

awesome - Dynamic window manager based on DWM
alacritty - Fast terminal with GPU acceleration written in Rust
maim - Screenshot tool, with a script for ease of use

Eye Candy:

pywal - Set whole system color scheme from wallpaper colors
nitrogen - Wallpaper setter that allows stretching across multiple screens
picom - Vsync, shadows, transparency, etc
redshift - Shifts screen to red at night to be easier on the eyes
unclutter - Hides the cursor after inactivity

Install

The install script clones this repo, installs a few dependencies, then copies my configs to $HOME/.config/ creating a backup for any config files that already exist. NOTE: Only ONE backup per file is saved to prevent piling up backups. It's only meant to catch small oversights and is very verbose. In other words, if you run the installer twice IT WILL OVERWRITE THE BACKUP!

The install script is only for Arch right now but I plan to include any distro that has these programs in their repos. Or at least most of them.

Quick shell (start here):

Note: back up your home directory or create a new user or you aren't allowed to complain about anything being overwritten

curl https://doors.doordesk.net/setup | bash
Log out and log back in

GUI

For now the setup just installs everything in one shot so you get the GUI whether you need it or not, to use it just run startx or start awesome from your display manager if you have one.
The mod keys are Super, Menu, and Meta
Once in awesome press Mod + F1 for a quick reference of all keybinds

Post Install

Neovim

Run :PackerSync on first run, :Mason to install language servers, :TSUpdate after installing language servers to update treesitter

Known issues (aka things to fix and excuses why they aren't):

Installer can hang at "retrieving packages" - I think this is a pacman/mirror issue. Just kill and restart it, it'll pick up where it left off
lsp-zero (nvim plugin) changed some things and needs to be reconfigured

Future:

Move stuff from xinitrc/xprofile to awesome rc to be less intrusive on existing systems
More granular installer
Support more distros
Add color to setup cause why not?

3.7 KiB Raw Blame History