# Linux Scripts and Configs

Dotfiles and scripts for Arch Linux (Manjaro), targeting Wayland (Hyprland / Sway) with an i3 fallback.

## IMPORTANT TODO

Inside `scripts/wofi/styles.css`, I have the colour css set to `/home/adamf/scripts/wofi/colors.css`, which is clearly ugly and not nice but it was quick to do.

Wofi is called in hypr/hyprland.conf and sway/swayconfig with the command `wofi --style /home/adamf/scripts/wofi/styles.css`. This is also not ideal but I couldn't find a way to get it to work with a relative path. I'm unsure when hyprland working directory is.

## Setup

```bash
git clone --recurse-submodules <repo-url> ~/scripts
```

If already cloned without submodules:

```bash
git submodule update --init --recursive
```

Install all packages:

```bash
yay -S $(grep -v '^\s*$' ~/scripts/packages.txt | tr '\n' ' ')
```

## Install / Uninstall

`install.sh` symlinks configs, sources shell files, and backs up any existing files it would overwrite. `uninstall.sh` reverses the process, removing symlinks and restoring backups.

```bash
# Install everything (uses Hyprland as the WM)
~/scripts/install.sh all

# Install specific targets
~/scripts/install.sh hyprland shell nvim tmux

# Uninstall specific targets (restores from most recent backup)
~/scripts/uninstall.sh nvim shell

# Uninstall using a specific backup
~/scripts/uninstall.sh --backup ~/scripts/backups/20260319_120000 all
```

Available targets: `hyprland`, `sway`, `i3`, `cursor`, `shell`, `alacritty`, `tmux`, `nvim`, `vim`, `all`.

### tmux prerequisite

Install the plugin manager before running `install.sh tmux`:

```bash
git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm
```

### Manual linking

If you prefer to link configs manually instead of using `install.sh`:

<details>
<summary>Manual symlink commands</summary>

#### Hyprland

```bash
ln -sf ~/scripts/hypr ~/.config/hypr
ln -sf ~/scripts/waybar ~/.config/waybar
ln -sf ~/scripts/wofi ~/.config/wofi
```

#### Sway

```bash
ln -sf ~/scripts/sway ~/.config/sway
ln -sf ~/scripts/waybar ~/.config/waybar
ln -sf ~/scripts/wofi ~/.config/wofi
```

The default waybar config (`waybar/config`) is set up for Hyprland. For Sway, rename the sway config as the active one:

```bash
mv ~/scripts/waybar/config ~/scripts/waybar/config.hypr.json
mv ~/scripts/waybar/waybar_sway_config.json ~/scripts/waybar/config
```

#### i3

```bash
ln -sf ~/scripts/i3 ~/.config/i3
ln -sf ~/scripts/i3blocks ~/.config/i3blocks
ln -sf ~/scripts/i3status ~/.config/i3status
```

#### Cursor

```bash
ln -sf ~/scripts/hatsune-miku-windows-linux-cursors/miku-cursor-linux ~/.local/share/icons/"Miku Cursor"
```

#### Shell

Add to `~/.bashrc` or `~/.zshrc`:

```bash
source ~/scripts/bashrc  # or zshrc
export PATH="~/scripts/sh:$PATH"
```

#### Terminals

**Alacritty** - add to `~/.config/alacritty/alacritty.toml`:

```toml
import = ["~/scripts/alacritty.toml"]
```

**Kitty** - kitty.conf is used directly by the WM configs.

#### tmux

Add to `~/.tmux.conf`:

```
source ~/scripts/tmux.conf
```

#### Vim

Add to `~/.vimrc`:

```
source ~/scripts/vimrc
```

</details>

## Keybindings

All window managers and tmux use vim-style <kbd>h</kbd><kbd>j</kbd><kbd>k</kbd><kbd>l</kbd> navigation. `$mod` is the Super key.

### Shared across WMs

| Key                      | Action                                     |
| ------------------------ | ------------------------------------------ |
| `$mod + Return`          | Terminal (kitty)                           |
| `$mod + Shift + q`       | Kill window                                |
| `$mod + d`               | Launcher (wofi / dmenu)                    |
| `$mod + h/j/k/l`         | Focus left/down/up/right                   |
| `$mod + Shift + h/j/k/l` | Move window left/down/up/right             |
| `$mod + g` / `$mod + v`  | Split horizontal / vertical                |
| `$mod + f`               | Fullscreen                                 |
| `$mod + Shift + Space`   | Toggle floating                            |
| `$mod + 1-8`             | Switch workspace                           |
| `$mod + Shift + 1-8`     | Move window to workspace                   |
| `$mod + Ctrl + 1-8`      | Move window silently                       |
| `$mod + -`               | Scratchpad show                            |
| `$mod + Shift + -`       | Move to scratchpad                         |
| `$mod + b`               | Previous workspace                         |
| `$mod + 9`               | Lock screen                                |
| `$mod + 0`               | System menu (lock/suspend/reboot/shutdown) |
| `$mod + r`               | Resize mode (hjkl)                         |
| `$mod + m`               | Toggle bar                                 |
| `$mod + Shift + c`       | Reload config                              |
| `$mod + Ctrl + m`        | PulseAudio control                         |
| `$mod + F2`              | Browser (Waterfox)                         |
| `$mod + F3`              | File manager (ranger)                      |
| `$mod + F5`              | Music (mocp)                               |
| `Print`                  | Screenshot                                 |

### System menu (`$mod + 0`)

| Key              | Action       |
| ---------------- | ------------ |
| `l`              | Lock         |
| `s`              | Suspend      |
| `h`              | Hibernate    |
| `r`              | Reboot       |
| `Shift + s`      | Power off    |
| `e`              | Exit session |
| `Return` / `Esc` | Cancel       |

### tmux

Prefix is <kbd>Ctrl</kbd> + <kbd>f</kbd>.

| Key                       | Action                      |
| ------------------------- | --------------------------- |
| `Prefix + g`              | Split horizontal            |
| `Prefix + v`              | Split vertical              |
| `Prefix + h/j/k/l`        | Select pane                 |
| `Prefix + J/K`            | Swap pane down/up           |
| `Prefix + Ctrl + H/J/K/L` | Resize pane                 |
| `Prefix + 1-0`            | Select window 1-10          |
| `Alt + 1-0`               | Create window 1-10          |
| `Prefix + !/@ etc.`       | Move pane to window 1-10    |
| `Prefix + w`              | Choose window               |
| `Prefix + q`              | Kill pane                   |
| `Prefix + [` / `]`        | Copy mode / Paste           |
| `Prefix + r`              | Refresh                     |
| `Prefix + R`              | Reload config               |
| `Prefix + Space`          | Send prefix (nested tmux)   |
| `Prefix + ?`              | List keys                   |
| `Prefix + Ctrl + s`       | Save session (resurrect)    |
| `Prefix + Ctrl + r`       | Restore session (resurrect) |

## Colorscheme

All colors are defined in a single file: `colors.conf`. A generator script produces format-specific fragments that each config sources or imports.

To change the theme:

```bash
# 1. Edit the palette
vim ~/scripts/colors.conf

# 2. Regenerate fragments
~/scripts/sh/gen-colors

# 3. Reload your WM / bar
hyprctl reload          # Hyprland
swaymsg reload          # Sway
killall waybar && waybar &  # Waybar
```

Generated files (committed so configs work after a fresh clone):

| File                | Format                      | Used by                      |
| ------------------- | --------------------------- | ---------------------------- |
| `hypr/colors.conf`  | `$color_name = rgb(HEXVAL)` | `hyprland.conf` (source)     |
| `sway/colors.conf`  | `set $color_name #HEXVAL`   | `swayconfig` (include)       |
| `i3/colors.conf`    | `set $color_name #HEXVAL`   | `i3config` (include)         |
| `waybar/colors.css` | CSS custom properties       | `waybar/style.css` (@import) |
| `wofi/colors.css`   | CSS custom properties       | `wofi/style.css` (@import)   |

## Scripts

All in `sh/`, added to `$PATH` via the shell config above.

| Script             | Description                                   |
| ------------------ | --------------------------------------------- |
| `sharefile <file>` | Upload a file to 0x0.st                       |
| `getfile <id>`     | Download a file from 0x0.st                   |
| `waybar-history`   | Stream the last zsh history entry to waybar   |
| `gen-colors`       | Regenerate color fragments from `colors.conf` |