{"id":13479281,"url":"https://github.com/driesvints/dotfiles","last_synced_at":"2025-05-14T02:04:52.029Z","repository":{"id":21314612,"uuid":"24631181","full_name":"driesvints/dotfiles","owner":"driesvints","description":"Get started with your own dotfiles.","archived":false,"fork":false,"pushed_at":"2025-04-25T06:40:59.000Z","size":5241,"stargazers_count":2284,"open_issues_count":1,"forks_count":720,"subscribers_count":36,"default_branch":"main","last_synced_at":"2025-04-25T07:32:55.744Z","etag":null,"topics":["backup","brew","dotfiles","homebrew","macos","oh-my-zsh","shell","zsh"],"latest_commit_sha":null,"homepage":"https://driesvints.com/blog/getting-started-with-dotfiles","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/driesvints.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"driesvints","custom":["https://www.paypal.me/driesvints"]}},"created_at":"2014-09-30T08:49:22.000Z","updated_at":"2025-04-25T06:41:04.000Z","dependencies_parsed_at":"2024-02-14T13:29:31.804Z","dependency_job_id":"7e0f4cc7-fd62-42af-b22f-a850a4c295c6","html_url":"https://github.com/driesvints/dotfiles","commit_stats":{"total_commits":593,"total_committers":16,"mean_commits":37.0625,"dds":0.05564924114671166,"last_synced_commit":"3404adc88fac2c24d3559f7e8e4c521558d7db0b"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/driesvints%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/driesvints%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/driesvints%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/driesvints%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/driesvints","download_url":"https://codeload.github.com/driesvints/dotfiles/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254052670,"owners_count":22006716,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backup","brew","dotfiles","homebrew","macos","oh-my-zsh","shell","zsh"],"created_at":"2024-07-31T16:02:12.731Z","updated_at":"2025-05-14T02:04:51.950Z","avatar_url":"https://github.com/driesvints.png","language":"Shell","readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"art/banner-2x.png\"\u003e\u003c/p\u003e\n\n## Introduction\n\nThis repository serves as my way to help me setup and maintain my Mac. It takes the effort out of installing everything manually. Everything needed to install my preferred setup of macOS is detailed in this readme. Feel free to explore, learn and copy parts for your own dotfiles. Enjoy!\n\n📖 - [Read the blog post](https://driesvints.com/blog/getting-started-with-dotfiles)  \n📺 - [Watch the screencast on Laracasts](https://laracasts.com/series/guest-spotlight/episodes/1)  \n💡 - [Learn how to build your own dotfiles](https://github.com/driesvints/dotfiles#your-own-dotfiles)\n\nIf you find this repo useful, [consider sponsoring me](https://github.com/sponsors/driesvints) (a little bit)! ❤️ \n\n## A Fresh macOS Setup\n\nThese instructions are for setting up new Mac devices. Instead, if you want to get started building your own dotfiles, you can [find those instructions below](#your-own-dotfiles).\n\n### Backup your data\n\nIf you're migrating from an existing Mac, you should first make sure to backup all of your existing data. Go through the checklist below to make sure you didn't forget anything before you migrate.\n\n- Did you commit and push any changes/branches to your git repositories?\n- Did you remember to save all important documents from non-iCloud directories?\n- Did you save all of your work from apps which aren't synced through iCloud?\n- Did you remember to export important data from your local database?\n- Did you update [mackup](https://github.com/lra/mackup) to the latest version and ran `mackup backup`?\n\n### Setting up your Mac\n\nAfter backing up your old Mac you may now follow these install instructions to setup a new one.\n\n1. Update macOS to the latest version through system preferences\n2. Setup an SSH key by using one of the two following methods  \n   2.1. If you use 1Password, install it with the 1Password [SSH agent](https://developer.1password.com/docs/ssh/get-started/#step-3-turn-on-the-1password-ssh-agent) and sync your SSH keys locally.  \n   2.2. Otherwise [generate a new public and private SSH key](https://docs.github.com/en/github/authenticating-to-github/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent) by running:\n\n   ```zsh\n   curl https://raw.githubusercontent.com/driesvints/dotfiles/HEAD/ssh.sh | sh -s \"\u003cyour-email-address\u003e\"\n   ```\n\n3. Clone this repo to `~/.dotfiles` with:\n\n    ```zsh\n    git clone --recursive git@github.com:driesvints/dotfiles.git ~/.dotfiles\n    ```\n\n4. Run the installation with:\n\n    ```zsh\n    cd ~/.dotfiles \u0026\u0026 ./fresh.sh\n    ```\n\n5. Start `Herd.app` and run its install process\n6. After mackup is synced with your cloud storage, restore preferences by running `mackup restore`\n7. Restart your computer to finalize the process\n\nYour Mac is now ready to use!\n\n\u003e 💡 You can use a different location than `~/.dotfiles` if you want. Make sure you also update the references in the [`.zshrc`](./.zshrc#L2) and [`fresh.sh`](./fresh.sh#L20) files.\n\n### Cleaning your old Mac (optionally)\n\nAfter you've set up your new Mac you may want to wipe and clean install your old Mac. Follow [this article](https://support.apple.com/guide/mac-help/erase-and-reinstall-macos-mh27903/mac) to do that. Remember to [backup your data](#backup-your-data) first!\n\n## Your Own Dotfiles\n\n**Please note that the instructions below assume you already have set up Oh My Zsh so make sure to first [install Oh My Zsh](https://github.com/robbyrussell/oh-my-zsh#getting-started) before you continue.**\n\nIf you want to start with your own dotfiles from this setup, it's pretty easy to do so. First of all you'll need to fork this repo. After that you can tweak it the way you want.\n\nGo through the [`.macos`](./.macos) file and adjust the settings to your liking. You can find much more settings at [the original script by Mathias Bynens](https://github.com/mathiasbynens/dotfiles/blob/master/.macos) and [Kevin Suttle's macOS Defaults project](https://github.com/kevinSuttle/MacOS-Defaults).\n\nCheck out the [`Brewfile`](./Brewfile) file and adjust the apps you want to install for your machine. Use [their search page](https://formulae.brew.sh/cask/) to check if the app you want to install is available.\n\nCheck out the [`aliases.zsh`](./aliases.zsh) file and add your own aliases. If you need to tweak your `$PATH` check out the [`path.zsh`](./path.zsh) file. These files get loaded in because the `$ZSH_CUSTOM` setting points to the `.dotfiles` directory. You can adjust the [`.zshrc`](./.zshrc) file to your liking to tweak your Oh My Zsh setup. More info about how to customize Oh My Zsh can be found [here](https://github.com/robbyrussell/oh-my-zsh/wiki/Customization).\n\nWhen installing these dotfiles for the first time you'll need to backup all of your settings with Mackup. Install Mackup and backup your settings with the commands below. Your settings will be synced to iCloud so you can use them to sync between computers and reinstall them when reinstalling your Mac. If you want to save your settings to a different directory or different storage than iCloud, [checkout the documentation](https://github.com/lra/mackup/blob/master/doc/README.md#storage). Also make sure your `.zshrc` file is symlinked from your dotfiles repo to your home directory. \n\n```zsh\nbrew install mackup\nmackup backup\n```\n\nYou can tweak the shell theme, the Oh My Zsh settings and much more. Go through the files in this repo and tweak everything to your liking.\n\nEnjoy your own Dotfiles!\n\n## Thanks To...\n\nI first got the idea for starting this project by visiting the [GitHub does dotfiles](https://dotfiles.github.io/) project. Both [Zach Holman](https://github.com/holman/dotfiles) and [Mathias Bynens](https://github.com/mathiasbynens/dotfiles) were great sources of inspiration. [Sourabh Bajaj](https://twitter.com/sb2nov/)'s [Mac OS X Setup Guide](http://sourabhbajaj.com/mac-setup/) proved to be invaluable. Thanks to [@subnixr](https://github.com/subnixr) for [his awesome Zsh theme](https://github.com/subnixr/minimal)! Thanks to [Caneco](https://twitter.com/caneco) for the header in this readme. And lastly, I'd like to thank [Emma Fabre](https://twitter.com/anahkiasen) for [her excellent presentation on Homebrew](https://speakerdeck.com/anahkiasen/a-storm-homebrewin) which made me migrate a lot to a [`Brewfile`](./Brewfile) and [Mackup](https://github.com/lra/mackup).\n\nIn general, I'd like to thank every single one who open-sources their dotfiles for their effort to contribute something to the open-source community.\n","funding_links":["https://github.com/sponsors/driesvints","https://www.paypal.me/driesvints"],"categories":["Shell","zsh","shell","Example dotfiles repos"],"sub_categories":["Zsh"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdriesvints%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdriesvints%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdriesvints%2Fdotfiles/lists"}