README.md

# Alpine Suck

Lightweight Desktop installer for Alpine Linux based on the suckless philosophy.

![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 my personal `vim` and `kitty` configs.

## What You Get

The Open Suck installer gives you the absolute barebones desktop experience:

- `dwm` for window management
- `kitty` for default terminal emulator
- `lf` 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 (doas is better than sudo!)
6. Edit doas permissions (`/etc/doas.conf`):

```
permit nopass :wheel
```

After finishing the above, create a user:

```
adduser -g "Real Name" username
```

Then add them to all required groups (wheel,users,audio,video,cdrom,input,tty):

```
adduser username wheel
```

Then logout of `root` user.

---

Login as your newly created user and run the following:

```
git clone https://git.btxx.org/alpine-suck
```

```
cd alpine-suck
```

## Installing

1. Install dependencies
2. Compile and install suckless software

## TLDR

**Warning**: Change the `$ALPINE_USER` variable inside `install-dependencies.sh` to match that of your current
user.

```
$ALPINE_USER="bt"
```

Then continue...

```sh
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:

```
startx
```

## Possible Tweaks / Troubleshooting

---

You might need to check `/proc/asound/cards` to see which sound cards are available to your system. Then, if needed, you should create a `/etc/asound.conf` file with the following inside (where the "1" is your desired card number):

```
defaults.pcm.card 1
defaults.ctl.card 1
```

This will take on the next reboot of the machine.