{"id":13529368,"url":"https://github.com/zoppo/zoppo","last_synced_at":"2025-12-18T00:04:33.422Z","repository":{"id":4906024,"uuid":"6062191","full_name":"zoppo/zoppo","owner":"zoppo","description":"The crippled configuration framework for Zsh","archived":false,"fork":false,"pushed_at":"2024-08-30T20:37:56.000Z","size":128,"stargazers_count":34,"open_issues_count":4,"forks_count":3,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-11-02T15:36:41.046Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"asis/flot-pyramid","license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zoppo.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2012-10-03T15:32:22.000Z","updated_at":"2024-08-27T17:06:41.000Z","dependencies_parsed_at":"2023-07-05T21:16:10.546Z","dependency_job_id":"485d19d4-7fd2-4cbb-be7e-3f00c73319c5","html_url":"https://github.com/zoppo/zoppo","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/zoppo%2Fzoppo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoppo%2Fzoppo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoppo%2Fzoppo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoppo%2Fzoppo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zoppo","download_url":"https://codeload.github.com/zoppo/zoppo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246662276,"owners_count":20813721,"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":[],"created_at":"2024-08-01T07:00:35.733Z","updated_at":"2025-04-01T15:30:54.509Z","avatar_url":"https://github.com/zoppo.png","language":"Shell","readme":"zoppo - the crippled configuration framework for Zsh\n====================================================\n*zoppo* is a configuration framework for [Zsh][1]; it enriches the command line\ninterface environment with sane defaults, aliases, functions, auto completion,\nand prompt themes.\n\nAs an italian saying goes: \"chi va con lo zoppo, impara a zoppicare\", we\nrealized we were walking with a cripple and are now going to become crippled\nourselves.\n\nInstallation\n------------\n*zoppo* will work with any recent release of Zsh, but the minimum recommended\nversion is 4.3.10.\n\n### The super dooper automatic way\n\n    wget -O- https://raw.github.com/zoppo/zoppo/master/bin/installer.zsh | zsh -s -- -y\n\n### The easy but full of questions way\n\n    wget -O- https://raw.github.com/zoppo/zoppo/master/bin/installer.zsh | zsh -s\n\n### The paranoid way\n\n  1. Launch Zsh:\n\n        zsh\n\n  2. Clone the repository:\n\n        git clone --branch default --recursive git://github.com/zoppo/zoppo.git \"${ZDOTDIR:-$HOME}/.zoppo\"\n\n  3. Create a new Zsh configuration by copying the Zsh configuration files\n     provided:\n\n        setopt EXTENDED_GLOB\n        for rcfile in \"${ZDOTDIR:-$HOME}\"/.zoppo/templates/^README.md(.N); do\n          cp \"$rcfile\" \"${ZDOTDIR:-$HOME}/.${rcfile:t}\"\n        done\n\n  4. Set Zsh as your default shell:\n\n        chsh -s /bin/zsh\n\n  5. Restart Zsh\n\n        exec zsh\n\n### Mac OS X\n\nIf you have administrator privileges, you must fix an Apple-introduced problem\nin Mac OS X 10.5 Leopard by executing the following command, or BASH and Zsh\nwill have the wrong `PATH` when executed non-interactively.\n\n    sudo chmod ugo-x /usr/libexec/path_helper\n\n`path_helper` is intended to make it easier for installers to add new paths to\nthe environment without having to edit shell configuration files by adding\na file with a path to the `/etc/paths.d` directory.\n\nUnfortunately, `path_helper` always reads paths from `/etc/paths` set by Apple\nthen paths from `/etc/paths.d` set by third party installers, and lastly paths\nfrom the `PATH` environment variable set by the parent process, which\nultimately is set by the user with `export PATH=...` Thus, it reorders path\npriorities, and user `/bin` directories meant to override system `/bin`\ndirectories end up at the tail of the array.\n\n### Troubleshooting\n\nIf you are not able to find certain commands after switching to *zoppo*,\nmodify the `PATH` variable in `~/.zshenv` then run `zoppo:restart`.\n\nUsage\n-----\n*zoppo* has many features disabled by default. Read the source code and\naccompanying README files to learn of what is available.\n\n### Plugins\n\n  1. Browse `/plugins` to see what is available.\n  2. Load the plugins you need in `~/.zopporc` then run `zoppo:restart`.\n\n### Prompts\n\n  1. For a list of prompts, type `prompt -l`.\n  2. To preview a prompt, type `prompt -p name`.\n  3. Load the theme you like in `~/.zopporc` then run `zoppo:restart`.\n\nCustomization\n-------------\nThe project is managed via [Git][3]. It is highly recommend that you commit\nyour changes and push them to [GitHub][4] to not lose them. If you do not know\nhow to use Git, follow this [tutorial][5] and bookmark this [reference][6].\n\nIf you make changes to the core and think they could be useful for others don't\nhesistate to open [an issue or a pull request][20] showing off the thing. It\nwill be discussed unless clearly useful and pertinent to belonging to the core.\n\nThe same reasoning can be applied to existing plugins, don't hesitate to open\n[an issue or pull request][21]. That applies to prompts too, just open [an\nissue or pull request][22].\n\nIf you want to write plugins for your personal use, it's suggested that you\ncreate your own plugins directory and add it to the plugins path, it will be\nautomatically used so you don't have to fiddle with git.\n\nTo add it just put in the `~/.zopporc`:\n\n    zdefault +a ':zoppo:path' plugins '/your/plugins/path'\n\nIf you want to write your own prompt and don't want to have it merged upstream, you\ncan do the same with prompts, just add your prompts path to the path:\n\n     zdefault +a ':zoppo:path' prompts '/your/prompts/path'\n\nResources\n---------\nThe [Zsh Reference Card][7] and the [zsh-lovers][8] man page are indispensable.\n\nLicense\n-------\nEverything is under WTFPL unless otherwise noted.\n\n[1]: http://www.zsh.org\n[3]: http://git-scm.com\n[4]: https://github.com\n[5]: http://gitimmersion.com\n[6]: http://gitref.org\n[7]: http://www.bash2zsh.com/zsh_refcard/refcard.pdf\n[8]: http://grml.org/zsh/zsh-lovers.html\n[20]: https://github.com/zoppo/zoppo/issues\n[21]: https://github.com/zoppo/plugins/issues\n[22]: https://github.com/zoppo/prompts/issues\n","funding_links":[],"categories":["Shells"],"sub_categories":["ZSH"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzoppo%2Fzoppo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzoppo%2Fzoppo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzoppo%2Fzoppo/lists"}