/dotfiles

Set up your computer to be awesome

Primary LanguageShellMozilla Public License 2.0MPL-2.0

dotfiles

Set up your computer to be awesome

Dotfiles enhance your computing experience, mostly by configuring the tools you already use.

These particular dotfiles were designed by Seth Holladay. Installing them on your machine will give you a consistent, friendly environment to work with, particularly on the command line.

A Unix-like environment is assumed, because conquering the world is hard.

Contents

Why?

  • Installs the brew package manager (Homebrew)
  • Uses brew to install other common tools such as Git and Node.js
  • Keeps SSH connections alive
  • Comes with a vibrant terminal theme

Install

  1. Back up any existing files you care about, especially any dotfiles in your home directory. If you need to preserve functionality from existing dotfiles, that is left up to you.

  2. If you are planning to change your account name, do so now, before any other software is installed. Not all software is capable of gracefully handling changes to your home directory path.

  3. Run the installer. See install.sh to learn what it does.

    sh -c "$(curl -fsSL https://raw.githubusercontent.com/sholladay/dotfiles/master/install.sh)";
  4. If you are on macOS, the shell will speak a greeting to you. Modify ~/Code/sh/greet and make sure it says your name.

Additional setup

These extra steps are recommended for an optimal experience.

Replace My-Laptop with your own value in the commands below.

  • sudo scutil --set ComputerName 'My Laptop'
  • sudo scutil --set LocalHostName 'My-Laptop'
  • Add environment variables, such as service credentials, to ~/.config/fish/config.fish
  • Set up fish as the default shell and use the Pure theme.
  • Set Seth-Dark.terminal as your terminal profile.
  • Put SSH keys in ~/.ssh. Make new keys with ssh-keygen -t ed25519 to use ED25519 encryption.

Easy macOS app installs

If you are on macOS, you can install apps from the command line with Homebrew brew cask, which can install GUI apps, such as Firefox. Try it out!

brew install firefox

That is all you have to do. No more searching the web, finding a download link, clicking the download link, going to your downloads folder, extracting the app from an archive, and moving the app to where it belongs; that is so old school.

If you do need to search for a package, brew search and brew info are your friends, but usually you can just guess the package name.

Manual install

You can easily download the files and manually install them yourself.

mkdir dotfiles && curl -fsSL https://github.com/sholladay/dotfiles/archive/master.tar.gz | tar -x -C dotfiles --strip-components=1;

Note the directories within the project. linux and macos contain files that are tuned for use on those platforms, respectively.

The installer copies files from either macos or linux to your home directory.

Contributing

See our contributing guidelines for more details.

  1. Fork it.
  2. Make a feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request.

License

MPL-2.0 © Seth Holladay

Go make something, dang it.