{"id":13894872,"url":"https://github.com/blaenk/dots","last_synced_at":"2025-07-17T10:31:32.889Z","repository":{"id":1728726,"uuid":"2466944","full_name":"blaenk/dots","owner":"blaenk","description":"my dot files","archived":false,"fork":false,"pushed_at":"2023-08-23T00:57:48.000Z","size":2456,"stargazers_count":55,"open_issues_count":0,"forks_count":5,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-08-07T18:31:50.895Z","etag":null,"topics":["dotfiles","emacs","vim","zsh"],"latest_commit_sha":null,"homepage":"https://jip.dev/posts/dots/","language":"Emacs Lisp","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"liammclennan/JavaScript-Koans","license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blaenk.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"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}},"created_at":"2011-09-27T10:34:40.000Z","updated_at":"2024-07-08T04:37:21.000Z","dependencies_parsed_at":"2024-04-08T18:06:39.891Z","dependency_job_id":null,"html_url":"https://github.com/blaenk/dots","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/blaenk%2Fdots","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blaenk%2Fdots/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blaenk%2Fdots/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blaenk%2Fdots/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blaenk","download_url":"https://codeload.github.com/blaenk/dots/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226255201,"owners_count":17595859,"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":["dotfiles","emacs","vim","zsh"],"created_at":"2024-08-06T18:01:49.586Z","updated_at":"2024-11-25T00:30:18.392Z","avatar_url":"https://github.com/blaenk.png","language":"Emacs Lisp","funding_links":[],"categories":["Emacs Lisp"],"sub_categories":[],"readme":"These are my dotfiles. Read about them [here](http://www.blaenkdenum.com/posts/dots/).\n\n### Dependencies\n\nThere are no real, hard dependencies since these are simply configuration files, aside from perhaps the font that I use if you don't change it. That said, here are some programs I use for which these configuration files mainly exist:\n\n- Font: DejaVu Sans Mono, `ttf-dejavu`\n- Terminal: urxvt, AUR `rxvt-unicode-patched`\n- Terminal Multiplexer: `tmux`\n- Emacs 25\n- vim + gvim: `gvim`\n- Shell: `zsh`\n- Awk: `gawk` on Ubuntu\n- `wmctrl` for urxvt fullscreen\n- Fuzzy Complete: `fzf`\n- Searching: `rg`\n- Command Not Found: `pkgfile` (Arch)\n- `ls` colors: `colord`\n- Clipboard integration: `xsel`\n\n### Installation\n\n```bash\n$ git clone https://github.com/blaenk/dots.git ~/.dots\n$ cd ~/.dots\n$ dots install\n```\n\n### Usage\n\nRun the sprinkle script to deploy. It shows a prompt on how (or whether) to apply the files. The prompts are answered by providing the first letter of each word, e.g. \"backup\" would be \"b\". If you want to apply the action to every remaining item, capitalize the letter.\n\n```\n$ ./dots install\n\n  · sprinkling dots from /home/user/.dots!\n  · help: backup, overwrite, remove, skip\n          capitalize to apply to all remaining\n```\n\nOnce the zsh configuration files are deployed, you can use the `dots` command from anywhere to both deploy the dotfiles with `dots install` as well as update the dotfiles with `dots get`.\n\n```\nλ ~/.dots (master)\n» dots get\n\n  · checking for updates since be6d115\n  · updated to b234aef\n\n  + b234aef this is one more test\n  + 8a9b1ab this is a test for update command\n\n```\n\n#### zsh\n\nYou'll want to have zsh installed and setup for your user. Install it, then run the following command.\n\n```bash\n$ chsh -s $(which zsh)\n```\n\nAfterward, log out and log back in for the change to take effect. The first time you open a zsh shell, zplug (a zsh package manager) will download the packages I use.\n\n#### Theme Variant\n\nI use the [Solarized](http://ethanschoonover.com/solarized) color theme for everything. Run the `set-theme` command to properly configure your desired variant:\n\n```bash\n$ dots set-theme light\n\n# or\n$ dots set-theme dark\n```\n\nThis also installs the `.Xresources` file so that URxvt uses the appropriate theme.\n\nAn environment variable `USE_SOLARIZED_DARK` is exposed which, if set, means that the Solarized Dark theme is being used. This is used in Xresources, vim, emacs, tmux, fzf, and other configurations in order to fine-tune colors for the currently-enabled theme.\n\n#### Command Not Found\n\nYou can get functionality where, if you enter a command that's not installed on your system, zsh will tell you which package it _is_ available in, if it finds it in some package. This is available for Ubuntu and Archlinux.\n\nOn arch, you'll have to install `pkgfile` and then generate the metadata needed for this:\n\n```bash\n$ sudo pacman -S pkgfile\n$ sudo pkgfile -u\n$ abiword\nabiword may be found in the following packages:\n  extra/abiword 3.0.0-2 /usr/bin/abiword\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblaenk%2Fdots","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblaenk%2Fdots","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblaenk%2Fdots/lists"}