f647e8de78
- Change install URL from https://static.due.ren/install.sh to https://git.due.ren/andreas/mac_os/raw/branch/main/install.sh - Update README.adoc with correct git repository URL - Update QUICK_INSTALL.md with current package list and correct URLs - Remove outdated hosting instructions for static.due.ren Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
159 lines
4.5 KiB
Plaintext
159 lines
4.5 KiB
Plaintext
= macOS Installer
|
|
|
|
Opinionated shell scripts for automated macOS machine setup via Homebrew and Mac App Store.
|
|
|
|
== Features
|
|
|
|
* Installs link:https://developer.apple.com/xcode[Xcode Command Line Tools]
|
|
* Installs link:http://brew.sh[Homebrew] with proper PATH configuration
|
|
* Installs Homebrew formulas (CLI tools)
|
|
* Installs Homebrew casks (GUI applications)
|
|
* Installs link:http://www.apple.com/macosx/whats-new/app-store.html[App Store] software via mas
|
|
* Installs Google Fonts (Barlow, Barlow Semi Condensed, Poppins)
|
|
* Provides interactive CLI for step-by-step installation
|
|
* Includes web-based installer generator at https://install.due.ren
|
|
|
|
== Quick Install
|
|
|
|
For a fresh macOS machine, run:
|
|
|
|
[source,bash]
|
|
----
|
|
curl -fsSL https://git.due.ren/andreas/mac_os/raw/branch/main/install.sh | bash
|
|
----
|
|
|
|
This single command installs everything automatically. See link:QUICK_INSTALL.md[Quick Install Guide] for details.
|
|
|
|
== Requirements
|
|
|
|
* macOS (tested on Apple Silicon and Intel)
|
|
* Internet connection
|
|
* Mac App Store account (for App Store installations)
|
|
|
|
== Manual Installation
|
|
|
|
Clone and run interactively:
|
|
|
|
[source,bash]
|
|
----
|
|
git clone https://git.due.ren/andreas/mac_os.git
|
|
cd mac_os
|
|
bin/run
|
|
----
|
|
|
|
You will be presented with the following options:
|
|
|
|
....
|
|
Install:
|
|
b: Install basics (fonts).
|
|
t: Install development tools (Xcode CLI).
|
|
hf: Install Homebrew Formulas.
|
|
hc: Install Homebrew Casks.
|
|
m: Install Mac App Store software.
|
|
i: Install all (executes all install options in order).
|
|
Manage:
|
|
c: Check status of installed software.
|
|
C: Caffeinate machine (prevent sleep during installation).
|
|
w: Clean work (temp) directory.
|
|
q: Quit/Exit.
|
|
....
|
|
|
|
Choose option `i` to run a full install or select a specific option to run a single action. Each option is designed to be re-run if necessary.
|
|
|
|
Pass the option directly to skip the prompt: `bin/run i`
|
|
|
|
== Web Generator
|
|
|
|
Visit https://install.due.ren to build a custom installer with your preferred software selections. The generator creates a standalone bash script you can download and run on any Mac.
|
|
|
|
== What's Installed
|
|
|
|
=== Homebrew Formulas (CLI Tools)
|
|
* atuin - Shell history manager
|
|
* bash - Updated bash shell
|
|
* bash-completion - Bash completions
|
|
* claude-cli - Claude AI CLI
|
|
* gemini-cli - Gemini AI CLI
|
|
* node - Node.js runtime
|
|
* ffmpeg - Media processing
|
|
* mas - Mac App Store CLI
|
|
* mole - SSH tunneling
|
|
* rename - Rename utility
|
|
* ykman - YubiKey manager
|
|
|
|
=== Homebrew Casks (GUI Applications)
|
|
* eloston-chromium - Ungoogled Chromium browser
|
|
* deepl - DeepL translator
|
|
* element - Matrix client
|
|
* signal - Signal messenger
|
|
* nextcloud - Nextcloud sync client
|
|
* proton-drive - Proton Drive
|
|
* proton-mail - Proton Mail
|
|
* protonvpn - Proton VPN
|
|
* codex - AI coding assistant
|
|
* codexbar - AI assistant menu bar (steipete/tap)
|
|
* nova - Nova text editor
|
|
* transmit - FTP/SFTP client
|
|
* trimmy - Video trimming tool
|
|
|
|
=== Mac App Store Applications
|
|
* Bitwarden (1352778147) - Password manager
|
|
* Invoice Ninja (1503970375) - Invoicing
|
|
* Numbers (409203825) - Spreadsheets
|
|
* Pages (409201541) - Word processor
|
|
* PastePal (1503446680) - Clipboard manager
|
|
* xSearch (1579902068) - Search tool
|
|
|
|
=== Fonts
|
|
* Barlow - Google Font (full family)
|
|
* Barlow Semi Condensed - Google Font (full family)
|
|
* Poppins - Google Font (full family)
|
|
* Berkeley Mono - Full family (Regular, Bold, Oblique, Bold-Oblique)
|
|
|
|
== Customization
|
|
|
|
All installation scripts are in the `bin` folder:
|
|
|
|
* `bin/install_basics` - Installs custom fonts
|
|
* `bin/install_dev_tools` - Installs Xcode Command Line Tools
|
|
* `bin/install_homebrew_formulas` - Installs CLI tools via Homebrew
|
|
* `bin/install_homebrew_casks` - Installs GUI apps via Homebrew
|
|
* `bin/install_app_store` - Installs Mac App Store applications
|
|
* `bin/run` - Main CLI interface
|
|
|
|
Edit these files to customize your installation. The `lib` folder provides helper functions for Homebrew installation, verification, and system utilities.
|
|
|
|
== Project Structure
|
|
|
|
----
|
|
mac_os/
|
|
├── bin/ # Installation scripts
|
|
├── lib/ # Helper libraries
|
|
├── fonts/ # Custom fonts to install
|
|
├── website/ # Web-based installer generator
|
|
├── install.sh # Single-file installer for hosting
|
|
└── README.adoc # This file
|
|
----
|
|
|
|
== Development
|
|
|
|
To contribute:
|
|
|
|
[source,bash]
|
|
----
|
|
git clone https://git.due.ren/andreas/mac_os.git
|
|
cd mac_os
|
|
----
|
|
|
|
Make your changes and submit a pull request.
|
|
|
|
== License
|
|
|
|
MIT License
|
|
|
|
== Credits
|
|
|
|
Forked and simplified from link:https://github.com/bkuhlmann/mac_os[bkuhlmann/mac_os].
|
|
|
|
Customized by link:https://due.ren[Andreas Dünnebacke].
|