@@ 1,19 1,20 @@
-# Arch setup
+# Arch Linux Dotfiles
-This is a repository containing the configuration of my personal Arch Linux system. The
-changes to my home directory are directly tracked on the "dots" branch, master is for
-documentation and license only.
+This is a repository containing the configuration of my personal Arch Linux
+system. The changes to my home directory are directly tracked on the ["dots"
+branch](https://git.sr.ht/~piotr-machura/dotfiles/tree/dots), master branch is for this
+readme and license only.
## Cloning the repository
This section describes a full "dotfile installation", which should (ideally) come right
after installing Arch and booting properly for the first time. Feel free to skip it and
-clone the repo normally if you just want some of the configuration.
+just clone the "dots" branch if you want only some of the configuration.
-1. Create an alias `alias dots="/usr/bin/git --git-dir=$HOME/.conifg/dots
+1. Create an alias `alias dots="/usr/bin/git --git-dir=$HOME/.config/dots
--work-tree=$HOME"`
2. Clone the repo `git clone --single-branch --branch dots --bare
- git@git.sr.ht:~piotr-machura/arch-setup $HOME/.config/dots`
+ git@git.sr.ht:~piotr-machura/dotfiles $HOME/.config/dots`
3. Disable the showing of untracked files `dots config --local
status.showUntrackedFiles no`
4. Apply the configs `dots reset --hard`
@@ 39,9 40,8 @@ The cloned repo contains a list of official packages located in
3. Install AUR packages using your favorite AUR helper `paru -S --needed - <
~/.local/share/pacman/aur.txt`.
-**Note:** the AUR package list contains a base-devel meta package. You can run
-`paru -D --asdeps $(paru -Qg base-devel | awk '{print $2}')` to set the base-devel
-install reason as dependency.
+**Note:** the AUR package list contains a base-devel meta package. You can run `paru -D
+--asdeps $(pacman -Qqg base-devel)` to set the base-devel install reason as dependency.
### Pacman
@@ 74,7 74,7 @@ how to exclude additional ones.
Some programs require manual configuration, since not everything can be kept in the
repository. This section describes just that.
-### Systemd & firewall
+### Systemd
**System-wide** services enabled with `systemctl enable <service name here>` :
@@ 85,7 85,7 @@ repository. This section describes just that.
- `paccache.timer`
- `plocate-updatedb.timer`
- `bluetooth.service` (optional)
-- `NetworkManager.service` (likely already enabled)
+- `NetworkManager.service` (likely already enabled after installation)
In order to utilize the HHKB's power key to show the power menu the logind config file
must be modified to include
@@ 101,7 101,7 @@ and the service reloaded with
`systemctl restart systemd-logind.service`
-**Firewall:**
+### Firewall
1. Enable the firewall `ufw enable`.
2. Disallow any incoming traffic `ufw default deny`.
@@ 110,7 110,7 @@ and the service reloaded with
The last step is optional, but without it ufw does clutter the systemd logs quite a bit.
-### LightDM & Xorg
+### LightDM
The config is present in `~/.config/lightdm/lightdm-mini-greeter.conf`. We will link it
to the system-wide location shortly, but first:
@@ 148,7 148,7 @@ setting
<localRepository>${user.home}/.local/share/mvn</localRepository>
```
-### Screen saver
+### Xorg
By default the X11 screen saver will blank out the screen after ~10 minutes of
inactivity. If, like me, you find this behavior annoying, create or edit
@@ 162,9 162,7 @@ Section "ServerFlags"
EndSection
```
-### Screen tearing
-
-If you experience screen tearing (especially when watching videos in Firefox) edit the
+If you experience screen tearing (especially when watching videos) edit the
following
```none
@@ 262,8 260,10 @@ Inherits=Breeze
```
The others should be enabled by default after installing the dotfiles. The only
-exception is the GTK2 theme, which requires linking to the system-wide location `ln -s
-~/.local/share/themes/Materia-black /usr/share/themes`.
+exception is the GTK2 theme, which requires linking (or copying) to the system-wide
+location
+
+`ln -s ~/.local/share/themes/Materia-black /usr/share/themes`.
### Thunar
@@ 301,6 301,7 @@ In `about:config` enable the following options:
- `toolkit.legacyUserProfileCustomizations.stylesheets`
- `browser.compactmode.show`
+- `layout.css.system-ui.enabled` (disable)
and link the user chrome to your profile folder: