dock.sh

#!/usr/bin/env bash

# Root is $DOTPATH if it exists, otherwise the directory of this script
root=$(realpath "${DOTPATH:-$(dirname "$(realpath "$0")")}")

# Source the bash_traceback.sh file
source "${root}/bash_traceback.sh"

###############################################################################
# Functions for manipulating macOS Dock                                       #
###############################################################################

echo -e "🔧 \033[1;34mConfiguring macOS Dock...\033[0m"

# Load the LaunchServices database into a variable
launchservices_path="/System/Library/Frameworks/CoreServices.framework/Versions/A/Frameworks/LaunchServices.framework/Versions/A/Support/lsregister"
launchservices_dump=$(${launchservices_path} -dump)

function add_app_to_dock {
	# adds an application to macOS Dock
	# usage: add_app_to_dock "Application Name"
	# example add_app_to_dock "Terminal"
	app_name="${1}"
	app_path=$(echo "${launchservices_dump}" | grep -o "/.*${app_name}.app" | grep -v -E "Backups|Caches|TimeMachine|Temporary|/Volumes/${app_name}" | uniq | sort | head -n1)
	if open -Ra "${app_path}"; then
		defaults write com.apple.dock persistent-apps -array-add "<dict><key>tile-data</key><dict><key>file-data</key><dict><key>_CFURLString</key><string>${app_path}</string><key>_CFURLStringType</key><integer>0</integer></dict></dict></dict>"
		echo -e "✅ \033[1;32m${app_path} added to the Dock.\033[0m"
	else
		echo -e "❌ \033[1;31mError: $1 not found.\033[0m" 1>&2
		return 1
	fi
}

function get_app_position_in_dock {
	# returns the 1-indexed position of an application in the macOS Dock
	# usage: get_app_position_in_dock "Application Name"
	# example: get_app_position_in_dock "Arc"
	app_name="${1}"
	persistent_apps=$(defaults read com.apple.dock persistent-apps)

	# Initialize position counter
	position=1

	# Use a while loop to read each app entry
	echo "${persistent_apps}" | grep -o '"file-label"[^;]*;' | while IFS= read -r app; do
		if echo "${app}" | grep -q "\"file-label\" = \"\?${app_name}\"\?;"; then
			echo "${position}"
			return 0
		fi
		((position++))
	done

	# If the app is not found, return 0
	echo "0"
	return 1
}

function add_folder_to_dock {
	# adds a folder to macOS Dock
	# usage: add_folder_to_dock "Folder Path" -s n -d n -v n
	# example: add_folder_to_dock "~/Downloads" -d 0 -s 2 -v 1
	# key:
	# -s or --sortby
	# 1 -> Name
	# 2 -> Date Added
	# 3 -> Date Modified
	# 4 -> Date Created
	# 5 -> Kind
	# -d or --displayas
	# 0 -> Stack
	# 1 -> Folder
	# -v or --viewcontentas
	# 0 -> Automatic
	# 1 -> Fan
	# 2 -> Grid
	# 3 -> List
	folder_path="${1}"
	shift # remove folder_path from args
	sortby="1"
	displayas="0"
	viewcontentas="0"
	while [[ $# -gt 0 ]]; do
		case $1 in
		-s | --sortby)
			if [[ $2 =~ ^[1-5]$ ]]; then
				sortby="${2}"
			fi
			;;
		-d | --displayas)
			if [[ $2 =~ ^[0-1]$ ]]; then
				displayas="${2}"
			fi
			;;
		-v | --viewcontentas)
			if [[ $2 =~ ^[0-3]$ ]]; then
				viewcontentas="${2}"
			fi
			;;
		*)
			echo >&2 "Invalid choice: $1"
			exit 1
			;;
		esac
		shift # shift to next arg
		shift
	done

	if [[ -d ${folder_path} ]]; then
		defaults write com.apple.dock persistent-others -array-add "<dict>
				<key>tile-data</key> <dict>
					<key>arrangement</key> <integer>${sortby}</integer>
					<key>displayas</key> <integer>${displayas}</integer>
					<key>file-data</key> <dict>
						<key>_CFURLString</key> <string>file://${folder_path}</string>
						<key>_CFURLStringType</key> <integer>15</integer>
					</dict>
					<key>file-type</key> <integer>2</integer>
					<key>showas</key> <integer>${viewcontentas}</integer>
				</dict>
				<key>tile-type</key> <string>directory-tile</string>
			</dict>"
		echo -e "✅ \033[1;32m${folder_path} added to the Dock.\033[0m"
	else
		echo -e "❌ \033[1;31mError: ${folder_path} not found.\033[0m" 1>&2
		return 1
	fi
}

function add_spacer_to_dock {
	# adds an empty space to macOS Dock
	defaults write com.apple.dock persistent-apps -array-add '{"tile-type"="small-spacer-tile";}'
}

function clear_dock {
	# removes all persistent icons from macOS Dock
	if [[ "$(defaults read com.apple.dock persistent-apps | wc -l)" -gt 0 ]]; then
		defaults write com.apple.dock persistent-apps -array
	fi
	if [[ "$(defaults read com.apple.dock persistent-others | wc -l)" -gt 0 ]]; then
		defaults write com.apple.dock persistent-others -array
	fi
	killall Dock
}

function reset_launchpad {
	# resets Launchpad so that all apps appear in their default order
	defaults write com.apple.dock ResetLaunchPad -bool true
	# this is needed on macOS 15.2 and above
	rm -rf /private"$(getconf DARWIN_USER_DIR)"com.apple.dock.launchpad
}

###############################################################################
# Configure macOS Dock                                                        #
###############################################################################
reset_launchpad
clear_dock

add_app_to_dock "Arc"
add_app_to_dock "Obsidian"
add_app_to_dock "Todoist"
add_app_to_dock "Slack"
add_app_to_dock "Cursor"
add_app_to_dock "Ghostty"
add_app_to_dock "System Settings"
add_folder_to_dock "${HOME}/Downloads" --sortby 2 --displayas 1 --viewcontentas 1

killall Dock