dots: A Python repository from egeesin

Personal configurations of CLI/GUI softwares, package lists and settings for Win11, macOS, Arch Linux.

Run the script at your own risk or inspect through lots of configs you need.

Status

Most updated configurations and setup scripts are made for Windows in a separate directory.
Tested on macOS 10.14+ with Intel architecture.
It's been over 5 years on Arch Linux stuff, some of the packages and configurations might be deprecated.

Recommended for usage on particular configuration files. Setup scripts might not be suited for everyone.

Installation

Installation scripts for both macOS and Windows are meant to be ran on a formatted/fresh machines. Reinstallation on an existing machines definitely not recommended.

install.sh will,

Download & install packages from respective package managers for macOS or Arch Linux
- Package list is separated into 5 self-explanatory bundles: minimal, essential, extras (CLI/TUI tools), GUI applications and gaming. During the execution, script will ask bundle to choose.
Create symlinks to reconfiguration files.
- Note: Existing configs will be renamed after symlinking process (e.g. .tmux.conf -> .tmux.conf.old)
Change macOS defaults and dock arrangements
Execute noninvolved ~/.extra/install.sh file if exists. (Not mandatory)

For macOS or GNU/Linux distros:

# Clone the repository to your local machine.
git clone https://github.com/egeesin/dots ~/.dots

# Change directory to .dots
cd ~/.dots

# Make sure scripts are executable
chmod +x ./install.sh ./link.sh bin/*

# Begin the installation.
./install.sh

For Windows:

Invoke-Expression (New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/egeesin/dots/main/install.ps1')

Remote

# w/curl:
sh -c “`curl -fsSL https://github.com/egeesin/dots/raw/master/remote-install.sh`”

# w/wget:
sh -c “`wget -O - --no-check-certificate https://github.com/egeesin/dots/raw/master/remote-install.sh`”

Installation on Windows

All Windows related configurations and installation scripts are isolated in win/ directory.

Scripts hasn't tested yet, relevant updates and more detailed installation steps will be added in this section. Further necessary information included in win/README.md.

On a fresh Windows 11 installation

Complete setting computer name, privacy/cloud settings etc. in the first startup if you haven't already.
Right click on Windows icon in the taskbar at the bottom.
In the context menu, select "Windows PowerShell (Admin)"
- If that menu item doesn't exist, select "Terminal (Admin)" instead.
- After selection, if User Account Control window pops up, confirm that you want to allow this app to make changes to your device by clicking "Yes".

Execute command below:

Set-ExecutionPolicy Bypass -Scope Process -Force; .\install.ps1

On a existing Windows 11 installation

I highly recommend to backup your machine, creating a system restore point before executing whole initial setup process in an administrative level.

Installation on macOS/any Linux distribution

Will be added later...

CLI Helper Usage

Tested on macOS and Arch Linux only.

dots <command>

Commands:
   help        This help message
   edit        Open dots in editor
   reload      Reload shell configuration
   link        Relink configurations
   test        Run tests
   up          Update packages and pkg managers (npm, pip, macOS, brew, gem, pacman, pacaur)
   clean       Clean up caches (brew, npm, gem, rvm)
   defaults    Apply macOS system defaults
   dock        Apply macOS dock placements
   install     Install packages listed from the dots/install (e.g. dots install npm)

Auto Dark Mode in Mac Setup

In order to make auto dark feature work in Alacritty and Vim for macOS, do the following… Note: Find your <user_id> from id -u

touch /tmp/dark-mode-notify-{stderr,stdout}.log
cp .extra/backup/com.egeesin.dark-mode-notify.plist ~/Library/LaunchAgents/
launchctl bootstrap gui/<user_id> ~/Library/LaunchAgents/com.egeesin.dark-mode-notify.plist
launchctl kickstart gui/<user_id>/com.egeesin.dark-mode-notify

Roadmap

Lighter and re-usable installation options suitable for development on remote servers and Windows.
More Windows related configurations and complex scripts
"Features" and "Preview" section in README

Credits

install.sh, remote-install.sh, command line tool, mackup, directory structure, etc. - webpro.
Symlinking system - olzraiti
macOS defaults - mathiasbynens
i3, mpd and ncmpcpp configs - mohabaks
Tmux config - gpakosz
Win 10 / Server 2016 / Server 2019 Initial Setup Script by Disassembler
Install Script for Windows by xeho91
Function and alias definitions by jayharris
Symlinking in Windows by SARDONYX-sard

egeesin/dots