mirror of
https://github.com/wickedyoda/public-setupfiles.git
synced 2026-11-16 13:31:56 -06:00
docs: add READMEs and wiki documentation for all directories
- 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>
This commit is contained in:
1 parent
b40aaf6f0e
commit
0c62f7495a
42 files changed
+4501
-865
No files matched your search
@@ -0,0 +1,152 @@
|
||||
# macOS Scripts
|
||||
|
||||
macOS automation and system management utilities.
|
||||
|
||||
---
|
||||
|
||||
## System Updates
|
||||
|
||||
### `mac-scripts/updates.sh`
|
||||
|
||||
Update Homebrew and system packages.
|
||||
|
||||
```bash
|
||||
# Update Homebrew
|
||||
brew update && brew upgrade
|
||||
|
||||
# Update Casks
|
||||
brew upgrade --cask
|
||||
|
||||
# Clean up
|
||||
brew cleanup
|
||||
brew autoremove
|
||||
```
|
||||
|
||||
**macOS Software Update:**
|
||||
```bash
|
||||
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:**
|
||||
```bash
|
||||
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.
|
||||
|
||||
```bash
|
||||
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
|
||||
|
||||
```bash
|
||||
# 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
|
||||
|
||||
```bash
|
||||
# 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
|
||||
Reference in new issue
Block a user