Skip to content

Latest commit

 

History

History
144 lines (105 loc) · 6.01 KB

README.md

File metadata and controls

144 lines (105 loc) · 6.01 KB
Raw

dots ASCII Art

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

Useful Sources