https://github.com/joshdick/dotfiles

🗂 ~josh
https://github.com/joshdick/dotfiles

dotfiles linux macos shell unix

Last synced: 2 months ago
JSON representation

🗂 ~josh

• Host: GitHub
• URL: https://github.com/joshdick/dotfiles
• Owner: joshdick
• Created: 2011-02-11T03:57:21.000Z (almost 14 years ago)
• Default Branch: main
• Last Pushed: 2024-09-24T16:46:33.000Z (3 months ago)
• Last Synced: 2024-10-12T06:08:36.922Z (3 months ago)
• Topics: dotfiles, linux, macos, shell, unix
• Language: Vim Script
• Homepage:
• Size: 726 KB
• Stars: 23
• Watchers: 3
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: .github/README.md

Awesome Lists containing this project

README

        
# ~josh

These are my dotfiles. There are many like them, but these are mine.

## intro

Dotfiles are used to personalize a *NIX system. I use these dotfiles on Linux and Mac OS X systems.

Both the install script (see below) and the repository layout are tailored for management with [yadm](https://yadm.io).

I use the excellent `zsh` for my shell, but most of the aliases, shell functions, etc in `.zshrc` and elsewhere should work just fine in `bash`.

There are comments throughout my dotfiles attributing all known original sources.

## install

You are **strongly encouraged to [inspect the install script for yourself](https://raw.githubusercontent.com/joshdick/dotfiles/main/.dotfiles_utils/install.sh)** before running it like this:

```sh

$ zsh <(curl -fsSL https://raw.githubusercontent.com/joshdick/dotfiles/main/.dotfiles_utils/install.sh)

```

The install script assumes that you are using `zsh` as your shell and requires `curl` and `git` to be installed as prerequisites.

It will not overwrite any of your existing dotfiles.

I take no responsibility for any havoc the install script may wreak on your system...it works for me!

## usage

`~/.localrc` will be sourced if it exists. Anything that should be kept secret/doesn't need to be version controlled should go in this file. It is useful for machine-specific configuration.

`~/.bin` contains git submodules for various utilities I use. These are added to `PATH` as appropriate via the `~/.bin/bin_init.zsh` script. `~/.bin` itself is also added to `PATH`.