README.md


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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

# Suckless Beastie

**Contributing**

Submit changes, patches or suggestions via email [here](mailto:suckless-beastie@patches.btxx.org)

---

Lightweight Desktop installer for FreeBSD based on the suckless philosophy.
Includes my own custom set of suckless tools (dwm, slstatus, dmenu, etc.)

![Screenshot of dwm running on FreeBSD](/screenshots/suckless-beastie.png)

Successfully installed on:

- ThinkPad X220

## What You Get

The Suckless Beastie 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

## Downloading

1. Download the latest FreeBSD iso and follow the installer
2. Login as `root`
3. Install `git`, `vim`, `bash`, `doas`
4. Edit/create doas permissions (`/usr/local/etc/doas.conf`):

```
permit nopass :wheel
```

(Also ensure your main user is added to the `wheel` group):

```
pw groupmod wheel -m username
```

Now logout and log back in as your main user.

---

Clone the main installer project:

`git clone https://git.sr.ht/~bt/suckless-beastie`

`cd suckless-beastie`

## Overview

1) Install dependencies
2) Compile and install suckless software

## Installing

Before running the installer, be sure to edit the main `install.sh` file and change the username "bt" to your own:

```sh
mkdir /home/bt/.suckless
cd /home/bt/.suckless
```

Then you are free to install:

```sh
cd suckless-beastie # CD into this repository
doas sh ./install-dependencies.sh # Install FreeBSD packages
```

```sh
doas sh ./install.sh # Build and install suckless tools
cp .xinitrc ~/.xinitrc # Apply .xinitrc
```

## Xorg Permissions

Add your main user to the `video` group:

```
pw groupmod video -m username
```

### Setting Up Graphic Cards (Optional)

```
pkg install drm-kmod
```

Edit `/etc/rc.conf` based on your graphic card:

```
# Intel
sysrc kld_list+=i915kms
# AMD
sysrc kld_list+=amdgpu
```

## Finishing Touches

Reboot the machine. Log in as your main user. Run:

```
startx
```