Shokunin

Automated Arch Linux installer with Hyprland, full-disk encryption, and a complete development environment.

One command takes you from bare metal to a fully configured system.

• Full-disk LUKS2 encryption with encrypted swap
• Hyprland tiling window manager (Wayland)
• Complete development environment out of the box
• Laptop optimized - lid close, power management, brightness
• Network printer discovery via Avahi/mDNS
• USB automounting with NTFS/exFAT support
• Screenshot & screen recording built-in
• Modular design - easy to customize

# 1. Boot Arch ISO and connect to internet
# 2. Run:
curl -fsSL https://raw.githubusercontent.com/tekdel/shokunin/master/boot.sh | bash

You'll be prompted for:

• Disk to install on
• Hostname, username, passwords
• Encryption password
• Timezone and swap size

Installation takes ~20-30 minutes. Reboot and enjoy!

cd ~/projects/shokunin
git pull
./update           # Update everything
./update dotfiles  # Update configs only
./update --dry     # Preview changes

Optimized for:

• Lenovo ThinkPad Z13 (AMD Ryzen)
• Framework Laptop (Intel/AMD)

Includes drivers for:

• AMD graphics (mesa, vulkan-radeon)
• Intel graphics (vulkan-intel, intel-media-driver)
• 32-bit libraries for Steam/Wine

# Edit the appropriate script
vim runs/40-apps

# Add your package and run
./run

# Edit dotfiles
vim dotfiles/hypr/hyprland.conf

# Apply changes
./update dotfiles

# Reload Hyprland
hyprctl reload

cat > runs/45-gaming <<'EOF'
#!/bin/bash
sudo pacman -S --needed --noconfirm steam lutris
EOF
chmod +x runs/45-gaming
./run

shokunin/
├── boot.sh           # Main installer
├── run               # Package manager
├── update            # System updater
├── install/          # Installation scripts (disk, base, bootloader, users)
├── runs/             # Package scripts (00-essential, 10-hyprland, etc.)
├── dotfiles/         # Configuration files
│   ├── hypr/         # Hyprland config
│   ├── waybar/       # Status bar
│   ├── alacritty/    # Terminal
│   ├── nvim/         # Neovim
│   ├── swappy/       # Screenshot config
│   └── bin/          # Custom scripts
└── plymouth/         # Boot splash theme

./test-vm.sh install  # Create VM and boot ISO
./test-vm.sh boot     # Boot installed system
./test-vm.sh clean    # Clean up

This project draws inspiration from:

• Omarchy by DHH/Basecamp - for the opinionated Arch + Hyprland approach
• ThePrimeagen - for tmux-sessionizer and terminal workflow ideas

MIT