dotfiles

KO | EN

gitlite — search

#python #react #llm #golang #android #rust #deep-learning #linux #docker #nodejs #java #windows #cli #awesome-list

(★ 66)

🏠 My personal dotfiles, following the XDG Base Directory Standard.

File Explorer

Download Latest Version (.zip)

- - ackrc
- - amethyst.yml
- - packages.txt
- - asdfrc
  - default-go.txt
  - default-node.txt
  - default-python.txt
  - default-ruby.txt
- - AutoHotkey_v1.ahk
  - AutoHotkey_v2.ahk
- - aliases
  - aliases_make
  - bashrc
  - colors
  - commons
  - dircolors
  - functions
  - ps1
- - bashdbinit
- - conf.hjson
  - verbs.hjson
- - Gemfile
  - README.md
- - cgdbrc
- - default.ctags
- - direnv.toml
- - config.yml
- - init.el
- - theme.yml
- - bookmarks_minimal.html
  - README.md
  - user.js
  - userChrome.css
- - .gitkeep
  - marks-codespaces
- - gdbinit
- - config.yml
- - config
- - config
  - config-work
  - ignore
- - gpg-agent.conf
  - gpg.conf
- - README.md
  - vimium_mappings.txt
  - vimium_search.txt
- - preferences
- - hgrc
- - Brewfile
  - Brewfile.cypress
- - ideavimrc
- - irbrc
- - config
  - default.theme
  - startup
  - vim_moderc
- - com.user.irctor.plist
  - com.user.iterm.plist
  - com.user.notificationqueue.plist
- - config.yml
- - keymap
- - colors.yaml
  - config.yaml
- - .luacheckr
- - markdownlint.yaml
- - config.toml
- - config
- - aliases
  - muttrc
  - muttrc.gpg
- - npmrc
- - init.lua
  - lazy-lock.json
- - octaverc
- - config
- - pryrc
- - pudb.cfg
- - inputrc
- - config
- - screenrc
  - screenrc.irctor
- - stylua.toml
- - config
- - tmux.conf
- - config.sh
- - urlview
- - filetype.vim
  - gvimrc
  - vimrc
- - wgetrc
- - startx.sh
  - XCompose.disabled
  - xinitrc
  - xinitrc.irvine
  - Xmodmap
  - Xmodmap.mac
  - Xresources
  - Xresources.solarized_dark
  - Xresources.solarized_light
  - Xresources.solarized_urxvt
- - config
- - keymap.xkb
- - .zlogout
  - .zprofile
  - .zshrc
  - dircolors
  - zprofile
  - zshrc
- .curlrc
- .ghci
- mailcap
- sig
- starship.toml
- user-dirs.dirs
- user-dirs.locale
- devcontainer.json
- - README.md
  - zinit
- - chromium-axis
  - convert2png.sh
  - daemonize
  - dotfiles_update.sh
  - dropbox
  - email_parse.py
  - ghostty-tmux.sh
  - gphotos_takeout_rm_originals.sh
  - if_fail_do_mail
  - irctor
  - macos_vst_fix_unverified.sh
  - maildir_watch.sh
  - mailleds_start.sh
  - multiboot_usb_install.sh
  - offlineimap.sh
  - printscreen_scrot.sh
  - scan_dcp7070dw.sh
  - siggen.sh
  - time_machine.sh
  - uberspace_backup.sh
  - uberspace_collect_access_log.sh
  - update_fonts.sh
  - urxvtc
  - virtualbox_netshare.bat
  - voltune.sh
  - watch-freebsd
  - xautolockctl
  - xdg-open
  - xkbset
- - appearance_toggle.command
  - open_controlcenter.command
  - open_nowplaying.command
  - README.md
  - start_screensaver.command
  - SwitchAudioSource.sh
  - SwitchAudioSource_Built-in.command
  - SwitchAudioSource_cycle.command
  - SwitchAudioSource_JabraHeadset.command
  - SwitchAudioSource_usb_soundcard.command
- - Sleep macOS.shortcut
  - Toggle Appearance.shortcut
- brew_bundle_validate.sh
- brew_leafs.sh
- brew_upgrade.sh
- brew_usages.sh
- center
- crontab_backup.sh
- deadlinks.sh
- dotfiles_backup_local.sh
- dotfiles_bootstrap.sh
- git-stats
- if_fail_notify
- lensort
- login_top.sh
- macos_config.sh
- macos_touchid_sudo_enable.sh
- md5sumer.sh
- notification_queue_notifier.sh
- pdf_compress.sh
- pdf_extract_range.sh
- permute_aliases.sh
- rename_sane.sh
- screenshot_declassify.sh
- spotify-backup.sh
- ssh-config-create.sh
- ssh-keygen.sh
- testt.sh
- vscode_backup_extensions.sh
- windows_install.ps1
- windows_update.ps1
- yt-dlp.sh
- macos_install_manual.md
- logo.png
- logo.pxd
.bashrc
.gitignore
.gitmodules
.hushlogin
.ignore
.notags
.zshenv
install.sh
README.md

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img alt="log" width="80%" src="img/logo.png" />

the files that makes me feel at <tt>~/</tt>

# 🏠 Dotfiles
[![GitHub Stars](https://img.shields.io/github/stars/erikw/dotfiles?style=social)](https://raw.githubusercontent.com/erikw/dotfiles/main/)
[![GitHub Forks](https://img.shields.io/github/forks/erikw/dotfiles?style=social)](https://raw.githubusercontent.com/erikw/dotfiles/main/)
 
[![SLOC](https://sloc.xyz/github/erikw/dotfiles?lower=true&badge-bg-color=32CD32)](https://raw.githubusercontent.com/erikw/dotfiles/main/)
[![Number of programming languages used](https://img.shields.io/github/languages/count/erikw/dotfiles)](https://raw.githubusercontent.com/erikw/dotfiles/main/)
[![Top programming languages used](https://img.shields.io/github/languages/top/erikw/dotfiles)](https://raw.githubusercontent.com/erikw/dotfiles/main/)
[![Number of files in repo](https://img.shields.io/github/directory-file-count/erikw/dotfiles)](https://raw.githubusercontent.com/erikw/dotfiles/main/)
[![Repo file size](https://img.shields.io/github/repo-size/erikw/dotfiles)](https://raw.githubusercontent.com/erikw/dotfiles/main/)
[![XDG Compliance](https://img.shields.io/badge/%E2%9C%94%20Compliancy-XDG%20Base%20Directory%20Standard-limegreen)](https://raw.githubusercontent.com/erikw/dotfiles/main/)

My personal dotfiles.

> [!NOTE]
> This is as [XDG](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html) Base Directory Standard compliant as possible!

## Highlights
* [`.config/`](.config/) - I've spent quite some effort to make my dotfiles adhere to the [XDG](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html) Base Directory Standard as much as possible, using and contributing to the [Arch wiki page](https://wiki.archlinux.org/title/XDG_Base_Directory). As far from all programs that I use support this natively, quite some custom configuration needs to be done. Grep for `XDG` in [.config/zsh](.config/zsh/).
   * [`nvim/`](.config/nvim) - check out my Neovim configurations; they are pretty cool!
* [`bin/`](bin/) - many handy and time saving scripts.
  * [`brew_upgrade.sh`](bin/brew_upgrade.sh) - interactively upgrade a Homebrew system.
  * [`macos_touchid_sudo_enable.sh`](bin/macos_touchid_sudo_enable.sh) - enable sudo with TouchID.
  * [`pdf_compress.sh`](bin/pdf_compress.sh) - compress file size of PDFs!
  * [`permute_aliases.sh`](bin/permute_aliases.sh) - generate shell aliases on all permutations of a command; for fast typers!
  * [`ssh-keygen.sh`](bin/ssh-keygen.sh) - interactively create SSH keys using a nicely structured [`.ssh/config`](bin/ssh-config-create.sh) file.
* [`docs/`](docs/) - supplementary documentation.
  * [`macos_install_manual.md`](docs/macos_install_manual.md) - manual macOS setup steps for apps and tools that can't be automated.

## Installation
### Bootstrap
Bootstrap using [`bin/dotfiles_bootstrap.sh`](bin/dotfiles_bootstrap.sh):
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/erikw/dotfiles/main/bin/dotfiles_bootstrap.sh)"
```
This will interactively set up a GitHub SSH key, clone this repo, and run [`./install.sh`](https://github.com/erikw/dotfiles/blob/main/install.sh).

To reinstall the default global packages for mise-managed runtimes later, run `mise run bootstrap` or a single runtime task such as `mise run bootstrap:python`. The package lists live under [`.config/mise/packages/`](.config/mise/packages/).

### Local branch
If using this: uncomment the cronjob in user's crontab for `~/bin/dotfiles_backup_local.sh`.

If really really needed, switch to a local branch for secret changes:
```bash
cd ~/src/github.com/erikw/dotfiles
git checkout -b local
```

and after making some changes to the branch, squash to one commit:
```bash
git commit -m "SQUASHED passwords"
```

### Host-specific configuration
* Passwords and other secrets are censored. To find these and substitute them for the real thing, do:
	```bash
	grep -nr GIT-CENSORED . | grep -v README.md | grep -v "/.git/"
	```
* Set `DESKTYPE` in `$XDG_CONFIG_HOME/zsh/env/programs`, unless the system is macOS.
* Default desktop is assumed to be macOS. Some config files does not allow for OS-dependent config, or is inpractical to do. Thus, go through host-specific manual settings by searching for the corresponding tag.
	```bash
	grep -nr '#CONFIG-MACOS' . 2>/dev/null | grep -v README.md
	grep -nr '#CONFIG-LINUX' . 2>/dev/null | grep -v README.md
	grep -nr '#CONFIG-FREEBSD' . 2>/dev/null | grep -v README.md
	```

## GitHub SSH Config File
To ensure success, use a manual entry like this (modify output from [bin/ssh-keygen.sh](bin/ssh-keygen.sh):
<details>
<summary>~/.ssh/config</summary>

```sshconfig
Host github.com
	User git
	Port 22
	PreferredAuthentications publickey
	IdentityFile ~/.ssh/identityfiles/REDACT
```

</details>

dotfiles

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

dotfiles

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README