dotfiles/README.md

# dotfiles

```
alacritty      > yet another terminal emulator
archlinux      > just makepkg.conf for now
bin            > helpful shell scripts
darktable      > mostly just filters
git            > global git config & aliases
gnupg          > utilise gpg-agent for pgp crypto
lftp           > sftp management
mail           > mail config - mutt/mbsync/notmuch
mpv            > who needs vlc? minimal video player
music          > music config - mpd, ncmpcpp, beets
npm            > npm configuration (ha ha)
nvim           > neovim config & plugins
ssh            > safe-ish ssh config
sway           > minimal tiling wm for naughty computers
termite        > terminal colours & keyboard settings
tmux           > tmux config
weechat        > irc client ui/colour configuration
zsh            > shell, aliases and cool stuff
```

`git clone https://github.com/grawlinson/dotfiles.git ~/.dotfiles`

Clone repository, then setup as desired using [GNU Stow][url-gnu-stow].
I prefer using the `--no-folding` flag with `stow`.

## Caveats

These dotfiles assume the computer is set up in a specific way. I recommend
using Ansible or other tools (Chef, Puppet, etc) to automatically provision
your computer the way you like it.

## Further Reading

- [Using GNU Stow to manage your dotfiles][url-invergo-stow]
- [Mozilla OpenSSH security guidelines][url-mozilla-ssh]
- [Good read on securing OpenSSH][url-secure-shell]

## LICENSE

The MIT License ([MIT](LICENSE.md))

[url-gnu-stow]: https://www.gnu.org/software/stow/
[url-invergo-stow]: http://brandon.invergo.net/news/2012-05-26-using-gnu-stow-to-manage-your-dotfiles.html
[url-mozilla-ssh]: https://wiki.mozilla.org/Security/Guidelines/OpenSSH
[url-secure-shell]: https://stribika.github.io/2015/01/04/secure-secure-shell.html
feat(ansible): migrate automate-able items to separate repository 2018-07-24 02:38:47 +00:00			`# dotfiles`
Initial commit. 2016-01-23 00:58:21 +00:00
docs(readme): fix github markdown oddity code block with lang:shell makes it look weird 2018-07-23 05:53:14 +00:00			```
feat(alacritty): initial configuration 2020-01-29 08:43:15 +00:00			`alacritty > yet another terminal emulator`
docs(readme): add archlinux to table of malcontents 2022-05-04 09:29:47 +00:00			`archlinux > just makepkg.conf for now`
Replace urxvt with termite due to incorrect font rendering 2016-11-07 02:32:44 +00:00			`bin > helpful shell scripts`
refactor(music): add ncmpcpp, beets & mpd configuration 2018-08-08 08:53:58 +00:00			`darktable > mostly just filters`
Update makefile + readme, also add wallpapers 2016-10-23 05:00:18 +00:00			`git > global git config & aliases`
Update readme & add gnupg 2016-11-09 01:01:06 +00:00			`gnupg > utilise gpg-agent for pgp crypto`
Update makefile + readme, also add wallpapers 2016-10-23 05:00:18 +00:00			`lftp > sftp management`
Update mail with basic notmuch configuration 2016-11-07 06:16:35 +00:00			`mail > mail config - mutt/mbsync/notmuch`
Add mpd systemd service files, mpv config and minor weechat colouring 2016-11-07 02:35:26 +00:00			`mpv > who needs vlc? minimal video player`
refactor(music): add ncmpcpp, beets & mpd configuration 2018-08-08 08:53:58 +00:00			`music > music config - mpd, ncmpcpp, beets`
Update makefile + readme, also add wallpapers 2016-10-23 05:00:18 +00:00			`npm > npm configuration (ha ha)`
			`nvim > neovim config & plugins`
			`ssh > safe-ish ssh config`
			`sway > minimal tiling wm for naughty computers`
Replace urxvt with termite due to incorrect font rendering 2016-11-07 02:32:44 +00:00			`termite > terminal colours & keyboard settings`
Update readme to include tmux 2016-10-29 05:11:50 +00:00			`tmux > tmux config`
Add weechat configuration 2016-11-01 02:25:24 +00:00			`weechat > irc client ui/colour configuration`
Update makefile + readme, also add wallpapers 2016-10-23 05:00:18 +00:00			`zsh > shell, aliases and cool stuff`
			```

Add mail config - mutt & mbsync 2016-11-07 02:27:14 +00:00			`git clone https://github.com/grawlinson/dotfiles.git ~/.dotfiles`
Initial commit. 2016-01-23 00:58:21 +00:00
refactor(music): add ncmpcpp, beets & mpd configuration 2018-08-08 08:53:58 +00:00			`Clone repository, then setup as desired using [GNU Stow][url-gnu-stow].`
			I prefer using the `--no-folding` flag with `stow`.
Change git clone method from SSH to HTTPS & update readme 2016-10-23 07:09:43 +00:00
docs(readme): add link & reference to ansible 2018-07-15 05:36:50 +00:00			`## Caveats`

			`These dotfiles assume the computer is set up in a specific way. I recommend`
			`using Ansible or other tools (Chef, Puppet, etc) to automatically provision`
docs: remove reference to deleted repository 2021-09-11 06:54:58 +00:00			`your computer the way you like it.`
docs(readme): add link & reference to ansible 2018-07-15 05:36:50 +00:00
			`## Further Reading`
Change git clone method from SSH to HTTPS & update readme 2016-10-23 07:09:43 +00:00
docs(readme): add link & reference to ansible 2018-07-15 05:36:50 +00:00			`- [Using GNU Stow to manage your dotfiles][url-invergo-stow]`
			`- [Mozilla OpenSSH security guidelines][url-mozilla-ssh]`
			`- [Good read on securing OpenSSH][url-secure-shell]`
Update makefile + readme, also add wallpapers 2016-10-23 05:00:18 +00:00
Update README files 2016-10-21 03:05:56 +00:00			`## LICENSE`
Initial commit. 2016-01-23 00:58:21 +00:00
Update README files 2016-10-21 03:05:56 +00:00			`The MIT License ([MIT](LICENSE.md))`
Change git clone method from SSH to HTTPS & update readme 2016-10-23 07:09:43 +00:00
docs(readme): add link & reference to ansible 2018-07-15 05:36:50 +00:00			`[url-gnu-stow]: https://www.gnu.org/software/stow/`
			`[url-invergo-stow]: http://brandon.invergo.net/news/2012-05-26-using-gnu-stow-to-manage-your-dotfiles.html`
			`[url-mozilla-ssh]: https://wiki.mozilla.org/Security/Guidelines/OpenSSH`
			`[url-secure-shell]: https://stribika.github.io/2015/01/04/secure-secure-shell.html`