{"id":20923710,"url":"https://github.com/cloverinteractive/dotfiles","last_synced_at":"2025-05-13T16:30:41.821Z","repository":{"id":2201665,"uuid":"3150231","full_name":"cloverinteractive/dotfiles","owner":"cloverinteractive","description":"Everyday use .dotfiles","archived":false,"fork":false,"pushed_at":"2025-04-30T16:13:59.000Z","size":2152,"stargazers_count":26,"open_issues_count":1,"forks_count":6,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-30T17:28:27.323Z","etag":null,"topics":["dotfiles","homebrew","linuxbrew"],"latest_commit_sha":null,"homepage":"cloverinteractive.github.com/dotfiles","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloverinteractive.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,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2012-01-11T01:29:59.000Z","updated_at":"2024-12-05T00:17:57.000Z","dependencies_parsed_at":"2023-01-11T16:08:33.237Z","dependency_job_id":"f35d41ce-04b6-4680-acc8-838f1878aafa","html_url":"https://github.com/cloverinteractive/dotfiles","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloverinteractive%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloverinteractive%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloverinteractive%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloverinteractive%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloverinteractive","download_url":"https://codeload.github.com/cloverinteractive/dotfiles/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253981657,"owners_count":21994313,"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","homebrew","linuxbrew"],"created_at":"2024-11-18T20:17:29.672Z","updated_at":"2025-05-13T16:30:40.634Z","avatar_url":"https://github.com/cloverinteractive.png","language":"Lua","readme":"# dotfiles\n\nThis is a collection of dotfiles that should make your day to day work easier, if you see any errors or wish to contribute feel free to fork, open an issue\nor send a pull request.\n\n## Dependencies\n\nWe try to keep dependencies to a minimum and let you sort them out yourself, whether you prefer homebrew or your OS package manager the choice is yours\nto make, the only three dependecies are:\n\n1. `curl`\n1. `git`\n1. `node`\n\n## Install\n\nWe try to keep installing as  simple as possible by keeping the steps to a minimum and our dotfiles as backward compatible across the couple of OS we use\nthe most.\n\n### Online installer\n\nYou can run the installer using curl:\n\n`curl https://raw.githubusercontent.com/cloverinteractive/dotfiles/master/install | bash`\n\nCheck our [developers](#developers) section of this README to learn how to run the installer in a virtual machine.\n\n### Github checkout\n\nYou can fork or clone this repository manually and run the installer locally:\n\n```bash\n# We like to keep dotfiles somewhere in $HOME but you can clone anywhere you have permission to\ngit clone https://github.com/cloverinteractive/dotfiles.git ~/.dotfiles\n\ncd ~/.dotfiles\n./install -s\n```\n\n### Advanced (not recommended)\n\nSince we're using stow to manage the dotfiles under the hood, you can skip the installer and just stow files directly like\nthis, however depending on your system configuration you will need to set the directory and target manually, we've tried\nto make things xdg compliant but cannot guarantee that will be the case if things are stowed manually:\n\n```bash\ncd .dotfiles\nstow -d .config/bash -t .config\n```\n\nWhen doing this keep in mind that uninstalling can also get tricky and you'll need to remember how you linked your configs.\n\n## Uninstall\n\nTo uninstall you can do `stow -D .` from your `.dotifles` directory and that will unlink all the files from that directory.\n\n## Commands that will make this enjoyable\n\nThese dotfiles include configuration tweaks for:\n\n* ack\n* bash\n* cava\n* dunst\n* git\n* i3\n* kitty\n* mpd\n* ncmpcpp\n* nvim\n* pg (postgresql)\n* picom\n* ranger\n* tmux\n* X11\n* xmobar\n* xmonad\n\nTo get most of these dotfiles we recommend installing these packages\n\n## Developers\n\nWe try to make development as simple as possible for [ourselves](https://github.com/cloverinteractive/dotfiles/graphs/contributors), therefore we've added\nin a `Dockerfile` and a `Containerfile` for running our scripts in an OCI container.\n\nIf you wish to see how these dotfiles look/feel  without installing them in your system  or you wisht to contribute please consider installing \n[podman](https://podman.io/getting-started/installation) or [docker](https://docs.docker.com/engine/install/) and giving this a try:\n\n```bash\n# Podman instructions\n\npodman build . -t dotfiles # Will build a OCI container image this may take a couple of minutes\npodman run --rm -it dotfiles # This will put you in the containers command prompt\n\n# Docker instructions\n\ndocker build . -t dotfiles # Will build a OCI image this may take a couple of minutes\ndocker run --rm -it dotfiles # This will put you in the containers command prompt\n```\n\nOnce in the container you'll have your current branch of dotfiles installed, if you need to install anything the test user in the container has `sudo.\nWe try to keep both the `Containerfile` and `Dockerfile` pretty light, only installing the bare minimum and anything else that's needed and not readily\navailable in the container's distro package manager; the idea is to not add too many dependencies in order to ensure fast build times.\n\nAs you can see podman's CLI is compatible with docker's, we recommend podman over docker for two main reasons:\n\n1. it's daemonless\n1. it's rootles\n\nYou can install podman and add an alias like `alias docker=podman` and you won't have to build new muscle memory to get started.\n\n\n### Shells\n\nAt the moment we only add files for `bash` and `zsh` to keep things compatible with macs, if you'd like to\nstart your docker container with zsh just specify it as the run command like so:\n\n```bash\ndocker run --rm -it dotfiles zsh\n```\n\nThe same aliases, env vars and, prompt and paths should be set as bash if you'd like to inspect those files\nthey live under `.config/posix-shell`\n\n## Issues\n\nThese dotfiles are still in the works and are not perfect, feel free to advise, fork and send your pull requests.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloverinteractive%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloverinteractive%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloverinteractive%2Fdotfiles/lists"}