I will update your MacOS machine with Betterā¢ system defaults, preferences, software configuration and even auto-install some handy development tools and apps that my developer friends find helpful.
You don't need to install or configure anything upfront! This works with a brand-new machine from the factory as well as an existing machine that you've been working with for years.
- Forget About Manual Configuration!
- Watch me run!
- Installation
- 3.x.x+ Upgrade Instructions!
- Additional
- Settings
- SSD-specific tweaks
- General System Changes
- Security
- Trackpad, mouse, keyboard, Bluetooth accessories, and input
- Configuring the Screen
- Finder Configs
- Dock & Dashboard
- Configuring Hot Corners
- Configuring Safari & WebKit
- Configuring Mail
- Spotlight
- iTerm2
- Time Machine
- Activity Monitor
- Address Book, Dashboard, iCal, TextEdit, and Disk Utility
- Mac App Store
- Messages
- SizeUp.app
- Software Installation
- License
- Contributions
- Loathing, Mehs and Praise
- ĀÆ\(ć)/ĀÆ Warning / Liability
Don't you hate getting a new laptop or joining a new team and then spending a whole day setting up your system preferences and tools? Me too. That's why we automate; we did it once and we don't want to do have to do it again.
\[^_^]/ - This started as Adam Eivy's MacOS shell configuration dotfiles but has grown to a multi-developer platform for machine configuration.
When I finish with your machine, you will be able to look at your command-line in full-screen mode like this (running iTerm):
Check out how your shell prompt includes the full path, node.js version & the working git branch along with a lot of other info!
We use powerlevel9k for command prompt, so customization of what you want is easily changable in ./.zshrc
The top terminal is using vim + NerdTree as a full Atom replacement IDE.
The bottom left two are git terminals.
The bottom right is running vtop
To launch fullscreen, hit Command + Enter
in iTerm, then use Command + d
and Command + D
to create split panes.
\[._.]/ - I'm so excited I just binaried in my pants!
Note: I recommend forking this repo in case you don't like anything I do and want to set your own preferences (and pull request them!)
REVIEW WHAT THIS SCRIPT DOES PRIOR TO RUNNING: https://github.com/atomantic/dotfiles/blob/master/install.sh#L275-L1038 It's always a good idea to review arbitrary code from the internet before running it on your machine with sudo power! You are responsible for everything this script does to your machine (see LICENSE)
git clone --recurse-submodules https://github.com/atomantic/dotfiles ~/.dotfiles
cd ~/.dotfiles;
# run this using terminal (not iTerm, lest iTerm settings get discarded on exit)
./install.sh
- When it finishes, open Iterm and press
Command + ,
to open preferences. Under Profiles > Colors, select "Load Presets" and choose theSolarized Dark Patch
scheme. If it isn't there for some reason, import it from~/.dotfiles/configs
-- you may also need to select theHack
font and check the box for non-ascii font and set toRoboto Mono For Powerline
(I've had mixed results for automating these settings--love a pull request that improves this) - I've also found that you need to reboot before fast key repeat will be enabled
Note: running install.sh is idempotent. You can run it again and again as you add new features or software to the scripts! I'll regularly add new configurations so keep an eye on this repo as it grows and optimizes.
If you have existing dotfiles for configuring git, zsh, vim, etc, these will be backed-up into ~/.dotfiles_backup/$(date +"%Y.%m.%d.%H.%M.%S")
and replaced with the files from this project. You can restore your original dotfiles by using ./restore.sh $RESTOREDATE
where $RESTOREDATE
is the date folder name you want to restore.
The restore script does not currently restore system settings--only your original dotfiles. To restore system settings, you'll need to manually undo what you don't like (so don't forget to fork, review, tweak)
3.0.0
brings huge changes. If you have made any modifications (and didn't make your own fork), you will want to backup your dotfiles prior to running git-up
or git pull
on ~/.dotfiles
.
Do the following to upgrade your ~/.dotfiles safely:
- backup your dotfiles:
cp -R ~/.dotfiles ~/.dotfiles_old
cd ~/.dotfiles
- update dotfiles:
git-up
orgit pull
- remove old submodule location:
rm -rf .vim
(now lives inhomedir/.vim
) - inspect
install.sh
andconfig.js
to make sure all the software you want is installed - inspect
homedir/*
for any changes you want to port from./dotfiles_old
- run
install.sh
again
I am moving away from using Atom
and instead using vim
as my IDE. I use Vundle to manage vim plugins (instead of pathogen). Vundle is better in many ways and is compatible with pathogen plugins. Additionally, vundle will manage and install its own plugins so we don't have to use git submodules for all of them.
You can cron ~/.crontab
if you want to add my nightly cron software updates.
\[0_0]/ - Note that this may wake you in the morning to compatibility issues so use only if you like being on the edge
- I highly recommend remapping your Caps Lock key to Control per Dr. Bunsen:
This project changes a number of settings and configures software on MacOS. Here is the current list:
- Disable local Time Machine snapshots
- Disable hibernation (speeds up entering sleep mode)
- Remove the sleep image file to save disk space
- Set a custom wallpaper image (if answered yes to prompt)
- always boot in verbose mode (not MacOS GUI mode)
- Disable the sound effects on boot
- Menu bar: disable transparency
- Menu bar: hide the Time Machine, Volume, User, and Bluetooth icons
- Set highlight color to green
- Set sidebar icon size to medium
- Always show scrollbars
- Increase window resize speed for Cocoa applications
- Expand save panel by default
- Expand print panel by default
- allow 'locate' command
- Set standby delay to 24 hours (default is 1 hour)
- Save to disk (not to iCloud) by default
- Automatically quit printer app once the print jobs complete
- Disable the āAre you sure you want to open this application?ā dialog
- Remove duplicates in the āOpen Withā menu (also see 'lscleanup' alias)
- Display ASCII control characters using caret notation in standard text views
- Disable automatic termination of inactive apps
- Disable the crash reporter
- Set Help Viewer windows to non-floating mode
- Reveal IP, hostname, OS, etc. when clicking clock in login window
- Restart automatically if the computer freezes
- Never go into computer sleep mode
- Check for software updates daily, not just once per week
- Disable Notification Center and remove the menu bar icon
- Disable smart quotes as theyāre annoying when typing code
- Disable smart dashes as theyāre annoying when typing code
- Enable firewall
- Enable firewall stealth mode (no response to ICMP / ping requests)
- Disable remote apple events
- Disable wake-on modem
- Disable wake-on LAN
- Disable guest account login
- Trackpad: enable tap to click for this user and for the login screen
- Trackpad: map bottom right corner to right-click
- Disable ānaturalā (Lion-style) scrolling
- Increase sound quality for Bluetooth headphones/headsets
- Enable full keyboard access for all controls (e.g. enable Tab in modal dialogs)
- Use scroll gesture with the Ctrl (^) modifier key to zoom
- Follow the keyboard focus while zoomed in
- Disable press-and-hold for keys in favor of key repeat
- Set a blazingly fast keyboard repeat rate:
- Set language and text formats (english/US)
- Disable auto-correct
- Require password immediately after sleep or screen saver begins
- Save screenshots to the desktop
- Save screenshots in PNG format (other options: BMP, GIF, JPG, PDF, TIFF)
- Disable shadow in screenshots
- Enable subpixel font rendering on non-Apple LCDs
- Enable HiDPI display modes (requires restart)
- Keep folders on top when sorting by name (Sierra only)
- Allow quitting via ā + Q; doing so will also hide desktop icons
- Disable window animations and Get Info animations
- Set Desktop as the default location for new Finder windows
- Show hidden files by default
- Show all filename extensions
- Show status bar
- Show path bar
- Allow text selection in Quick Look
- Display full POSIX path as Finder window title
- When performing a search, search the current folder by default
- Disable the warning when changing a file extension
- Enable spring loading for directories
- Remove the spring loading delay for directories
- Avoid creating .DS_Store files on network volumes
- Disable disk image verification
- Automatically open a new Finder window when a volume is mounted
- Use list view in all Finder windows by default
- Disable the warning before emptying the Trash
- Empty Trash securely by default
- Enable AirDrop over Ethernet and on unsupported Macs running Lion
- Show the ~/Library folder
- Expand the following File Info panes: āGeneralā, āOpen withā, and āSharing & Permissionsā
- Enable highlight hover effect for the grid view of a stack (Dock)
- Set the icon size of Dock items to 36 pixels
- Change minimize/maximize window effect to scale
- Minimize windows into their applicationās icon
- Enable spring loading for all Dock items
- Show indicator lights for open applications in the Dock
- Donāt animate opening applications from the Dock
- Speed up Mission Control animations
- Donāt group windows by application in Mission Control
- Disable Dashboard
- Donāt show Dashboard as a Space
- Donāt automatically rearrange Spaces based on most recent use
- Remove the auto-hiding Dock delay
- Remove the animation when hiding/showing the Dock
- Automatically hide and show the Dock
- Make Dock icons of hidden applications translucent
- Make Dock more transparent
- Reset Launchpad, but keep the desktop wallpaper intact
- Top left screen corner ā Mission Control
- Top right screen corner ā Desktop
- Bottom right screen corner ā Start screen saver
- Set Safariās home page to āabout:blankā for faster loading
- Prevent Safari from opening āsafeā files automatically after downloading
- Allow hitting the Backspace key to go to the previous page in history
- Hide Safariās bookmarks bar by default
- Hide Safariās sidebar in Top Sites
- Disable Safariās thumbnail cache for History and Top Sites
- Enable Safariās debug menu
- Make Safariās search banners default to Contains instead of Starts With
- Remove useless icons from Safariās bookmarks bar
- Enable the Develop menu and the Web Inspector in Safari
- Add a context menu item for showing the Web Inspector in web views
- Disable send and reply animations in Mail.app
- Copy email addresses as '[email protected]' instead of 'Foo Bar [email protected]' in Mail.app
- Add the keyboard shortcut ā + Enter to send an email in Mail.app
- Display emails in threaded mode, sorted by date (oldest at the top)
- Disable inline attachments (just show the icons)
- Disable automatic spell checking
- Disable Spotlight indexing for any volume that gets mounted and has not yet been indexed
- Change indexing order and disable some file types from being indexed
- Load new settings before rebuilding the index
- Make sure indexing is enabled for the main volume
- Installing the Solarized Dark theme for iTerm
- Donāt display the annoying prompt when quitting iTerm
- Hide tab title bars
- Set system-wide hotkey to show/hide iterm with ctrl+tick (
^
+ `) - Set normal font to Hack 12pt
- Set non-ascii font to Roboto Mono for Powerline 12pt
- Prevent Time Machine from prompting to use new hard drives as backup volume
- Disable local Time Machine backups
- Show the main window when launching Activity Monitor
- Visualize CPU usage in the Activity Monitor Dock icon
- Show all processes in Activity Monitor
- Sort Activity Monitor results by CPU usage
- Enable the debug menu in Address Book
- Enable Dashboard dev mode (allows keeping widgets on the desktop)
- Use plain text mode for new TextEdit documents
- Open and save files as UTF-8 in TextEdit
- Enable the debug menu in Disk Utility
- Enable the WebKit Developer Tools in the Mac App Store
- Enable Debug Menu in the Mac App Store
- Disable automatic emoji substitution (i.e. use plain text smileys)
- Disable smart quotes as itās annoying for messages that contain code
- Disable continuous spell checking
- Start SizeUp at login
- Donāt show the preferences window on next start
homebrew, fontconfig, git, ruby (latest), nvm (node + npm), and zsh (latest) are all installed inside the install.sh
as foundational software for running this project.
Additional software is configured in config.js
and can be customized in your own fork/branch (you can change everything in your own fork/brance).
The following is the software that I have set as default:
- ack
- ag
- coreutils
- dos2unix
- findutils
- fortune
- gawk
- gifsicle
- gnupg
- gnu-sed
- homebrew/dupes/grep
- httpie
- imagemagick (only if gitshots enabled)
- imagesnap (only if gitshots enabled)
- jq
- mas
- moreutils
- nmap
- openconnect
- reattach-to-user-namespace
- homebrew/dupes/screen
- tmux
- tree
- ttyrec
- vim --override-system-vi
- watch
- wget --enable-iri
- box-sync
- gpgtools
- iterm2
- sizeup
- slack
- the-unarchiver
- xquartz
- antic
- buzzphrase
- eslint
- gulp
- instant-markdown-d
- npm-check
- prettyjson
- trash
- vtop
- git-up
This project is licensed under ISC. Please fork, contribute and share.
Contributions are always welcome in the form of pull requests with explanatory comments.
Please refer to the Contributor Covenant
- Loathing should be directed into pull requests that make it better. woot.
- Bugs with the setup should be put as GitHub issues.
- Mehs should be > /dev/null
- Praise should be directed to
Warning: The creator of this repo is not responsible if your machine ends up in a state you are not happy with. If you are concerned, look at the code to review everything this will do to your machine :)