Computer-Setup

Useful programs and packages for a computer.

Setup

One entrypoint installs everything on macOS, Linux desktop (Ubuntu/Arch), and the Linux server; the platform is auto-detected:

bash setup.sh [--optional] [--work] [--personal] [--dry-run]
bash setup.sh --profile server          # headless server (never auto-detected)
bash setup.sh --platform <macos|ubuntu|arch|server>   # force platform

Already provisioned and only want the shared configs refreshed? --dotfiles deploys ~/.zshrc, ~/.tmux.conf, ~/.zsh_plugins.txt, and ~/.p10k.zsh without installing any packages. A changed file is backed up first — except ~/.zsh_plugins.txt, which is overwritten in place, so keep custom Antidote plugins somewhere else:

bash setup.sh --dotfiles --dry-run      # preview
bash setup.sh --dotfiles

Afterwards, check what's installed (read-only):

bash verify.sh [--optional] [--work] [--personal] [--all]

Package data lives in packages.json; the engine is lib/core.sh with per-platform quirks in platforms/. The per-folder setup.sh scripts (and the macOS/linux-desktop verify.sh) are thin shims onto these root scripts. See docs/UNIFICATION.md for the design.

For OS-specific software and install instructions, see:

• macOS/README.md
• linux-desktop/README.md — CachyOS
• linux-server/README.md — Ubuntu Server LTS
  • setup.sh installs zsh, eza, bat, fastfetch, tmux, GitHub CLI, Tailscale, and more
  • Homepage dashboard (Docker) — system stats, running service cards with live Docker status
  • Tailscale web UI as a persistent systemd user service
• windows/README.md

For the standardized workstation benchmark suite (Ubuntu 24.04), see benchmarking/README.md.

---

Utilities

Expand

1. Bitwarden | macOS · Linux · Windows | Download | GitHub
   1. Open source password manager
2. Claude | macOS · Windows | Download
   1. Anthropic's AI assistant desktop app
3. Discord | macOS · Linux · Windows | Download
   1. Voice, video, and text chat platform
4. Docker | macOS · Linux · Windows | Download
   1. Containerization platform for building and running isolated application environments
5. Firefox | macOS · Linux · Windows | Download
   1. Open source web browser
6. Notion | macOS · Windows | Download
   1. Notes and project management
7. OBS | macOS · Linux · Windows | Download
   1. Open source broadcasting and recording software
8. Apollo | macOS · Linux · Windows | GitHub
   1. Desktop streaming host — stream your PC to another device
9. Tailscale | macOS · Linux · Windows | Download
   1. Zero-config VPN built on WireGuard — connect all your devices on a private network
10. VLC | macOS · Linux · Windows | Download
    1. Open source media player for nearly every format

Development

Expand

1. VS Code | macOS · Linux · Windows | Download
   1. IDE with extensions
2. GitHub CLI | macOS · Linux · Windows | Download | GitHub | brew
   1. Official GitHub CLI — create PRs, manage issues, clone repos, and run Actions from the terminal
3. pyenv | macOS · Linux | GitHub | brew
   1. Python version and virtual environment manager
4. uv | macOS · Linux · Windows | Docs | GitHub | brew
   1. Fast Python package and project manager — pip/venv/pyenv successor
5. pipx | macOS · Linux · Windows | GitHub | brew
   1. Install Python CLI tools in isolated virtual environments so they don't pollute the global Python install
6. git-lfs | macOS · Linux · Windows | Download | GitHub | brew
   1. Git extension for versioning large binary files (audio, video, datasets, model weights)
7. Hugging Face CLI (hf) | macOS · Linux · Windows | Docs | GitHub | brew
   1. Download, upload, and manage models, datasets, and Spaces on the Hugging Face Hub
8. git-xet | macOS · Linux · Windows | GitHub | brew
   1. Git LFS plugin that uses the Xet protocol for efficient storage of large ML model files on the Hugging Face Hub
9. poppler | macOS · Linux · Windows | Homepage | brew
   1. PDF rendering library that ships CLI utilities: pdftotext, pdfimages, pdfinfo, pdftoppm
10. zsh-autosuggestions | macOS · Linux | GitHub | brew
    1. Fish-style history-based command suggestions for zsh — press → to accept
11. zsh-syntax-highlighting | macOS · Linux | GitHub | brew
    1. Real-time syntax highlighting for zsh — valid commands appear green, invalid ones red, before you press Enter
12. MongoDB Community | macOS · Linux · Windows | Download | brew
    1. Open source document database; the brew tap (mongodb/brew) also installs mongosh and mongodb-database-tools

Entertainment

Expand

1. Spotify | macOS · Linux · Windows | Download
   1. Music streaming
2. Steam | macOS · Linux · Windows | Download
   1. Game library
3. RuneLite | macOS · Linux · Windows | Download | GitHub
   1. Free, open-source Old School RuneScape client with plugins, GPU rendering, and quality-of-life features
4. Jagex Launcher | macOS · Windows | Download
   1. Official launcher for RuneScape and Old School RuneScape — required for Jagex account login
5. Bolt | Linux | Codeberg
   1. Open-source RuneScape/OSRS launcher for Linux — replaces Jagex Launcher which is not available on Linux

Requires Hardware

Expand

1. CyberPower PowerPanel Personal | macOS · Linux · Windows | Download
   1. Monitor and manage CyberPower UPS devices — useful when a power outage occurs
2. Epson Perfection V39 II | macOS · Windows | Download
   1. Document and photo scanner — install Epson Scan 2
3. Epson FastFoto FF-680W | macOS · Windows | Download
   1. High-speed photo scanner — install Epson FastFoto and Epson Scan 2
4. Stream Deck | macOS · Windows | Download
   1. LCD macro key controller

Work

Expand

1. Slack | macOS · Linux · Windows | Download
   1. Team messaging and collaboration
2. Zoom | macOS · Linux · Windows | Download
   1. Video conferencing
3. Microsoft Outlook | macOS · Windows | Download
   1. Email client for Microsoft 365

Cloud Storage & Data Management

Expand

1. Google Drive | macOS · Windows | Download
   1. Google Drive cloud storage desktop client
2. Syncthing | macOS · Linux · Windows | Download | GitHub
   1. Sync files across devices — decentralized, no cloud required