blob: 5d5bf8bcb34bdbb4507d210ea949238f83707ffe (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
|
# Setting Up a Desktop Environment for OpenBSD
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" project: [Open Suck](https://git.btxx.org/open-suck/about)
## Show Don't Tell
<figure>
<img src="/public/images/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
- `firefox` 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.sr.ht/~bt/open-suck-installer
cd open-suck-installer
## 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
cd open-suck-installer # 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`.
|