Notes: this repo contains submodules, use --recurse-submodules when cloning this repo to get all the modules:

git clone --recurse-submodules https://github.com/hbthen3rd/dotfiles.git
# or
git clone --recurse-submodules [email protected]:hbthen3rd/dotfiles.git

• M2 MacBook Air / macOS Sonoma 14.2.1

• System Preferences > Desktop and Dock (bold is required):
  • Mission Control: uncheck "Automatically rearrange Spaces based on most recent use"
  • Desktop & Stage Manager:
    • Show Items: uncheck "On Desktop"
    • Set "Click wallpaper to reveal desktop" to "Always"
  • Widgets:
    • Show Widgets: uncheck "On Desktop"
    • Set "Widget style" to "Full-color"
• Some advanced features of yabai requires SIP to be disabled. However, disabling SIP will also disable Apple Pay on your Mac. For my setup, I left SIP enabled. My configs doesn't use any advanced feature from yabai

• Font: CaskaydiaCove Nerd Font
• Creates exactly 7 workspaces/desktops
• System Preferences (bold is required):
  • Desktop and Dock > Dock:
    • Check "Automatically hide and show the Dock"
  • Control Center > Menu Bar Only:
  • Set "Automatically hide and show the menu bar" to "Always"

• System Preferences > Keyboard > Keyboard Shortcuts... (bold is required):
  • For each of the item on the left side bar > click "Restore Defaults"
  • Mission Control > Make sure everything under Mission Control is checked (Move left/right, switch to desktop 1/2/etc.)

• Theme: Gruvbox Dark (Hard)
• iTerms integration

• Font: CaskaydiaCove Nerd Font
• Color scheme: Gruvbox Dark (Hard)
• Profile: Window tweaks (Transparency, Blur radius, No Title Bar style)

• Plugin manager: Oh My Zsh
• Plugins:
  • zsh-autosuggestions
  • zsh-syntax-highlighting
  • Powerlevel10k

	Ranger	Finder
Code preview
Image preview

• Install from HEAD commit instead of pre-built binary: brew install --HEAD ranger
• File preview dependencies (bold is required):
  • ImageMagick
  • librsvg (rsvg-convert)
  • djvulibre (ddjvu)
  • ffmpeg
  • ffmpegthumbnailer
  • poppler (pdftoppm)
  • fontforge (fontimage)
  • pandoc
  • mu
  • xlsx2csv: pip3 install xlsx2csv
  • exiftool
  • media-info (mediainfo)
  • binutils (readelf)
  • rar (unrar)
  • p7zip (7z)
  • odt2txt
  • w3m
  • jq

• cmd + 3 to View as Columns
• cmd + shift + . to Show Hidden files

	Neovim	Visual Studio Code
Intellisense
Terminal
File search
Source control
Command palette

• Plugin manager + Starter template: LazyVim
  • rg
  • fd
  • lazygit
• Misc:
  • Run :checkhealth and install all dependencies
  • pynvim
  • neovim ruby
  • neovim node
  • neovim perl

• Fonts:
  • Editor: Cascadia Code
  • Terminal: CaskaydiaCove Nerd Font
• Gruvbox Theme
• vscode-icons
• Fluent Icons
• Apc Customize UI++
  • Allow VSCode to modify itself:

    sudo chown -R $(whoami) $(which code)
    sudo chown -R $(whoami) /Applications/Visual Studio Code.app/Contents/Resources/app/out

• Apply settings.json
• Open Command Palette by pressing cmd + shift + P > enter Enable Apc extension > hit return
• Quit and restart VSCode

	Firefox	Arc
Web page
New tab page

• Firefox Onebar theme with the following about:config:

  • onebar.hide-all-URLbar-icons            : true
    onebar.disable-autohide-of-URLbar-icons : false
    onebar.disable-https-truncate           : false
    onebar.disable-centering-of-URLbar      : false
    onebar.disable-single-tab               : true
    onebar.hide-unified-extensions-button   : false
    onebar.hide-all-tabs-button             : false
    onebar.conditional-navigation-buttons   : false
    onebar.hide-navigation-buttons          : false
    

• Color and layout tweaks to Browser XUL and :about pages to match Gruvbox Dark (Hard) color (Firefox Onebar included)
  • Only Dark theme is supported, no light theme or high-contrast theme support

• btop
• cat > bat
• find > fd
• fzf
  • fzf fd integration in part of shell config
• grep > ripgrep (rg)
• ls > eza
• neofetch
• pipes-sh (pipes.sh)
• ps > procs
• Taskwarrior (task)
  • Timewarrior (timew)
  • taskwarrior-tui
• tty-clock
• unimatrix: pip3 install git+https://github.com/will8211/unimatrix.git