Dotfiles

This is my personal dotfiles repository. It contains the specific dotfiles, alongside an installation script.

Installation

To install the dotfiles, run one of the following commands:

curl -Lo - https://raw.githubusercontent.com/andreihh/dotfiles/main/install.sh \
  | bash

wget -O - https://raw.githubusercontent.com/andreihh/dotfiles/main/install.sh \
  | bash

To configure the color scheme for terminal apps, run the colorscheme command.

After installing the dotfiles for the first time, you may need to restart your system to reload the custom environment variables properly.

Optional setup scripts and executables are found under the opt/ directory. These are not used by default, you must manually run the setup scripts or link the executables into the PATH.

To configure pre-commit checks, run the following commands inside the repository:

pip install pre-commit
pre-commit install
pre-commit autoupdate

To add new dotfiles, commit all the changes to bring the repository to a clean state and run the following command:

./install.sh -r '' -b ''

XDG directories

The dotfiles follow the XDG specification where possible:

• https://specifications.freedesktop.org/basedir-spec/latest/index.html
• https://wiki.archlinux.org/title/XDG\_Base\_Directory

The XDG environment variables are defined in ~/.config/profile.d/00-env_xdg.sh, because some tools don't fall back on proper defaults and only work if they are explicitly defined.

Private configs

User or device specific configs and binaries that should not be included in the repository can be provided in:

• ~/.config/profile.d/
• ~/.config/bash.d/
• ~/.local/bin/
• ~/.config/tmux/overrides.tmux
• ~/.config/nvim/lua/config/overrides.lua
• ~/.config/nvim/lua/plugins/
• ~/.config/vim/overrides.vim
• ~/.config/vim/overrides.plug.vim

Example ~/.config/bash.d/10-extras.sh:

# extras.sh: exports device-specific settings.

# Export Git credentials.
export GIT_AUTHOR_NAME="Andrei Heidelbacher"
export GIT_COMMITTER_NAME="${GIT_AUTHOR_NAME}"
export GIT_AUTHOR_EMAIL="[email protected]"
export GIT_COMMITTER_EMAIL="${GIT_AUTHOR_EMAIL}"

...

Example ~/.config/nvim/lua/config/overrides.lua:

-- [[ Config overrides ]]

vim.api.nvim_create_user_command("LspCapabilities", function()
  local clients =
    vim.lsp.get_clients({ bufnr = vim.api.nvim_get_current_buf() })
  for _, client in pairs(clients) do
    vim.print("LSP capabilities for server " .. client.name .. ":")
    vim.print(client.server_capabilities)
  end
end, { desc = "Display the attached LSP capabilities" })

local ensure_installed = vim.g.lsp.ensure_installed
vim.list_extend(ensure_installed, {
  "pyright",
  "clangd",
  "jdtls",
  "kotlin_language_server",
  "isort",
  "pyink",
  "clang-format",
  "google-java-format",
  "ktfmt",
  "prettier",
  "pylint",
  "checkstyle",
})

vim.g.lsp = vim.tbl_deep_extend("force", vim.g.lsp, {
  servers = {
    pyright = {},
    clangd = {},
    jdtls = {},
    kotlin_language_server = {},
  },
  formatters_by_ft = {
    python = { "isort", "pyink" },
    cpp = { "clang-format" },
    java = { "google-java-format" },
    kotlin = { "ktfmt" },
    markdown = { "prettier" },
    json = { "prettier" },
    yaml = { "prettier" },
  },
  formatters = {
    ktfmt = { prepend_args = { "--google-style" } },
  },
  linters_by_ft = {
    python = { "pylint" },
    -- `clangd` embeds `clang-tidy`
    java = { "checkstyle" },
  },
  ensure_installed = ensure_installed,
})

Hotkeys

Keyboard layout changes:

• Swap Caps Lock with Esc
• Linux modifiers: Super Alt Ctrl Space Alt Ctrl
• MacOS modifiers: Ctrl Opt Cmd Space Opt Cmd

Common shortcuts (C = Ctrl / Cmd, A = Alt / Opt, S = Shift):

• New tab: C-t
• Close window / tab: C-w
• Quit app: C-q
• Cycle web browser tabs: C-1 / C-2
• Cycle windows: C-[S]-tab (requires https://alt-tab-macos.netlify.app/)
• Zoom in / out: C-= / C--
• Toggle tiled left / right: C-A-, / C-A-.
• Toggle maximized: C-A-m
• Toggle fullscreen: C-A-f
• Print screen / cancel: C-A-p / Esc
• Lock screen: C-A-l
• Open file explorer: C-A-e
• Open web browser: C-A-w
• Open shell terminal: C-A-s
• Open tmx terminal: C-A-x
• Open SSH terminal to cloud workstation: C-A-c

Terminal:

• Paste: C-S-v
• Close terminal: C-q
• Switch tmux tab: C-# (mapped to M-#)
• Send interrupt signal: C-c

Licensing

The scripts and configurations are licensed under the MIT license.