Skip to content
main
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Juan's Dotfiles for MacOS

Screenshot of my shell prompt

Disclaimer

Warning: If you want to give these dotfiles a try, you should first fork this repository, review the code, and remove things you don’t want or need. Don’t blindly use my settings unless you know what that entails. Use at your own risk!

  • I maintain this repo as my dotfiles.
  • You're quite welcome to make suggestions, however I may decline if it's not of personal value to me.

Installation

Using Git and the bootstrap script

To set this up, run the following command on your Home ($HOME) directory. This will clone the repository and start the bootstrap process to install everything.

git clone https://github.com/juancarrillofl/dotfiles.git --depth=1 && cd dotfiles && bash bootstrap.sh

This will install everything related to the software described down below. If you are ok with that, after executing the command above, you can (hopefully) let it run and forget about everything else except the .gitconfig info described just below.

Also if you want to install Mac App Store software, remember that you have to be logged in to the App Store before running the bootstrap.sh script (that executes the mas.sh script). And that software must have been downloaded manually at least once before, so it is registered on your Apple ID. This is a very specific case because, of course, the software that I use from the App Store is already registered in my account and I can automate this part.

These are caveats from the mas-cli. If you do not need software from the App Store or prefer to skip this part, comment out the bash ./mas.sh line from the bootstrap.sh file.

Git Config

This setup has, of course, my name and email that I use for my commits. If you are going to use this setup, remember to change this later with your information. I also use GPG to sign my commits, so change the signing key too!

Software Installers

Vimrc

The configuration I use for Vim. All these files are separate from this repository. You can take a look to the files in my vimrc repository.

If you want to install directly without using bootstrap.sh, you can use the following command:

git clone --depth=1 https://github.com/juancarrillofl/vimrc.git ~/.vim_runtime
sh ~/.vim_runtime/install_awesome_vimrc.sh

This version includes a lot of great plugins, configurations and color schemes that make Vim a lot better, and you don't have to reinvent the wheel to get set up.

Homebrew

The brew.sh file includes all the software that I'm currently using on my Mac that can be installed using the Homebrew Package Manager.

If you want to install this software directly without using bootstrap.sh, you can use the following command in your terminal:

bash ./brew.sh

npm

The npm.sh file includes all the software related with Node and NPM.

If you want to install this software directly without using bootstrap.sh, you can use the following command in your terminal:

NOTE: You have to have NodeJS v14+ installed!!

bash ./npm.sh

Spicetify

With the release of Spicetify v2, whatever I said about using the old Spotify UI with custom themes and color schemes have become obsolete.

So I decided to stop using Spotify. I will omit everything related to it and Spicetify, sorry! Going back to Apple Music.

mas

The mas-cli is a really useful tool for installing apps from the Mac App Store. If you read the caveats from above, you can proceed installing the apps without using the bootstrap.sh script, using the following command in your terminal:

bash ./mas.sh

MacOS

When setting up a new Mac, you may want to set some sensible MacOS defaults. They are done with the macos.sh script. If you want to execute it, you may need admin permission:

sudo bash ./macos.sh

Oh My Zsh

Oh My Zsh is a delightful, open source, community-driven framework for managing a Zsh configuration. When executing bootstrap.sh it will run oh-my-zsh.sh script, this will install:

You can install all this directly using the following command in your terminal:

bash ./oh-my-zsh.sh

Special Thanks

This work would not exist if it wasn't from the awesome work of other developers from which I could read and learn from.