dotfiles/README.md

54 lines
1.9 KiB
Markdown
Raw Normal View History

2016-10-21 03:05:56 +00:00
# dotfiles & system setup
2016-01-23 00:58:21 +00:00
```
arch-linux > arch specific dotfiles
bin > helpful shell scripts
git > global git config & aliases
2016-11-09 01:01:06 +00:00
gnupg > utilise gpg-agent for pgp crypto
lftp > sftp management
mail > mail config - mutt/mbsync/notmuch
2016-10-31 21:51:04 +00:00
mpd > music player daemon config
mpv > who needs vlc? minimal video player
2016-10-31 21:51:04 +00:00
ncmpcpp > ncurses mpc++ ui/colour settings & playlists
npm > npm configuration (ha ha)
nvim > neovim config & plugins
ssh > safe-ish ssh config
sway > minimal tiling wm for naughty computers
2016-11-09 01:01:06 +00:00
system > linux-specific system configuration
termite > terminal colours & keyboard settings
2016-10-29 05:11:50 +00:00
tmux > tmux config
2016-11-01 02:25:24 +00:00
weechat > irc client ui/colour configuration
zsh > shell, aliases and cool stuff
```
2016-11-07 02:27:14 +00:00
`git clone https://github.com/grawlinson/dotfiles.git ~/.dotfiles`
2016-01-23 00:58:21 +00:00
Clone repository, then setup as desired using [GNU Stow][url-gnu-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.
The following should really be Ansible playbooks:
- mail (setup systemd units)
- ssh (add ssh keys & server aliases)
- system (modify files out of `$HOME`)
## 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]
2016-10-21 03:05:56 +00:00
## LICENSE
2016-01-23 00:58:21 +00:00
2016-10-21 03:05:56 +00:00
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