kirsle/.dotfiles
1
0
Fork 0
Code Releases Activity
My Unix config files and shell scripts, optimized for Fedora, Debian, macOS and Windows (in that order).
142 commits 1 branch 0 tags 1.1 MiB
Find a file
Exact
Noah Petherbridge daf337e210 Update to-photoblog script re: cloudflare
2025-10-04 13:39:01 -07:00
home Update to-photoblog script re: cloudflare 2025-10-04 13:39:01 -07:00
misc Add my crontab file for caskir 2018-03-04 12:18:58 -08:00
zsh Update vim plugins to latest 2017-08-01 17:01:23 -07:00
.gitignore Replace old setup Python script with command 2017-01-11 12:31:21 -08:00
.gitmodules Add initial zsh configuration 2015-07-07 15:40:07 -07:00
make-submodules.py Submodules for vim plugins 2014-12-05 17:30:44 -08:00
README.md Update documentation to mention new command 2017-01-11 13:12:15 -08:00
setup Replace old setup Python script with command 2017-01-11 12:31:21 -08:00

README.md

Kirsle's Dotfiles

This repo is for my own personal use for syncing my Unix config files and scripts between my various devices. Feel free to look around and learn from my config scripts.

Setup

~$ git clone git@github.com:kirsle/.dotfiles
~$ ./.dotfiles/setup

Dotfiles Manager (dfm)

The dotfiles repo is managed by a dfm command, which gets installed into ~/bin automatically. (The .dotfiles/setup script is just an easy alias to this command).

See dfm --help for documentation. Briefly:

  • dfm setup creates symlinks to all the files in ./home into $HOME.
  • dfm update does a git pull and installs any new dotfiles.
  • dfm check-update reminds you every 15 days to run dfm update (but doesn't remind you more than once per 24 hours).

In case one of the target files already exists (and is not a symlink), it is copied into .dotfiles/backup before being deleted and relinked.

The commands take optional arguments:

  • dfm setup --force: forcefully re-link all dotfiles, deleting any links that already exist.
  • dfm setup --copy: tell it not to use symlinks but instead make normal file copies into $HOME.
  • dfm check-update --force: always show the update reminder.

The .dotfiles/setup script passes all options along to dfm, so you can do .dotfiles/setup --copy for example.

Layout

  • ./setup

    Installation script for the dotfiles. Creates symlinks for everything in ./home into $HOME.

    This will not delete existing files, such as ~/.bashrc. Use the --install option to make it do so.

  • ./home

    Everything in this folder will be symlinked to from your $HOME folder.