readme

Author: igwtcode

README.md

@@ -2,45 +2,20 @@
 
 Tools and configurations
 
-## Requirements
-
-### mac
-
-```bash
-xcode-select --install
-```
-
-### archlinux
-
-```bash
-nmcli device wifi connect "<SSID>" password "<password>"
-```
-
 > [!IMPORTANT]
-> Open the file `/etc/makepkg.conf` and search for the line that starts with `OPTIONS=`.
-> Change `debug` to `!debug`. This prevents installing `*-debug` packages.
+> Read docs before running the script
 
-Check these in `/etc/pacman.conf`
-
-```bash
-Color
-CheckSpace
-VerbosePkgLists
-ParallelDownloads = 15
-ILoveCandy
-```
+- [archlinux](/docs/archlinux.md)
+- [mac](/docs/mac.md)
 
 ## Usage
 
 ```bash
 ./main.sh
 ```
 
-## Post install
-
-Open `tmux` and press `Ctrl-a + I` to install all plugins
-
-## Hints
+## After
 
-> [!TIP]
-> To export brew packages to a text file: `brew leaves > brew.txt`
+- open tmux with `tmux`.
+  If plugins are not auto installed on first run,
+  press `Ctrl-a + I` to install all plugins.

docs/archlinux.md

@@ -0,0 +1,37 @@
+# archlinux
+
+```bash
+nmcli device wifi connect "<SSID>" password "<password>"
+```
+
+## system config
+
+> [!IMPORTANT]
+> Open the file `/etc/makepkg.conf` and search for the line that starts with `OPTIONS=`.
+> Change `debug` to `!debug`. This prevents installing `*-debug` packages.
+
+Check these in `/etc/pacman.conf`
+
+```bash
+Color
+CheckSpace
+VerbosePkgLists
+ParallelDownloads = 15
+ILoveCandy
+```
+
+## virtualbox
+
+Read [arch wiki](https://wiki.archlinux.org/title/VirtualBox)
+
+- update system with `yay -Syu` and reboot (when necessary)
+
+- install virtualbox with
+
+  ```bash
+  yay -S virtualbox virtualbox-guest-iso
+
+  # select the option: virtualbox-host-modules-arch
+  ```
+
+- reboot to load necessary kernel modules

docs/mac.md

@@ -0,0 +1,8 @@
+# mac
+
+```bash
+xcode-select --install
+```
+
+> [!TIP]
+> To export brew packages to a text file: `brew leaves > brew.txt`