B.R.E.A.M. (Bash Rules Everything Around Me)

This is my personal desktop environment that is:

1. Reliable
2. Fast
3. Made from readily available components
4. Simple (see above)
5. Decent looking

I try to use the terminal as much as possible both for performance (I use old hardware) and so it's the same experience whether you're hands-on or remote. If it's not here then you probably don't need it.

This started as a script for quick deployment of some tools when connected to a remote system and then evolved into including the rest of my environment and configs as well. Now it's how I store and sync configs between my different systems and bootstrap a fresh install.

You can try it yourself if you like, on top of any Arch installation (maybe anything that uses pacman).

Features

• Dark mode is enabled by default
• Nerd fonts are used by default
• Many common tasks have shortcuts or keybindings
• Custom bream tool

Here are some highlights separated into tiers:

Base Shell

The meat and potatoes

Package	Description
btop	Top++
byobu	Comfy multiplexer (aka bb)
fish	Amazing shell with an amazing name
kondo	An awesome tool for cleaning up build artifacts
mosh	MObile SHell, like ssh but better with a bad connection
neovim	The best editor (aka v)
paru	Easier to use Arch package manager that supports AUR
rate-mirrors	Arch mirror ranking tool (used by bream mirrors)
wild	A much faster linker
yazi	Fast CLI file manager packed with features

GUI

Hyprland starter kit

Package	Description
awww	Wallpaper tool with animations
commit-mono-nerd	.otf nerd font that also supports bold, italic, and bold italic
trivalent	Backup browser
dunst	Lightweight and customizable notification daemon
focal	Slick screenshot/screen recording tool
hyprland	Fast and great looking window manager/compositor
kitty	Fast, feature-rich, GPU based terminal emulator
librewolf	Main browser
noto-fonts	Full coverage unicode fonts
python-pywalfox	Themes firefox with pywal colors
wallust	Set whole system color scheme from wallpaper colors
waybar	Highly customizable bar for wayland
wofi	Fast launcher/menu program for wayland
zathura	Minimalistic document viewer with keyboard controls

Bloat

Eye candy, stuff that won't install on ARM devices. This section is more personal.

Package	Description
caprine	Facebook messenger
discord	Discord
gimp	Image editor
inkscape	Vector graphics editor
spotify-launcher	Handles Spotify
telegram-desktop	Telegram messenger
thunderbird	Email client
walogram-git	Generate telegram-desktop theme

Install

Note

To update an existing installation run bream update.

Warning

Create a new user or back up your home directory if you're unsure about anything. If you have nothing to lose then go ahead and YOLO it. Just don't complain if something gets overwritten.

1. sh <(curl -s https://bream.doordesk.net/setup)
2. Log out and log back in
3. ????
4. PROFIT!!!!

Note

The mod keys are Super, Menu, and Meta

Post Install

Some manual setup is required for theming if you want eye candy.

Pywalfox

1. Install pywalfox for firefox
2. Open it and click the "Fetch Pywal colors" button. You shouldn't have to touch it ever again.

Walogram

1. Navigate to Settings > Chat Settings and click on choose from file
2. Toggle hidden files visibility in right click menu
3. Navigate to and double click on ~/.cache/walogram/bream.tdesktop-theme file
4. Click on keep changes