diff options
author | Bradley Taunt <bt@btxx.org> | 2024-05-31 14:53:12 -0400 |
---|---|---|
committer | Bradley Taunt <bt@btxx.org> | 2024-05-31 14:53:12 -0400 |
commit | e85eb98480d0c7af950859e95819901a20923fe7 (patch) | |
tree | 5fc5ab9dd9608cfc676a475297e84bfb1de3f114 /wiki/openbsd_desktop_environment.md | |
parent | 8f28fc58d5fe68775fbe552eb172cbb4ad8614b1 (diff) |
Begin porting over wiki pages
Diffstat (limited to 'wiki/openbsd_desktop_environment.md')
-rw-r--r-- | wiki/openbsd_desktop_environment.md | 60 |
1 files changed, 60 insertions, 0 deletions
diff --git a/wiki/openbsd_desktop_environment.md b/wiki/openbsd_desktop_environment.md new file mode 100644 index 0000000..993da29 --- /dev/null +++ b/wiki/openbsd_desktop_environment.md @@ -0,0 +1,60 @@ +--- +layout: page +title: OpenBSD Desktop Environment +permalink: /wiki/openbsd/desktop_environment +--- + +This page covers the initial setup for installing and configuring `dwm` as a desktop environment on OpenBSD. Everything posted here relies on my personal "Open Suck" installer: [Open Suck](https://git.btxx.org/open-suck/about/) + +## Show Don't Tell + +<figure> +<img src="https://btxx.org/posts/OpenBSD_is_a_Cozy_Operating_System/open-suck-75.png" alt="Screenshot of OpenBSD 7.5 running dwm"> +<figcaption>Open Suck: OpenBSD 7.5 running dwm on my X220</figcaption> +</figure> + +## What You Get + +The Open Suck installer gives you the absolute barebones desktop experience: + +- `dwm` for window management +- `qutebrowser` as your core web browser +- `aerc` for your terminal-based mail client +- `slock` for screen locking +- `scrot`/`slop` for simple screenshot utilities +- `dunst` for notifications + +## Required Packages + +Before we begin setting things up, you will need to install `git`, `vim`, `bash`: + + pkg_add git vim bash + +## Cloning the Project + +Clone the main installer project and navigate instead the directory: + + git clone https://git.btxx.org/open-suck + cd open-suck + +## Installing + +1. Install dependencies by running `./install-dependencies.sh`. The script will simply read required packages from `dependencies.txt` and run `pkg_add`. +2. Compile and install suckless software by running the `./install.sh` + +## TL;DR + + # Install OpenBSD packages + doas sh ./install-dependencies.sh + # Install suckless tools + doas sh ./install.sh + # Apply .xinitrc + cp .xinitrc ~/.xinitrc + +Reboot the machine. Log in as your main user. Run: + + + startx + + +That's it! You now have a fully functional desktop environment built on top of `dwm`. |