{"id":13897877,"url":"https://github.com/dannynimmo/punctual-zsh-theme","last_synced_at":"2025-07-17T15:30:59.112Z","repository":{"id":56218977,"uuid":"64589148","full_name":"dannynimmo/punctual-zsh-theme","owner":"dannynimmo","description":"Punctual, a Zsh prompt theme","archived":false,"fork":false,"pushed_at":"2022-12-11T23:31:01.000Z","size":64,"stargazers_count":54,"open_issues_count":0,"forks_count":19,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-12-06T19:58:02.615Z","etag":null,"topics":["zsh","zsh-theme"],"latest_commit_sha":null,"homepage":null,"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/dannynimmo.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":"2016-07-31T10:39:32.000Z","updated_at":"2024-11-21T15:17:18.000Z","dependencies_parsed_at":"2023-01-27T09:05:16.644Z","dependency_job_id":null,"html_url":"https://github.com/dannynimmo/punctual-zsh-theme","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/dannynimmo/punctual-zsh-theme","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dannynimmo%2Fpunctual-zsh-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dannynimmo%2Fpunctual-zsh-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dannynimmo%2Fpunctual-zsh-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dannynimmo%2Fpunctual-zsh-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dannynimmo","download_url":"https://codeload.github.com/dannynimmo/punctual-zsh-theme/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dannynimmo%2Fpunctual-zsh-theme/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265622557,"owners_count":23799994,"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":["zsh","zsh-theme"],"created_at":"2024-08-06T18:03:55.792Z","updated_at":"2025-07-17T15:30:58.845Z","avatar_url":"https://github.com/dannynimmo.png","language":"Shell","funding_links":[],"categories":["Themes","Shell"],"sub_categories":["ZSH on Windows","Zinit (née zplugin)"],"readme":"# Punctual, a Zsh prompt theme\n\n![Screenshot of Punctual in action](./screenshot.png)\n\nAdd a bit of flavour to your prompt! My personal Zsh prompt theme, influenced heavily by [denysdovhan](https://github.com/denysdovhan)'s [Spaceship theme](https://github.com/denysdovhan/spaceship-zsh-theme).\n\n\n## Features\n\n* Customisable colours \u0026 output\n* Git branch \u0026 status display\n* Username turns red when root\n* Prompt turns red if the last command finishes with non-zero exit code\n\n\n## Installation\n\nIn the screenshot above I'm using [Solarized colours](https://github.com/altercation/solarized/tree/master/iterm2-colors-solarized) for [iTerm2](https://www.iterm2.com/), along with the [Inconsolata font](https://www.google.com/fonts/specimen/Inconsolata).\n\n### Oh My Zsh\n\n1. Download [punctual.zsh-theme](https://raw.githubusercontent.com/dannynimmo/punctual-zsh-theme/v0.1.0/punctual.zsh-theme) into your custom theme directory, `$ZSH_CUSTOM/themes`\n2. Update `ZSH_THEME=\"punctual\"` in your `~/.zshrc`\n3. Open a new terminal to see the theme\n\n### Antigen\nInclude the following line to `~/.zshrc` as part of your antigen setup (after any [configuration settings](#configuration)).\n```zsh\nantigen theme dannynimmo/punctual-zsh-theme punctual\n```\n\n\n## Configuration\n\nBy setting variables before loading the theme, you can customise the output format of Punctual.\n\n### Hiding parts\n\nSet any of the following variables to `\"false\"` to hide the output.\n\n```zsh\nPUNCTUAL_SHOW_BLANK_LINE=\"false\";\nPUNCTUAL_SHOW_TIMESTAMP=\"false\";\nPUNCTUAL_SHOW_USER=\"false\";\nPUNCTUAL_SHOW_HOSTNAME=\"false\";\nPUNCTUAL_SHOW_CURRENT_DIR=\"false\";\nPUNCTUAL_SHOW_GIT=\"false\";\n```\n\n### Colours\n\nSet any of the following variables to one of the 8 ANSI colour names.\n\n```zsh\nPUNCTUAL_TIMESTAMP_COLOUR=\"red\";\nPUNCTUAL_USER_COLOUR=\"green\";\nPUNCTUAL_ROOT_USER_COLOUR=\"yellow\";\nPUNCTUAL_HOSTNAME_COLOUR=\"blue\";\nPUNCTUAL_CURRENT_DIR_COLOUR=\"magenta\";\nPUNCTUAL_GIT_COLOUR=\"cyan\";\n```\n\nPossible values are:\n\n* `black`\n* `red`\n* `green`\n* `yellow`\n* `blue`\n* `magenta`\n* `cyan`\n* `white`\n\n### Bold fonts\n\nSet any of the following variables to `\"true\"` to use the terminal's bold font.\n\n```zsh\nPUNCTUAL_TIMESTAMP_BOLD=\"true\";\nPUNCTUAL_USER_BOLD=\"true\";\nPUNCTUAL_ROOT_USER_BOLD=\"true\";\nPUNCTUAL_HOSTNAME_BOLD=\"true\";\nPUNCTUAL_CURRENT_DIR_BOLD=\"true\";\nPUNCTUAL_GIT_BOLD=\"true\";\n```\n\n### Timestamp format\n\nSet the below variable to customise the timestamp format. See [`man strftime`](http://man7.org/linux/man-pages/man3/strftime.3.html) for format options.\n\n```zsh\nPUNCTUAL_TIMESTAMP_FORMAT=\"%l:%M%P\";\n```\n\n### Prompt symbol\n\nSet the below variable to your favourite prompt symbol (or emoji 😅).\n\n```zsh\nPUNCTUAL_PROMPT=\"$\";\n```\n\n### Git status symbols\n\nIf you already have your `ZSH_THEME_GIT_PROMPT_*` variables set, Punctual will respect those. Alternatively, set the following variables to customise the Git status symbols.\n\n```zsh\nPUNCTUAL_GIT_SYMBOL_UNTRACKED=\"?\";\nPUNCTUAL_GIT_SYMBOL_ADDED=\"+\";\nPUNCTUAL_GIT_SYMBOL_MODIFIED=\"!\";\nPUNCTUAL_GIT_SYMBOL_RENAMED=\"!\";\nPUNCTUAL_GIT_SYMBOL_DELETED=\"!\";\nPUNCTUAL_GIT_SYMBOL_STASHED=\"*\";\nPUNCTUAL_GIT_SYMBOL_UNMERGED=\"M\";\nPUNCTUAL_GIT_SYMBOL_AHEAD=\"↑\";\nPUNCTUAL_GIT_SYMBOL_BEHIND=\"↓\";\nPUNCTUAL_GIT_SYMBOL_DIVERGED=\"~\";\n```\n\n\n### Python environments\n\nThe Python environment being used (conda or virtualenvironment) will be added if the following flag is set to true (false by default) in your `.zshrc`:\n\n```zsh\nPUNCTUAL_SHOW_PYTHON_ENVIRONMENT=true\n```\n\nFor conda, run the following command to disable the prompt that appears at the start of the line by default:\n\n```zsh\nconda config --set changeps1 False\n\n```zsh\nAnd similarly for python virtual environments you can add (either of) the following commands to your .zshrc to disable the prompt:\n       \n```zsh\nexport VIRTUAL_ENV_DISABLE_PROMPT=1;\nexport PYENV_VIRTUALENV_DISABLE_PROMPT=1;\n```\n\n## Changelog\n\n### [0.4.0](https://github.com/dannynimmo/punctual-zsh-theme/releases/tag/v0.4.0) — 2022-12-12\n* Added Python support\n\n### [0.3.0](https://github.com/dannynimmo/punctual-zsh-theme/releases/tag/v0.3.0) — 2020-11-19\n* Added ability to disable the initial new line\n\n### [0.2.0](https://github.com/dannynimmo/punctual-zsh-theme/releases/tag/v0.2.0) — 2016-09-16\n* Added ability to use bold fonts\n\n### [0.1.0](https://github.com/dannynimmo/punctual-zsh-theme/releases/tag/v0.1.0) — 2016-08-01\n* Released!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdannynimmo%2Fpunctual-zsh-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdannynimmo%2Fpunctual-zsh-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdannynimmo%2Fpunctual-zsh-theme/lists"}