AquaFiles (dotfiles)

Plain text configs for bootstrapping my (PDE) Personal Development Enviroment.

My primary operating system is macOS, but I do use Linux sometimes... (arch, btw!)

Also Ubuntu Server in the cloud

Feel free to try out my dotfiles or use them as inspiration! If you have a suggestion, improvement or question, please open an issue or PR!

Design Principles

• Open-Source
• Flow State
• Minimalism
• Keyboard Home Row Centric
• Design & Aesthetics
• Productivity (minimize distractions)
• Form & Function (beauty and action)
• Portable
• Bleeding Edge

Screenshots

Lazyvim Welcome screen

Yabai bsp grid with 5 cmatrix running

Zellij fastfetch, cmatrix, htop

Zellij Neovim htop cmatrix

Zellij welcome screen

WARNING

These dotfiles are for my own personal use and i update them very frequently. If you want to use them: fork the repo, review the code and take what you need from it. Use at your own risk!

Dev Setup

Requirements

• Deno - For peek.nvim
• Neovim >= 0.9.0 (needs to be built with LuaJIT)
• Git >= 2.19.0 (for partial clones support)
• LazyVim
• a Nerd Font(v3.0 or greater) (optional, but needed to display some icons, Patched Operator Mono Provided in the repo)
• lazygit (optional)
• a C compiler for nvim-treesitter. See here
• for telescope.nvim (optional)
  • live grep: ripgrep
  • find files: fd
• a terminal that support true color and undercurl:
  • wezterm (Linux, Macos & Windows)
  • kitty (Linux & Macos)
• Patched Operator Mono
  • Added Nerd Fonts
  • Added Ligatures

System Settings setup

defaults write -g ApplePressAndHoldEnabled -bool false

WezTerm Setup

install wezterm through homebrew

brew install --cask wezterm

• cd into AquaFiles

cd ~/AquaFiles/

• stow the config

stow wezterm

Fish Shell Setup

• install fish shell through homebrew

brew install fish

• Add fish to the list of allowed shells by appending its path to /etc/shells

echo $(which fish) | sudo tee -a /etc/shells

• set fish shell to the default shell

chsh -s /opt/homebrew/bin/fish

• exit the current terminal

exit

• check if fish shell is set as the default shell

echo $SHELL
# expected output:
# /opt/homebrew/bin/fish (if on macOS)

• delete config folder

rm -rf ~/.config/fish

• cd into AquaFiles

cd ~/AquaFiles/

• stow the config

stow fish

Troubleshooting: if you don't see a recently added path in the $PATH make sure to delete ~/.config/fish/fish_variables, and exit the terminal and restart to clear the cache

Neovim setup

• Install neovim

brew install neovim # make sure you have the latest version

• install deno for (peek.nvim)

curl -fsSL https://deno.land/install.sh | sh

• Backup previous config

mv ~/.config/nvim ~/.config/nvim.bak
mv ~/.local/share/nvim ~/.local/share/nvim.bak

• Install LazyVim

git clone https://github.com/LazyVim/starter ~/.config/nvim

• Remove the .git folder, so you can add it to your own repo later

rm -rf ~/.config/nvim/.git

• clone dotfiles (needs to be cloned in root directory for GNU Stow work)

git clone https://github.com/0xAquaWolf/AquaFiles ~/

• delete lua directory in nvim

rm -rf ~/.config/nvim/lua/*

• cd into AquaFiles

cd ~/AquaFiles/

• if on macOS (you might need to delete DS_Store files)

dir="${1:-.}" && echo "Removing .DS_STORE files from $dir" && find "$dir" -type f -name .DS_STORE -delete && echo "ALL .DS_STORE files have been removed from $dir"

• stow lazyvim

stow nvim

• startup neovim

nvim

• sit back and enjoy the installation

Git setup

xcode-select --install
git --version # check to make sure you have git installed

• cd into AquaFiles

cd ~/AquaFiles/

• stow git

stow git

Zellij setup

• Install Zellij

brew install zellij

• cd into AquaFiles

cd ~/AquaFiles/

• stow zellij

stow zellij

Yabai Setup

• Install Yabai

brew install koekeishiya/formulae/yabai

Disable System Integrity Protection

1. Turn off your device
2. Intel (apple docs):
   Hold down command ⌘+R while booting your device. Apple Silicon (apple docs):
   Press and hold the power button on your Mac until “Loading startup options” appears.
   Click Options, then click Continue.
3. In the menu bar, choose Utilities, then Terminal
4. Disable System Integrity Protection

#
# APPLE SILICON
#

# If you're on Apple Silicon macOS 13.x.x OR newer
# Requires Filesystem Protections, Debugging Restrictions and NVRAM Protection to be disabled
# (printed warning can be safely ignored)
csrutil enable --without fs --without debug --without nvram

# If you're on Apple Silicon macOS 12.x.x
# Requires Filesystem Protections, Debugging Restrictions and NVRAM Protection to be disabled
# (printed warning can be safely ignored)
csrutil disable --with kext --with dtrace --with basesystem

#
# INTEL
#

# If you're on Intel macOS 11.x.x OR newer
# Requires Filesystem Protections and Debugging Restrictions to be disabled (workaround because --without debug does not work)
# (printed warning can be safely ignored)
csrutil disable --with kext --with dtrace --with nvram --with basesystem

5. Reboot
6. For Apple Silicon; enable non-Apple-signed arm64e binaries

# Open a terminal and run the below command, then reboot
sudo nvram boot-args=-arm64e_preview_abi

7. You can verify that System Integrity Protection is turned off by running csrutil status, which returns System Integrity Protection status: disabled. if it is turned off (it may show unknown for newer versions of macOS when disabling SIP partially).

If you ever want to re–enable System Integrity Protection after uninstalling yabai; repeat the steps above, but run csrutil enable instead at step 4.

Configure Scripting Additions

Why do you need scripting additions?

yabai uses the macOS Mach APIs to inject code into Dock.app; this requires elevated (root) privileges. You can configure your user to execute yabai --load-sa as the root user without having to enter a password. To do this, we add a new configuration entry that is loaded by /etc/sudoers.

If you know what you are doing, the following one-liner can be used to update the sudoers file correctly:

echo "$(whoami) ALL=(root) NOPASSWD: sha256:$(shasum -a 256 $(which yabai) | cut -d " " -f 1) $(which yabai) --load-sa" | sudo tee /private/etc/sudoers.d/yabai


# Verify that it worked
sudo visudo -f /private/etc/sudoers.d/yabai

lastly make sure to uncomment the last line from the sudoers file

sudo visudo -f /private/etc/sudoers

it should read

#includedir /private/etc/sudoers.d (sometimes it has 2 ## it should only have 1)

finaly reboot your mac

Test Scripting Additions

yabai -m space --focus recent

the intented result should be that you change your window focus, if not you did not correctly add the scripting additions

stow config

• cd into AquaFiles

cd ~/AquaFiles/

• stow yabai

stow yabai

• start yabai service

yabai --start-service

skhd setup

• Install skhd

brew install koekeishiya/formulae/skhd

• start service

skhd --start-service

• cd into AquaFiles

cd ~/AquaFiles/

• stow zellij

stow skhd

Live Streaming on YouTube

Documenting my journey of continuous learning and exploration in cutting-edge technologies including:

• AI/ML
  • AI Agents
  • Gen AI
• Indie Hacking
• Building in Public
• UI/UX Design
• Next.js
• Typescript
• Python

Join me as I document my growth, share insights, and delve into the ever-evolving world of tech innovation.
0xAquaWolf YouTube Channel

Apps i use

MacOS

(Programming, Content creation, Writing)

• Wezterm - Terminal
• Homebrew - Package manager
• Raycast - App Launcher
• Obsidian - Sync through iCloud
• Yabai - Window Manager
• SKHD - Keyboard Shortcut Manager
• Karabiner Elements - Hypermod and sublayers
• Shortcat - Vim for the desktop
• KeyCastr - For keyboard casting of shortcuts
• Cursor AI - AI Code Editor | Built to make you extraordinarily productive, Cursor is the best way to code with AI.
  • Vim (Vim motions FTW!!!!)
  • Catppuccin for VSCode
  • Catppuccin Icons for VSCode
  • Clock in status bar (Hide ENV Variables on stream)
  • Code Runner
  • DotENV
  • Cloak (HIDE ENV for streaming)
  • TODO Highlight
  • Rainbow CSV
  • Data Wrangler
  • Even Better TOML
  • Markdown Preview Enhanced
  • Markdown Checkboxes
  • Python Dev Env
    • Python (Includes Python Debugger)
    • Pylance (LSP)
    • Black Formatter
    • Jupyter (Includes Jupyter Notebook support)
      • Jupyter Cell Tags
      • Jupyter Keymap
      • Jupyter Notebook Renderers
      • Jupyter Slide Show

Chrome Extensions

• Vimium
• Wappalyzer
• Dark Reader - with Catppuccin Mocha theme
• uBlock Origin
• 1Password
• Undistracted
• Bypass Paywalls
• Responsive Viewer
  • Mobile responsive viewer for web development
• Return YouTube Dislike
  • Shows dislikes on YouTube videos
• WhatFont
  • Identifies fonts used on web pages
• FireShot
  • Captures full screenshots of web pages
• MetaMask
  • Ethereum wallet and gateway to blockchain apps
• View Stats
  • Shows view count for YouTube videos
• Google Search Location Changer
  • Changes your Google search location
• React Developer Tools
  • Debugging tools for React applications

Desktop Apps

• Ableton Live 12 - DAW
• Affinity Photo - Professional image editing software
• Android File Transfer - File transfer tool for Android devices
• Binaural - Binaural beats generator
• LuLu - Security and network traffic blocker
• CleanShot X - Advanced screenshot and screen recording tool
• Gestimer - Simple menubar timer
• IINA - Modern video player
• KeyboardCleanTool - Tool to clean your keyboard
• Audio Hijack - Advanced audio recording software
• Memory Clean 3 - Memory optimization tool
• Parallels - Virtual machine software
• CrossOver - Run Windows applications on macOS
• Rize - Productivity tracker for macOS
• Screen Studio - Screen recording and editing tool
• ScreenFlow - Screen recording and video editing software
• TablePlus - Database manager
• The Unarchiver - File extraction utility
• xScope - Set of tools for UI/UX Designers
• Bartender 5 - macOS Menubar management
• Keka - File compression and extraction
• Voicemod - Real-time voice changer
• OBS - Open source video recording and live streaming
• Kaleidoscope - File and image comparison tool
• AlDente - macOS Battery Manager
• Dynamic Wallpaper - Wallpaper changer for macOS
• ColorSlurp - Color picker and organizer
• Elgato Stream Deck - Customizable control panel
• Farrago - Soundboard for macOS
• iTubeGo - YouTube video downloader

Footer

Join the Community on Discord

AquaWolf Academy: https://discord.gg/wzPBjEcn87

Star History

Todo List

• add links for apps i use
• neovim setup
• fish setup
• git setup
• Zellij setup
• skhd setup
• yabai setup
• obsidian setup & config
• vs code setup & config
• document how to use GNU Stow with my dotfiles
• add a quick start guide (use this for video)
• add a video showing how to bootstrap the install and using the config
• update screenshots with new tools that i'm using and display them