{"id":13479221,"url":"https://github.com/marlonrichert/zcolors","last_synced_at":"2025-07-22T00:32:42.341Z","repository":{"id":43769456,"uuid":"297968587","full_name":"marlonrichert/zcolors","owner":"marlonrichert","description":"🌈 Use your $LS_COLORS to generate a coherent theme for Git \u0026 your Zsh prompt, command line and completions.","archived":false,"fork":false,"pushed_at":"2025-04-22T05:44:27.000Z","size":657,"stargazers_count":82,"open_issues_count":3,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-06-02T18:00:05.402Z","etag":null,"topics":["color","completion","configuration","git","lscolors","prompt","shell","terminal","theme","theming","zsh","zsh-theme"],"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/marlonrichert.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,"zenodo":null},"funding":{"github":["marlonrichert"]}},"created_at":"2020-09-23T12:50:46.000Z","updated_at":"2025-04-22T05:44:31.000Z","dependencies_parsed_at":"2025-04-22T06:44:28.456Z","dependency_job_id":"928d3ce2-a148-49d1-bbde-d49a9f86c70b","html_url":"https://github.com/marlonrichert/zcolors","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/marlonrichert/zcolors","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marlonrichert%2Fzcolors","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marlonrichert%2Fzcolors/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marlonrichert%2Fzcolors/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marlonrichert%2Fzcolors/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/marlonrichert","download_url":"https://codeload.github.com/marlonrichert/zcolors/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/marlonrichert%2Fzcolors/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266404941,"owners_count":23923492,"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","status":"online","status_checked_at":"2025-07-21T11:47:31.412Z","response_time":64,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["color","completion","configuration","git","lscolors","prompt","shell","terminal","theme","theming","zsh","zsh-theme"],"created_at":"2024-07-31T16:02:11.677Z","updated_at":"2025-07-22T00:32:42.315Z","avatar_url":"https://github.com/marlonrichert.png","language":"Shell","funding_links":["https://github.com/sponsors/marlonrichert"],"categories":["Shell","Plugins"],"sub_categories":["ZSH on Windows"],"readme":"\n# 🌈 Z Colors\n\nUse your Gnu `$LS_COLORS` to generate a coherent theme for `git`, `less`, `grep`, and your Zsh\nprompt, completions and syntax highlighting. Don't know how to or don't feel like customizing your colors?\nNo worries: Z Colors comes with an excellent default theme, too.\n\nOnce you've [installed](#installation) Z Colors, then your theme is automatically applied to `git`,\n`less`, `grep`, and Zsh completions and [syntax highlighting](#requirements). No other steps are\nrequired. (For using Z Colors in your prompt, [see below](#prompt-colors).)\n\n\u003e Do you enjoy using this software? Then please consider to [become a\n\u003e sponsor](https://github.com/sponsors/marlonrichert). 💝\n\n\n## Requirements\n\nIf you use `$LS_COLORS`, then the values for `di`, `ln`, `so`, `pi`, `ex`, `bd`, `cd`, `su`, `sg`,\n`tw` and `ow` need to contain 3- or 4-bit colors only.  8- and 24-bit colors are currently _not_\nsupported!\n\nCompletion highlighting requires Zsh's [\"new\" completion\nsystem](https://zsh.sourceforge.io/Doc/Release/Completion-System.html).\n\nSyntax highlighting requires\n[`zsh-syntax-highlighting`](https://github.com/zsh-users/zsh-syntax-highlighting).\n\n\n## Installation\n\n1.  Open a terminal.\n\n1.  Run:\n    ```sh\n    cd ~/Repos  # or wherever you keep your Git repos/Zsh plugins\n    git clone https://github.com/marlonrichert/zcolors.git\n    ```\n\n1.  Complete the steps for [customizing your theme](#customizing-your-theme).\n\n1.  Add to your `~/.zshrc` file:\n    ```sh\n    source ~/Repos/zcolors/zcolors.plugin.zsh\n    source ${$XDG_CACHE_HOME:=~/.cache}/zcolors\n    ```\n\nThen start a new terminal or shell to enjoy your theme.\n\n\n## Customizing your theme\n\nWhenever you want make changes to your theme, do the following:\n\n1.  In your terminal, set `$LS_COLORS` to your desired value.\n\n1.  Run:\n    ```sh\n    autoload -Uz ~/Repos/zcolors/functions/zcolors\n    zcolors ${(q+)LS_COLORS} \u003e| ${$XDG_CACHE_HOME:=~/.cache}/zcolors\n    ```\n\nThen start a new terminal or shell to enjoy your new theme.\n\n\n## Updating\n\n1.  Open a terminal and run `git -C ~/Repos/zcolors pull`.\n1.  Complete the steps for [customizing your theme](#customizing-your-theme).\n\n\n# Prompt colors\n\nFor adding colors to your prompt, Z Colors provides an associative array `$zcolor` containing the\ntheme values for file types `di`, `ln`, `so`, `pi`, `ex`, `bd`, `cd`, `su`, `sg`, `tw` and `ow`.\nHere's an example of how to use it:\n```sh\n# $'...': string with support for `print` escape codes\n# %{\u003cesc\u003e%}: Tell the prompt that \u003cesc\u003e is zero-width output.\n# %{\\e[m%}: Reset all colors and other highlighting.\n# %~: present working dir\n# %#: `%` for normal user, `#` for root\nPS1=$'%{\\e['$zcolor[di]$'m%}%~%{\\e[m%}/ %# '\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarlonrichert%2Fzcolors","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarlonrichert%2Fzcolors","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarlonrichert%2Fzcolors/lists"}