1 files changed, 45 insertions, 0 deletions

diff --git a/wiki/openbsd/desktop_environment.mdwn b/wiki/openbsd/desktop_environment.mdwn
index e03de56..9047afa 100644
--- a/wiki/openbsd/desktop_environment.mdwn
+++ b/wiki/openbsd/desktop_environment.mdwn
@@ -1,2 +1,47 @@
 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/)
  
+## 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
+
+```sh
+cd open-suck # CD into this repository
+doas sh ./install-dependencies.sh # Install OpenBSD packages
+doas sh ./install.sh # Install suckless tools
+cp .xinitrc ~/.xinitrc # Apply .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`.