dot42

Description

The aim of this application is to reliably manage settings and brew packages for students from the 42 Network on school computers.

Usage

Installing dot42

To install dot42, type the following command in your terminal

note: it it heavily recommanded to run this command on a clean session where brew is not yet installed locally.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/30c27b/dot42/master/scripts/install.sh)"

What does it do ?

When you run the installation script, the following actions will be executed:

• this repository will be cloned to ~/.42
• a LaunchAgent daemon will be added to ~/Library/LaunchAgents and run the login.sh script at each login
• the dot42 binary will install Homebrew in your home directory and the packages in configs/Brewfile
• the path to brew will be added to your .zshrc.

By default, the script will install Homebrew according to the following tree:

📦 ~
 ┣ 📜 .zshrc
 ┣ 📂 usr
 ┃ ┣ 📂 Homebrew
 ┃ ┃ ┗ 📜 (Brew repository)
 ┃ ┗ 📂 bin
 ┃   ┗ 📜 (your binaries)
 ┗ 📂 Applications
   ┗ 📜 (your applications)

Settings

Settings can be modified at ~/.42/configs/config.json.

1. Homebrew will be installed according to this tree (with [example] corresponding to the "example" entry in config.json)

Installation tree

📦 ~
 ┣ 📜 [zshrcPath]
 ┣ 📂 [brewPath]
 ┃ ┣ 📂 [brewName]
 ┃ ┃ ┗ 📜 [brewRepository] (is cloned here)
 ┃ ┗ 📂 bin
 ┃   ┗ 📜 (your binaries)
 ┗ 📂[brewCaskPath]
   ┗ 📜 (your applications)

Correspondig settings

{
	"brewPath": "usr",
	"brewCaskPath": "Applications",
	"brewName": "Homebrew",
	"brewRepository": "https://github.com/Homebrew/brew.git",
	"zshrcPath": ".zshrc"
}

1. The dark theme can be set here:

{
	"darkTheme": true
}

1. You can change macOS defaults settings by adding them to the defaults parameter in this format:

{
	"defaults": [
		{
			"domain": "Apple Global Domain",
			"key": "com.apple.swipescrolldirection",
			"valueType": "bool",
			"value": "false"
		}
	]
}

note: To update your settings without delogging, type ~/.42/bin/dot42 load.

Copyright

dot42 is distributed under the ISC license.