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
archlinux-contrib	Arch contrib scripts
bat	A cat(1) clone with wings
btop	Top++
earlyoom	Kill memory leaking processes earlier
fish	Amazing shell with an amazing name
kondo	An awesome tool for cleaning up build artifacts
mold	A modern linker
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)
tmux	Terminal multiplexer
ufw	An uncomplicated firewall
yazi	Fast CLI file manager packed with features

GUI

Hyprland starter kit

Package	Description
awww	Wallpaper tool with animations
dunst	Lightweight and customizable notification daemon
focal	Slick screenshot/screen recording tool
foot	A fast, lightweight and minimalistic Wayland terminal emulator
hyprland	Fast and great looking window manager/compositor
hyprpwcenter	A GUI Pipewire control center
librewolf	Main browser
otf-commit-mono-nerd	.otf nerd font that also supports bold, italic, and bold italic
otf-font-awesome	A popular icon font
python-pywalfox	Themes firefox with pywal colors
trivalent	Backup browser
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
discord_arch_electron	Discord
element-desktop	Matrix client
gimp	Image editor
inkscape	Vector graphics editor
telegram-desktop	Telegram messenger
thunderbird	Email client
walogram-git	Generate telegram-desktop theme
yt-dlp	A useful tool that does useful tool things

Install

The minimal base to install bream on is the archinstall minimal preset. You should select all the fonts and set up your own audio, bluetooth, etc.

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

Use Super + F1 or Super + ? to view all keybinds.

Theming

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

Wallpaper

If you install bream in a CLI environment, the wallpaper may not be set. If you just see a blank background then either press Super + Shift + P or run bream setbg manually.

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