commit - ea201a0ba76f31de945d153602ead0cb01be01e3
commit + 5d7a8d2e8f0275bdde379b95b2c94a789acd00af
blob - 77443b68811d12f1970c1cf0c9ada1fa83c88b5b
blob + 193efbd566b233b3ed6b27ad40b7600acd0f4de5
--- README.md
+++ README.md
![Screenshot of dwm running on Alpine Linux](https://git.btxx.org/screenshots/alpine-suck.png)
-Includes my own custom set of suckless tools (dwm, slstatus, dmenu, etc.). Ships with `ohmyzsh` and personal `vim` configs. Uses `qutebrowser` for default browser.
+Includes my own custom set of suckless tools (dwm, slstatus, dmenu, etc.). Ships with `ohmyzsh` and my personal `vim` configs.
+## What You Get
+
+The Open Suck installer gives you the absolute barebones desktop experience:
+
+- `dwm` for window management
+- `ranger` for your file browser
+- `firefox` as your core web browser
+- `aerc` for your terminal-based mail client
+- `slock` for screen locking
+- `scrot`/`slop` for simple screenshot utilities
+- `feh` for your image/file viewing
+- `dunst` for notifications
+
## Downloading
1. Download the latest Alpine image
2. Run `setup-alpine`
3. Run `setup-xorg-base`
4. [Enable community/edge/testing repos](https://wiki.alpinelinux.org/wiki/Repositories#Enabling_the_community_repository)
-5. Install git, vim & doas
+5. Install git, vim & doas (doas is better than sudo!)
6. Edit doas permissions (`/etc/doas.conf`):
```
## Installing
-1. Install dependencies by running `./install-dependencies.sh`
-2. Compile and install suckless software by running the `./install.sh`
+1. Install dependencies
+2. Compile and install suckless software
## TLDR
-```sh
-cd alpine-suck # CD into this repository
-doas sh ./install-dependencies.sh # Install alpine packages
-```
+**Warning**: Change the `$ALPINE_USER` variable inside `install-dependencies.sh` to match that of your current
+user.
-Be sure to change the `$ALPINE_USER` variable to match that of your current
-user:
-
```
$ALPINE_USER="bt"
```
-Then run the script to build suckless programs:
+Then continue...
```sh
-doas sh ./install.sh # Install everything
+cd alpine-suck # CD into this repository
+doas sh ./install-dependencies.sh # Install alpine packages
```
+Give that some time. Once it is complete, run `install.sh` to build the suckless programs:
+
+```sh
+doas sh ./install.sh # Build & install everything
+```
+
Reboot the machine. Log in as your main user. Run:
```