{"id":15748326,"url":"https://github.com/karras/dotfiles","last_synced_at":"2025-08-24T13:18:59.300Z","repository":{"id":115371875,"uuid":"394432735","full_name":"karras/dotfiles","owner":"karras","description":"Nothing special, simply my dotfiles for everyday use.","archived":false,"fork":false,"pushed_at":"2025-02-23T12:10:59.000Z","size":3693,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-02-26T20:06:15.195Z","etag":null,"topics":["archlinux","dotfiles","greetd","waybar","wayfire","wayland","xdg","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/karras.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-08-09T20:41:37.000Z","updated_at":"2025-02-23T12:11:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"d4951aff-319d-4d69-8b1e-c27a7b48df25","html_url":"https://github.com/karras/dotfiles","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karras%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karras%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karras%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/karras%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/karras","download_url":"https://codeload.github.com/karras/dotfiles/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243414525,"owners_count":20287137,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["archlinux","dotfiles","greetd","waybar","wayfire","wayland","xdg","zsh"],"created_at":"2024-10-04T05:41:21.992Z","updated_at":"2025-03-13T13:32:26.210Z","avatar_url":"https://github.com/karras.png","language":"Shell","readme":"# Dotfiles\n\nNothing special, simply my dotfiles for everyday use.\n\n## Structure\n\nThe main goal is to keep the home directory as clean as possible by forcing\n*everything* to be stored in `~/.local`. I would **not recommend** to use it as\na plug'n play setup!\n\nThe structure and placement of all files is heavily inspired by the awesome\n[Ayekat](https://github.com/ayekat/localdir)!\n\n### XDG Paths\n\nThe [XDG base\ndirectories](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html)\nare customized as follows:\n\n| Variable          | Location                 |\n| ----------------- | ------------------------ |\n| `XDG_CACHE_HOME`  | `$HOME/.local/var/cache` |\n| `XDG_CONFIG_HOME` | `$HOME/.local/etc`       |\n| `XDG_DATA_HOME`   | `$HOME/.local/share`     |\n| `XDG_STATE_HOME`  | `$HOME/.local/var/lib`   |\n\nAlso `PATH` is extended by the below paths:\n\n| Path               | Purpose                     |\n| ------------------ | --------------------------- |\n| `$HOME/.local/bin` | Custom scripts and wrappers |\n\nMost [wrapper scripts](./local/bin) are required for those applications which\ndo not support custom XDG paths (e.g. Ansible or Firefox).\n\n### Private Configs\n\nFiles and configs that may differ between work and home devices and should not\nbe published are located in `$HOME/.local/var/lib/private`.\n\nTools like git or ZSH will fetch additional settings from there as needed.\n\n## Dependencies\n\nDue to the deprecation of\n[pam\\_env](https://github.com/linux-pam/linux-pam/releases/tag/v1.5.0) it\nheavily depends on the chosen login flow (i.e. headless, Wayland-based, etc.)\nhow to ideally inject the necessary environment variables. There is often a\nchicken and egg problem related to `XDG_CONFIG_HOME` as its customization must\nbe injected as early as possible, otherwise the systemd user variables are not\nloaded either.\n\nIn this case the problem is solved (read \"glued and hacked together\") via a\nseparate `wayfire-run` wrapper script which loads all environment variables and\nthen finally starts Wayfire. The login flow looks like this:\n\n```text\nBoot\n--\u003e greetd\n    --\u003e greetd-gtkgreet\n        --\u003e wayfire-run\n            --\u003e wayfire\n```\n\nThe [wayfire-run\nscript](https://github.com/karras/ansible-collection-workstation/tree/main/roles/wayfire)\nis deployed and managed via Ansible.\n\n## Components\n\nWhenever possible only GTK-based applications are used and the overall\napplication bloat should be kept at a minimum. Also, when configurable, the\nawesome [Nord theme](https://www.nordtheme.com/) is applied.\n\nBelow is an incomplete list of the covered main components:\n\n* User\n  - [Environment \u0026 XDG](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html)\n  - [Neovim](https://github.com/neovim/neovim)\n  - [Terminator](https://github.com/gnome-terminator/terminator)\n  - [ZSH](https://www.zsh.org/)\n* Desktop\n  - [bemenu](https://github.com/Cloudef/bemenu)\n  - [greetd-gtkgreet](https://git.sr.ht/~kennylevinsen/gtkgreet)\n  - [mako](https://github.com/emersion/mako)\n  - [Wayfire](https://github.com/WayfireWM/wayfire)\n  - [Waybar](https://github.com/Alexays/Waybar)\n  - [swaylock](https://github.com/swaywm/swaylock)\n  - [swaybg](https://github.com/swaywm/swaybg)\n  - [swayidle](https://github.com/swaywm/swayidle)\n\n### Screenshots\n\n![Desktop](./docs/desktop.png)\n\n## Installation\n\n* Clone this repository to the destination of your choice (e.g.\n  `~/git/dotfiles`)\n\n* Ensure you have injected at least the above mentioned XDG variables into the\n  environment\n\n* Install all dotfiles, make sure the `~/.local` directory is removed first:\n\n  ```sh\n  cd ~\n  ln -s /path/to/this/repo .local\n  ```\n\n* Copy your desktop wallpaper to `~/.local/share/backgrounds/wallpaper.png`,\n  which will be used by `swaybg`\n\n* Copy your lock screen wallpaper to\n  `~/.local/share/backgrounds/wallpaper_lockscreen.png`, which will be used by\n  `swaylock`\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarras%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkarras%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarras%2Fdotfiles/lists"}