dotfiles

Personal development environment for Arch Linux + Hyprland, focused on security research and bug bounty hunting.

Overview

Automated setup for a minimal, consistent Linux environment with:

• Arch Linux + Hyprland as the primary desktop target
• Vantablack / White / Tokyo Night three-theme system synced across all components
• LazyVim with Omarchy-style dynamic colorschemes
• Bug bounty toolkit with full automated recon workflow
• Support for Ubuntu VPS, i3wm, WSL, and headless Arch variants

Install

git clone https://github.com/mswell/dotfiles.git
cd dotfiles
./install.sh

Setup Options

Option	Description
[1] Ubuntu VPS	Servers and web development
[2] Arch VPS	CLI-only, no GUI
[3] Arch + Hyprland	Primary desktop (Wayland)
[4] Hacktools	Security tools, CTF, bug bounty
[5] Dev Environment	Python + Node.js via mise
[6] Arch + i3wm	Tiling WM, X11
[7] Arch WSL	Windows Subsystem for Linux
[8] Arch DE	Traditional desktop environment
[9] Claude for Bug Bounty	AI skills + Caido integration

Order matters: run system setup (1/2/3/6/7/8) before dev env (5) or hacktools (4).

Desktop

Minimal Wayland setup inspired by Omarchy:

• Theme: SUPER+SHIFT+T cycles vantablack → white → tokyonight, syncing Hyprland, Kitty, Waybar, Walker, tmux, fzf, ZSH prompt, and Neovim
• Launcher: Walker (SUPER+A)
• Power menu: Walker dmenu (SUPER+ESC) — Lock / Suspend / Logout / Restart / Shutdown
• Lock screen: Hyprlock — blurred screenshot background, minimal centered input field
• Notifications: Mako
• Status bar: Waybar
• Terminal: Kitty

Key Bindings

Key	Action
SUPER+Return	Terminal
SUPER+A	App launcher (Walker)
SUPER+ESC	Power menu
SUPER+SHIFT+L	Lock screen
SUPER+SHIFT+T	Cycle theme (vantablack → white → tokyonight)
SUPER+CTRL+W	Next wallpaper
SUPER+V	Clipboard history

Shell & Editor

• ZSH with Powerlevel10k — prompt and autosuggestion colors sync with the active theme
• Neovim with LazyVim — loads vantablack.nvim, white.nvim, or tokyonight.nvim based on the current theme
• tmux with theme-synced status bar
• fzf with per-theme color config

Bug Bounty Toolkit

ZSH functions for automated recon. Each step produces files consumed by the next.

Workflow

workspaceRecon <domain>
  └── wellSubRecon          # subfinder + amass + crt.sh + DNS resolution
      └── naabuRecon        # top-100 port scan
          └── getalive      # HTTP probe → ALLHTTP / 200HTTP / 403HTTP
              └── crawler   # gospider + waybackurls + gau + katana
                  └── JScrawler / secretfinder / exposureNuc / XssScan

Recon Functions

Function	Description	Output
workspaceRecon <domain>	Creates dated workspace	domain/YYYY-MM-DD/
wellSubRecon	Full subdomain pipeline	clean.subdomains
subdomainenum	Passive enum (subfinder, amass, crt.sh)	all.subdomains
subPermutation	Permutations via alterx + puredns	permutations.txt
naabuRecon	Top-100 port scan	naabuScan
naabuFullPorts	Full port range scan	full_ports.txt
getalive	HTTP probe, categorized by status	ALLHTTP, 200HTTP, 403HTTP
crawler	Multi-tool crawler	crawlerResults.txt
JScrawler	JS file discovery	crawlJS, JSroot/
secretfinder	Secret scanning in JS files	js_secrets_result
xsshunter	XSS detection (airixss, freq, xsstrike)	airixss.txt, FreqXSS.txt
bypass4xx	403/401 bypass attempts	4xxbypass.txt
prototypefuzz	Prototype pollution testing	—
subtakeover	Subdomain takeover detection	subtakeover.txt
exposureNuc	Nuclei exposure scan	—
XssScan	Nuclei XSS scan	—
nucTakeover	Nuclei takeover scan	—

Security tools installed via option [4]: nuclei, httpx, subfinder, naabu, katana, ffuf, amass, and others from ProjectDiscovery.

Configuration Structure

config/
├── zsh/
│   ├── env.zsh              # central path config (source of truth)
│   ├── functions.zsh        # bug bounty recon functions
│   ├── themes/              # p10k + autosuggestion colors per theme
│   └── .zshrc
├── hypr/
│   ├── hyprland.conf
│   ├── hyprlock.conf
│   ├── themes/              # vantablack.conf + white.conf + tokyonight.conf
│   └── scripts/
│       ├── theme-switch.sh  # syncs all components on theme change
│       └── power-menu.sh    # walker dmenu power menu
├── nvim/
│   └── lua/plugins/
│       └── colorscheme.lua  # reads current-theme → vantablack, white, or tokyonight
├── kitty/themes/
├── waybar/themes/
├── walker/
└── tmux/themes/

Inspiration

Desktop configuration inspired by Omarchy by DHH / Basecamp — theme system architecture, Walker integration, Hyprlock style, and Neovim colorschemes (bjarneo/vantablack.nvim, bjarneo/white.nvim).

License

MIT — Wellington Moraes