- Add comprehensive wiki documentation under .github/wiki/ (19 articles) - Add READMEs to directories that lacked them - Fix merge conflict markers in existing READMEs - Update root readme.md with improved structure Co-authored-by: Jarvis <jarvis@wickedyoda.local>
2.5 KiB
2.5 KiB
macOS Scripts
macOS automation and system management utilities.
System Updates
mac-scripts/updates.sh
Update Homebrew and system packages.
# Update Homebrew
brew update && brew upgrade
# Update Casks
brew upgrade --cask
# Clean up
brew cleanup
brew autoremove
macOS Software Update:
softwareupdate -l # List available
softwareupdate -i -a # Install all
mac-scripts/system_updates.sh
Interactive system update script.
Features:
- macOS Software Update
- Homebrew update
- NPM update
- Pip packages update
mac-scripts/brewscripts/update-brew-packages.sh
Remove deprecated Homebrew casks.
Usage:
brew install --cask gstreamer # Install replacement
./mac-scripts/brewscripts/update-brew-packages.sh
.DS_Store Management
mac-scripts/disable_DS_store.sh
Disable .DS_Store creation on network volumes.
defaults write com.apple.desktopservices DSDontWriteNetworkStores -bool TRUE
mac-scripts/DS_STore_destroy.sh
Comprehensive .DS_Store cleanup.
Features:
- Disable on USB/Network volumes
- Add to global git ignore
- Delete existing files
- Restart Finder
Window Management
mac-scripts/tile-windows/
One-click window tiling using Hammerspoon.
Files
| File | Purpose |
|---|---|
hammerspoon-init.lua |
Tiling logic |
tile-windows.applescript |
Clickable app |
Setup
# 1. Install Hammerspoon
brew install --cask hammerspoon
# 2. Copy config
cp mac-scripts/tile-windows/hammerspoon-init.lua ~/.hammerspoon/init.lua
# 3. Reload Hammerspoon
hs -c "hs.reload()"
Usage
- Keyboard:
Cmd+Ctrl+T - Dock: Drag "Tile Windows.app" to Dock
- Menu: Hammerspoon menubar → Reload All
Homebrew Scripts
mac-scripts/brewscripts/
| Script | Purpose |
|---|---|
update-brew-packages.sh |
Update Homebrew + casks |
README.md |
Documentation |
Tools Installed
The macOS setup installs these tools:
| Category | Tools |
|---|---|
| Development | git, python, node |
| Networking | wireshark, nmap, openvpn |
| Multimedia | vlc, ffmpeg |
| Utilities | bashtop, htop |
| Productivity | keepassxc, libreoffice |
Usage
# Run a script
./mac-scripts/updates.sh
# Or with Zsh
zsh mac-scripts/system_updates.sh
Note: Some scripts require Hammerspoon accessibility permissions.
Grant Permissions
System Settings → Privacy & Security → Accessibility → Add Hammerspoon.app