@pgodschalk/dotfiles

Report a Bug · Request a Feature

My collection of dotfiles

• About
  • Built with
• Getting started
  • Prerequisites
  • Installation
• Usage
• Roadmap
• Support
• Project assistance
• Contributing
• Authors & contributors
• Security
• License
• Acknowledgements

About

My collection of dotfiles. I mainly use this with Ghostty as a terminal emulator on macOS, and Windows Terminal on Windows.

Zed is my main editor, though I do keep Visual Studio Code around mainly for Windows support.

Other than that,

• 1Password is my secrets manager.
• DevPod is running development environments when I need more juice than my MacBook Pro can provide. Sometimes I run said environment on my Windows machine. Though I'll also use plain old Codespaces every now and then.
• Monodraw is my diagramming tool.
• OrbStack runs my Docker containers, since Docker Desktop is just slow, and gets in my way a lot.
• Passepartout is my VPN manager, other than Tailscale.
• RapidAPI is used for playing with API's, if xh isn't enough.
• Secretive is my SSH agent.
• SnippetsLab is where I keep my code snippets.
• TablePlus is my database browser.
• Tailscale is my personal VPN.
• Ulysses is my long form Markdown editor.
• UTM is my virtualization manager.
• Xcode kinda just exists.

Built with

• A whole bunch of stuff. :)

Getting started

Prerequisites

• A macOS or Linux environment to copy or symlink everything into.

Installation

This is mostly just manual symlinks. Dotfile managers exist, but I don't like them, since I'm pretty specific about where stuff gets stored. There is an install.sh, but that's mainly intended for devcontainers.

Usage

Symlink any dotfile you want to use.

rm ~/.something
ln -s ~/Developer/build/pgodschalk/dotfiles/.something ~/.something

Roadmap

See the open issues for a list of proposed features (and known issues).

• Top Feature Requests (Add your votes using the 👍 reaction)
• Top Bugs (Add your votes using the 👍 reaction)
• Newest Bugs

Support

Reach out to the maintainer at one of the following places:

• GitHub issues
• Contact options listed on this GitHub profile

Project assistance

If you want to say thank you or/and support active development of dotfiles:

• Add a GitHub Star to the project.
• Write interesting articles about the project on Dev.to, Medium or your personal blog.

Together, we can make dotfiles better!

Contributing

First off, thanks for taking the time to contribute! Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make will benefit everybody else and are greatly appreciated.

Please read our contribution guidelines, and thank you for being involved!

Authors & contributors

The original setup of this repository is by Patrick Godschalk.

For a full list of all authors and contributors, see the contributors page.

Security

dotfiles follows good practices of security, but 100% security cannot be assured. dotfiles is provided "as is" without any warranty. Use at your own risk.

For more information and to report security issues, please refer to our security documentation.

License

This project is licensed under the MIT license.

See LICENSE for more information.

Acknowledgements

• $HOME/.hushlogin from @mathiasbynens
• $HOME/.ssh/config from @mozilla
• $XDG_BIN_HOME/beep from @garybernhardt
• $XDG_BIN_HOME/git-churn
• $XDG_BIN_HOME/git-divergence
• $XDG_BIN_HOME/git-goodness
• $XDG_BIN_HOME/git-what-the-hell-just-happened
• $XDG_BIN_HOME/git-whodoneit
• $XDG_BIN_HOME/githelpers from @garybernhardt
• $XDG_BIN_HOME/gn
• $XDG_BIN_HOME/gn.py
• $XDG_CONFIG_HOME/com.mitchellh.ghostty/config from @mitchellh
• $XDG_CONFIG_HOME/git/attributes from @gitattributes
• $XDG_CONFIG_HOME/git/config from @garybernhardt
• $XDG_CONFIG_HOME/git/config from @gitbutler
• $XDG_CONFIG_HOME/git/config from @gittower
• $XDG_CONFIG_HOME/git/config from @jvns
• $XDG_CONFIG_HOME/git/config from @mathiasbynens
• $XDG_CONFIG_HOME/git/config from @mischah
• $XDG_CONFIG_HOME/git/ignore from @github
• $XDG_CONFIG_HOME/jj/config from @mitchellh
• $XDG_CONFIG_HOME/nano/nanorc from Elliot Cooper
• $XDG_CONFIG_HOME/python/pythonrc from @b3nj5m1n
• $XDG_CONFIG_HOME/readline/inputrc from @mathiasbynens
• $XDG_CONFIG_HOME/starship/starship.toml from @starship
• $XDG_CONFIG_HOME/vim/vimrc from @mathiasbynens
• $XDG_CONFIG_HOME/.curlc from @mathiasbynens
• $XDG_CONFIG_HOME/wgetrc from @mathiasbynens
• $XDG_DATA_HOME/gnupg/gpg.conf from @drduh
• $XDG_DATA_HOME/gnupg/gpg-agent.conf from @drduh
• $ZDOTDIR/.aliases from @mathiasbynens
• $ZDOTDIR/.aliases from @mitchellh
• $ZDOTDIR/.exports from @mathiasbynens
• $ZDOTDIR/.functions from @mathiasbynens
• $ZDOTDIR/.zprezto from @sorin-ionescu