{"id":13479222,"url":"https://github.com/deinsoftware/dotfiles","last_synced_at":"2025-06-11T09:11:18.018Z","repository":{"id":116743122,"uuid":"390528988","full_name":"deinsoftware/dotfiles","owner":"deinsoftware","description":"dot Files: ZSH setup and productivity tools for development","archived":false,"fork":false,"pushed_at":"2025-03-08T02:33:58.000Z","size":303,"stargazers_count":16,"open_issues_count":0,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-30T12:22:08.259Z","etag":null,"topics":["bash","console","dotfiles","git","linux","oh-my-zsh","shell","terminal","vscode","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/deinsoftware.png","metadata":{"files":{"readme":"README.ES.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"zenodo":null},"funding":{"github":["deinsoftware"],"custom":["https://paypal.me/equiman/3"]}},"created_at":"2021-07-28T22:43:28.000Z","updated_at":"2025-04-09T10:19:02.000Z","dependencies_parsed_at":"2024-05-01T02:39:45.494Z","dependency_job_id":"0739daa0-6122-4a5c-b9cf-276efb39ef09","html_url":"https://github.com/deinsoftware/dotfiles","commit_stats":null,"previous_names":["deinsoftware/dotfiles"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deinsoftware%2Fdotfiles","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deinsoftware%2Fdotfiles/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deinsoftware%2Fdotfiles/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deinsoftware%2Fdotfiles/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/deinsoftware","download_url":"https://codeload.github.com/deinsoftware/dotfiles/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/deinsoftware%2Fdotfiles/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259236369,"owners_count":22826307,"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":["bash","console","dotfiles","git","linux","oh-my-zsh","shell","terminal","vscode","zsh"],"created_at":"2024-07-31T16:02:11.701Z","updated_at":"2025-06-11T09:11:17.754Z","avatar_url":"https://github.com/deinsoftware.png","language":"Shell","funding_links":["https://github.com/sponsors/deinsoftware","https://paypal.me/equiman/3","https://img.shields.io/badge/-GitHub%20Sponsors-gray?style=flat\u0026labelColor=171515\u0026logo=github\u0026logoColor=white\u0026link=https://github.com/sponsors/deinsoftware","https://img.shields.io/badge/-PayPal-gray?style=flat\u0026labelColor=00457C\u0026logo=paypal\u0026logoColor=white\u0026link=https://paypal.me/equiman/3"],"categories":["Shell"],"sub_categories":[],"readme":"# dotfiles\n\nLanguages: [🇪🇸] [Español](README.ES.md) - [🇺🇸] [English](README.md)\n\nZSH setup and productivity tools for development\n\n## Repo\n\n### 1. Clone\n\nClone this repo on `~/.dotfiles` path:\n\n```bash\ngit clone https://github.com/deinsoftware/dotfiles.git ~/.dotfiles\n```\n\n### 2. Setup\n\nOn `.zshrc` file add.\n\n```bash\n# Utils\nsource ~/.dotfiles/utils/source\n\n# Configs\nexport USE_PROMPT=\"p10k\" # p10k | starship\nexport USE_MANAGER=\"zinit\" # omz | zinit\n\n# Prompt\nif [ \"$USE_PROMPT\" = \"p10k\" ]; then\n    add_source ~/.dotfiles/configs/prompts/p10k\nfi\n\n# \u003csource packages required to be load before the plugins\u003e\n\n# Manager\nif [ \"$USE_MANAGER\" = \"omz\" ]; then\n    add_source ~/.dotfiles/configs/managers/omz\nelif [ \"$USE_MANAGER\" = \"zinit\" ]; then\n    add_source ~/.dotfiles/configs/managers/zinit\nfi\n# Prompt\nif [ \"$USE_PROMPT\" = \"starship\" ]; then\n    add_source ~/.dotfiles/configs/prompts/starship\nfi\n# Plugins\nadd_source ~/.dotfiles/configs/plugins/fzf\n\n# \u003csource packages required to be load after the plugins\u003e\n\n# Helpers\nexport PLAYGROUND_DIR=\"$HOME/Developer/dein/dev-playground\"\n\nexport WINHOME=$(wslpath \"$(wslvar USERPROFILE)\")\nexport OPEN=\"wslview\" #wsl2\nexport BROWSER=\"${OPEN}\" #wsl2\n\nexport PATH=\"$HOME/.dotfiles/helpers/android/:$PATH\"\nexport PATH=\"$HOME/.dotfiles/helpers/b64/:$PATH\"\nexport PATH=\"$HOME/.dotfiles/helpers/code/:$PATH\"\nexport PATH=\"$HOME/.dotfiles/helpers/md/:$PATH\"\nexport PATH=\"$HOME/.dotfiles/helpers/open/:$PATH\"\nexport PATH=\"$HOME/.dotfiles/helpers/search/:$PATH\"\nexport PATH=\"$HOME/.dotfiles/helpers/terminal/:$PATH\"\nchmod +x ~/.dotfiles/helpers/**/* ~/.dotfiles/helpers/**/.[!.]*\n\n# Custom\nadd_source ~/.dotfiles/.aliases\nadd_source ~/.dotfiles/.configs\nadd_source ~/.dotfiles/.colors\nadd_source ~/.dotfiles/.hooks\n```\n\n\u003e `OPEN` and `BROWSE` constants need to be configured according yor OS. Windows (WSL2) and macOS use the same command to open the file explorer or the default web browser, on Ubuntu (Linux) need to be specified each one.\n\n| SO                | `OPEN`                                         | `BROWSER`                         |\n| ----------------- | ---------------------------------------------- | --------------------------------- |\n| Windows (GitBash) | `\"explorer.exe\"`                               | `\"${OPEN}\"`                       |\n| Windows (WSL2)    | `\"wslview\"`                                    | `\"${OPEN}\"`                       |\n| macOS             | `\"open\"`                                       | `\"${OPEN}\"`                       |\n| Ubuntu            | `\"xdg-open\"`, `\"gnome-open\"`, `\"nautilus\"` ... | `\"googlechrome\"`, `\"firefox\"` ... |\n\n\u003e On WSL require to install [wslu](https://wslutiliti.es)\n\n### 3. Permissions\n\nNow add execution permission:\n\n```bash\nchmod +x ~/.dotfiles/helpers/**/* ~/.dotfiles/helpers/**/.[!.]*\n```\n\n### 4. Update\n\nOnce finish, save `.zshrc` file, close and reopen all terminals or update his source running `source ~/.zshrc` command.\n\nThat's all folks! It's ready to use.\n\n## Folder Structure\n\n```bash\n~\n└── .zshrc\n└── .dotfiles\n    ├── configs\n    ├── helpers\n    │   ├── android\n    │   ├── b64\n    │   ├── code\n    │   ├── md\n    │   ├── open\n    │   ├── search\n    │   └── terminal\n    ├── .aliases\n    ├── .colors\n    ├── .configs\n    └── .hooks\n```\n\n|Name          |Description                                                                                |\n|--------------|-------------------------------------------------------------------------------------------|\n|`.zshrc`      | ZSH source file                                                                           |\n|`configs`     | Folder with global configurations to use in other scripts                                 |\n|`helpers`     | Folder with custom helper functions to use as terminal commands                           |\n| ── `android` | Helper commands for Android tools                                                         |\n| ── `b64`     | Helper commands for file conversions to/from base64                                       |\n| ── `code`    | Helper commands to open VSCode                                                            |\n| ── `open`    | Helper commands to open file/folder on the File Explorer or open files/url on the Browser |\n| ── `search`  | Helper commands to search text inside files                                               |\n| ── `terminal`| Helper commands to talk with the OS                                                       |\n|`.aliases`    | File for aliases definitions                                                              |\n|`.colors`     | File with terminal colors to use in other scripts                                         |\n|`.configs`    | File for global configuratins.                                                            |\n|`.hooks`      | ZSH hooks file with custom functions to run as validation before and after run commands   |\n\n## Plugins\n\n**Oh My zsh!** have [a lot of plugins](https://github.com/ohmyzsh/ohmyzsh/wiki/Plugins) to use. It's recommended to explore the options and use what is good for your needs.\n\n\u003e If you are using **NVM** take care of following this [configuration to avoid slowing the zsh start-up](https://lakur.tech/2021/12/10/fix-slow-zsh-startup-nvm/) and this [configuration to speed up the compinit](https://gist.github.com/ctechols/ca1035271ad134841284?permalink_comment_id=3365691)\n\n### Official\n\n* [adb](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/adb)\n* [brew](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/brew)\n* [docker](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/docker)\n* [git](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git)\n* [git-lfs](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git-lfs)\n* [github](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/github)\n* [gitignore](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/gitignore)\n* [history-substring-search](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/history-substring-search)\n* [node](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/node)\n* [npm](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/npm)\n* [nvm](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/nvm)\n* [vscode](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/vscode)\n* [sudo](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/sudo)\n* [web-search](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/web-search)\n* [z](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/z)\n\n### Extras\n\n* [zsh-autosuggestions](https://github.com/zsh-users/zsh-autosuggestions)\n* [fast-syntax-highlighting](https://github.com/zdharma-continuum/fast-syntax-highlighting)\n* [OhMyZsh-full-autoupdate](https://github.com/Pilaton/OhMyZsh-full-autoupdate)\n* [zsh-you-should-use](https://github.com/MichaelAquilina/zsh-you-should-use)\n\n```bash\ngit clone https://github.com/zsh-users/zsh-autosuggestions.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions\ngit clone https://github.com/zdharma-continuum/fast-syntax-highlighting.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/fast-syntax-highlighting\ngit clone https://github.com/Pilaton/OhMyZsh-full-autoupdate.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/ohmyzsh-full-autoupdate\ngit clone https://github.com/MichaelAquilina/zsh-you-should-use.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-you-should-use\n```\n\nEdit the `~/.zshrc` file and add it inside the `plugins` property (don't use commas as separators).\n\n```diff\nplugins=(\n    ...\n+   zsh-autosuggestions\n+   fast-syntax-highlighting\n+   ohmyzsh-full-autoupdate\n+   you-should-use\n)\n```\n\n## Article Series\n\n* [iTerm2 + Oh My Zsh! + Powerlevel10K best terminal combination for Geeks!](https://dev.to/equiman/iterm2--oh-my-zsh--powerlevel9k-best-terminal-combination-for-geeks-58l5)\n* [Why Oh My ZSH is so cool?](https://dev.to/equiman/why-oh-my-zsh-is-so-cool-31gd)\n* [Useful Alias for ZSH](https://dev.to/equiman/useful-alias-for-zsh-1j8b)\n* [Reveal the command behind an alias with ZSH](https://dev.to/equiman/reveal-the-command-behind-an-alias-with-zsh-4d96)\n* [Command validations with ZSH](https://dev.to/equiman/command-validations-with-zsh-2boa)\n* [Open File Explorer and Browser from ZSH](https://dev.to/equiman/open-file-explorer-and-browser-mbb)\n* [ZSH cheatsheet for git plugin](https://dev.to/equiman/zsh-cheatsheet-for-git-plugin-1f6a)\n\n---\n\n## About\n\n### Built With\n\n* [VS Code](https://code.visualstudio.com/) - Code editing redefined.\n* [Widows Terminal](https://github.com/Microsoft/Terminal/) - A modern terminal application for users of command-line tools and shells.\n\n### Versioning\n\nWe use [SemVer](http://semver.org/) for versioning. For the versions available, see the [ZSH Dev Toolkit](https://github.com/deinsoftware/zsh-dev-toolkit/tags) on GitHub.\n\n### Authors\n\n* **Camilo Martinez** [Equiman](http://github.com/equiman)]\n\nSee also the list of [contributors](https://github.com/deinsoftware/zsh-dev-toolkit/contributors) who participated in this project.\n\n### Sponsors\n\nIf this project helps you, consider buying me a cup of coffee.\n\n[![GitHub Sponsors](https://img.shields.io/badge/-GitHub%20Sponsors-gray?style=flat\u0026labelColor=171515\u0026logo=github\u0026logoColor=white\u0026link=https://github.com/sponsors/deinsoftware)](https://github.com/sponsors/deinsoftware)\n[![paypal](https://img.shields.io/badge/-PayPal-gray?style=flat\u0026labelColor=00457C\u0026logo=paypal\u0026logoColor=white\u0026link=https://paypal.me/equiman/3)](https://paypal.me/equiman/3)\n\n### License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE.md) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeinsoftware%2Fdotfiles","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeinsoftware%2Fdotfiles","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeinsoftware%2Fdotfiles/lists"}