aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: d0388c4ee9c21e6e4b3bf50d26d9247b58c29096 (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
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
# Alpine Suck

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

![Screenshot of dwm running on Alpine Linux](https://git.bbtxx.org/screenshots/alpine-linux.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.

## 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, bash, & doas
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 by running `./install-dependencies.sh`. The script will simply read required packages from `dependencies.txt` and run apk add.
2) Compile and install suckless software by running the `./install.sh`

## TLDR

```sh
cd alpine-suck # CD into this repository
doas ./install-dependencies.sh # Install alpine packages
```

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:

```sh
doas ./install.sh # 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.