{"id":14982924,"url":"https://github.com/molovo/filthy","last_synced_at":"2025-10-29T18:31:43.920Z","repository":{"id":42233598,"uuid":"44558951","full_name":"molovo/filthy","owner":"molovo","description":"A disgustingly clean ZSH prompt","archived":false,"fork":false,"pushed_at":"2018-10-25T11:28:19.000Z","size":287,"stargazers_count":43,"open_issues_count":0,"forks_count":5,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-02T04:11:16.490Z","etag":null,"topics":["theme","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/molovo.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}},"created_at":"2015-10-19T19:37:24.000Z","updated_at":"2024-05-20T09:37:01.000Z","dependencies_parsed_at":"2022-08-23T15:50:57.216Z","dependency_job_id":null,"html_url":"https://github.com/molovo/filthy","commit_stats":null,"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/molovo%2Ffilthy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/molovo%2Ffilthy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/molovo%2Ffilthy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/molovo%2Ffilthy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/molovo","download_url":"https://codeload.github.com/molovo/filthy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238874313,"owners_count":19545161,"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":["theme","zsh","zsh-theme"],"created_at":"2024-09-24T14:06:25.449Z","updated_at":"2025-10-29T18:31:38.575Z","avatar_url":"https://github.com/molovo.png","language":"Shell","funding_links":[],"categories":["Themes"],"sub_categories":["ZSH on Windows","Zinit (née zplugin)"],"readme":"# Filthy\n\n\u003e A disgustingly clean ZSH prompt\n\n![](screenshots/title.png)\n\n\n## Overview\n\nBased on the great [pure theme](http://github.com/sindresorhus/pure) by [@sindresorhus](http://github.com/sindresorhus) and [@mafredri](https://github.com/mafredri), but with a few notable changes.\n\n* Prompt character is green when previous command was successful, red when not.\n* Git repo info shown in RPROMPT.\n* Path is shown relative to `git-root` when in a repository.\n* Current commit/tag shown if HEAD is detached.\n* 'Initial' status is shown in a new repo\n* User and host always shown in RPROMPT, green for standard users, red if privileged.\n* Command execution time shows in ms if less than one second has elapsed.\n* Temporary messages can be displayed in the pre-prompt, e.g. to show feedback after an asynchronous command has completed. Just echo the text you want to display to `${ZDOTDIR:-$HOME}/.promptmsg`. The message is automagically cleared once shown.\n\n## Install\n\nCan be installed with `npm` or manually. Requires git 1.7.10+ and ZSH 4.3.17+.\n\n(To show current tag/commit when head is detached, git 2.0.0+ is required. Otherwise it just shows 'no branch')\n\n### npm\n\n```\nnpm install --global filthy-prompt\n```\n\nThat's it. Skip to [Getting started](#getting-started).\n\n### [Zulu](http://github.com/zulu-zsh/zulu)\n\n```\nzulu install filthy\nzulu theme filthy\n```\n\n### Manually\n\n1. Either…\n  - Clone this repo\n  - add it as a submodule, or\n  - just download `filthy.zsh`\n\n2. Symlink `filthy.zsh` to somewhere in [`$fpath`](http://www.refining-linux.org/archives/46/ZSH-Gem-12-Autoloading-functions/) with the name `prompt_filthy_setup`.\n\n#### Example\n\n```\n$ ln -s \"$PWD/filthy.zsh\" /usr/local/share/zsh/site-functions/prompt_filthy_setup\n```\n*Run `echo $fpath` to see possible locations.*\n\nFor a user-specific installation (which would not require escalated privileges), simply add a directory to `$fpath` for that user:\n\n```sh\n# .zshenv or .zshrc\nfpath=( \"$HOME/.zfunctions\" $fpath )\n```\n\nThen install the theme there:\n\n```sh\n$ ln -s \"$PWD/filthy.zsh\" \"$HOME/.zfunctions/prompt_filthy_setup\"\n```\n\n## Getting started\n\nInitialize the prompt system (if not so already) and choose `filthy`:\n\n```sh\n# .zshrc\nautoload -U promptinit \u0026\u0026 promptinit\nprompt filthy\n```\n\n\n## Options\n\n### `FILTHY_CMD_MAX_EXEC_TIME`\n\nThe max execution time of a process before its run time is shown when it exits. Defaults to `5` seconds.\n\n### `FILTHY_SHOW_EXIT_CODE=1`\n\nPrints a nice exit code in front of the prompt character when the previous\ncommand exited with a status not equal to `0`\n\n### `FILTHY_SHOW_ZSH_VERSION=1`\n\nPrints the current value of `$ZSH_VERSION` in `$RPROMPT`\n\n### `FILTHY_ALWAYS_SHOW_FULL_PATH=1`\n\nDo not show relative paths when `$PWD` is within a git repository\n\n## Example\n\n```sh\n# .zshrc\n\nautoload -U promptinit \u0026\u0026 promptinit\n\n# optionally define some options\nFILTHY_CMD_MAX_EXEC_TIME=10\n\nprompt filthy\n```\n\n\n## Tips\n\n[Base16 Ocean](http://chriskempson.github.io/base16/#ocean) theme with the [Nitti Light](https://www.boldmonday.com/typeface/nitti/) font (18pt) is a beautiful combination, as seen in the screenshot above. Just make sure you have anti-aliasing enabled in your Terminal.\n\nTo have commands colorized as seen in the screenshot install [zsh-syntax-highlighting](https://github.com/zsh-users/zsh-syntax-highlighting).\n\n\n## Integration\n\n### [oh-my-zsh](https://github.com/robbyrussell/oh-my-zsh)\n\n1. Symlink (or copy) `filthy.zsh` to `~/.oh-my-zsh/custom/filthy.zsh-theme`\n2. Add `ZSH_THEME=\"filthy\"` to your `.zshrc` file.\n\n### [prezto](https://github.com/sorin-ionescu/prezto)\n\nSet `zstyle ':prezto:module:prompt' theme 'filthy'` in `~/.zpreztorc`.\n\n## License\n\nMIT © [James Dinsdale](https://molovo.co)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmolovo%2Ffilthy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmolovo%2Ffilthy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmolovo%2Ffilthy/lists"}