sdevore / dotfiles

macOS System Configuration with Fish, Package Control, VS Code, Repo management, Hammerspoon

Dotfiles

Read about dotfiles in my blog post!

Usage

1. Restore your safely backed up ssh keys to ~/.shh/
   1. Alternatively, generate new ssh keys, and add these to your GitHub account
2. Install Homebrew and git

ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
brew install git

3. Clone this repository

git clone [e-mail]:rkalis/dotfiles.git

4. Run the bootstrap.sh script
   1. Alternatively, only run the setup.sh scripts in specific subfolders if you don't need everything
5. (Optional) Install missing applications from the internet

• Popcorn Time
• Pyxel Edit
• UvAVPN

6. (Optional) Point the Alfred preference sync to the right folder
7. (Optional) Point the Microsoft Remote Desktop folder to the right folder

Customisation

I strongly encourage you to play around with the configurations, and add or remove features. If you would like to use these dotfiles for yourself, I'd recommend changing at least the following:

Git

• The .gitconfig file includes my [user] config, replace these with your own user name and email

OSX

• At the top of the setup.sh file, my computer name is set, replace this with your own computer name

Packages

This folder is a collection of the programs and utilities I use frequently. These lists can easily be amended to your liking.

Repos

This folder is a collection of my own repos, some of which are even private. The existing lists can easily be edited or replaced by custom lists.

Caveats

• I haven't found a way to automate or save Bartender config

Contents

Root (/)

• bootstrap.sh - Calls all setup.sh scripts

User Bin (bin/)

• setup.sh - Symlinks the other contents of the folder to ~/bin/
• imgcat - A utility to display images inline in iTerm 2
• sethidden - A shell script which takes command line arguments to show or hide hidden files
• togglehidden - A shell script that toggles between showing and hiding hidden files

Duti (duti/)

• setup.sh - Sets the defaults set up in the different files
• app.package.id - Contains all extensions for the specified program

Fish (fish/)

• setup.sh - Symlinks all fish files to their corresponding location in ~/.config/fish/
• config.fish - Global fish configuration (.fishrc)
• completions/
  • repo.fish - Contains all repos as completions for the repo command
• functions/
  • abbrex.fish - Utility for expanding abbreviations in fish-scripts
  • clear.fish - Clears the screen and shows fish_greeting
  • emptytrash.fish - Empties trash and clears system logs
  • fish_greeting.fish - My personal fish greeting using the full-colour fish logo
  • fish_prompt.fish - The Classic + Git prompt from the fish web config
  • forrepos.fish - Executes a passed command for all repos in ~/repos
  • ls.fish - Calling ls with parameter --color=auto
  • pubkey.fish - Copies the public key to the clipboard
  • repo.fish - Finds a repository in ~/repos and jumps to it
  • setup.fish - Initial setup for a new fish installation, contains abbreviations
  • update.fish - Installs OS X Software Updates, updates Ruby gems, Homebrew, npm, and their installed packages
  • week.fish - Returns the current week number

Git (git/)

• setup.sh - Symlinks all git files to ~/
• .gitignore_global - Contains global gitignores, such as OS-specific files and several compiled files
• .gitconfig - Sets several global Git variables

Hammerspoon (hammerspoon/)

• setup.sh - Symlinks all lua and AppleScript files to ~/.hammerspoon/
• init.lua - Contains the main Hammerspoon config, importing the others
• asim.lua - Utility for using applescript files
• fullscreen.applescript - Toggles Fullscreen for the current application
• hyper.lua - Binds the "F18" key to a Hyper mode, which can be used for global commands
• spectacle.lua - Window and monitor management using hyper mode
• togglevpn.applescript - Toggles Viscosity vpn connection
• togglevpn.lua - Binds a shortcut to the execution of togglevpn.applescript

Karabiner (karabiner/)

• setup.sh - Symlinks Karabiner settings to ~/.config/karabiner
• karabiner.json - Binds the CAPS LOCK key to "F18" to use with hammerspoon

macOS Preferences (macos/)

• setup.sh - Executes a long list of commands pertaining to macOS Preferences

Packages (packages/)

• setup.sh - Installs the contents of the .list files and the Brewfile

Python (python/)

• setup.sh - Creates the conda envs for the .list files, and installs their contents to the specific envs

Repositories (repos/)

• setup.sh - Clones the repositories in the .list files at the corresponding locations

Helper Scripts (scripts/)

• symlink.sh - Symlinks a file from a source path to a destination path in a verbose way, unlinking the existing file first, might it exist

Vim (vim/)

• setup.sh - Symlinks all vim files to ~/
• .vimrc - Basic Vim configuration

Visual Studio Code (vscode/)

• setup.sh - Symlinks the settings.json file to ~/Library/Application Support/Code/User
• settings.json - Contains user settings for Visual Studio Code