{"id":16117364,"url":"https://github.com/trystan2k/zsh-tab-title","last_synced_at":"2025-05-12T04:30:27.393Z","repository":{"id":42331620,"uuid":"231663585","full_name":"trystan2k/zsh-tab-title","owner":"trystan2k","description":"A ZSH plugin to set the terminal tab title according to current directory or running process. It's based (forked) from Oh-My-ZSH one.","archived":false,"fork":false,"pushed_at":"2024-05-29T06:31:42.000Z","size":99,"stargazers_count":49,"open_issues_count":0,"forks_count":10,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-31T23:51:14.308Z","etag":null,"topics":["zplugin","zsh","zsh-plugin"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/trystan2k.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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":"2020-01-03T20:53:25.000Z","updated_at":"2025-03-17T23:13:15.000Z","dependencies_parsed_at":"2024-05-29T07:56:16.940Z","dependency_job_id":"5c4022ee-5203-4792-9e94-6c3892413e16","html_url":"https://github.com/trystan2k/zsh-tab-title","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trystan2k%2Fzsh-tab-title","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trystan2k%2Fzsh-tab-title/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trystan2k%2Fzsh-tab-title/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trystan2k%2Fzsh-tab-title/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/trystan2k","download_url":"https://codeload.github.com/trystan2k/zsh-tab-title/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253675034,"owners_count":21945884,"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":["zplugin","zsh","zsh-plugin"],"created_at":"2024-10-09T20:44:24.565Z","updated_at":"2025-05-12T04:30:27.049Z","avatar_url":"https://github.com/trystan2k.png","language":"Shell","funding_links":[],"categories":["Plugins"],"sub_categories":["ZSH on Windows","Zinit (née zplugin)"],"readme":"# ZSH Tab Title\n\n**IMPORTANT:** Since May/2024 the default branch has changed from `master` to `main`. If you have this plugin installed or have cloned this repository before this date, you need to update your local repository to use the new branch. You can do this by executing the following command in the repository folder:\n\n```sh\ngit branch -m master main\ngit fetch origin\n\ngit branch -u origin/main main\n```\n\nOr uninstalling the plugin and installing it again.\n\n**======**\n\n[![GitHub version](https://badge.fury.io/gh/trystan2k%2Fzsh-tab-title.svg)](https://badge.fury.io/gh/trystan2k%2Fzsh-tab-title)\n\n![Build](https://github.com/trystan2k/zsh-tab-title/workflows/CI-workflow/badge.svg)\n\nA zsh plugin that allows you to set a terminal header like any of PROMPT\n\nA ZSH plugin that automatically sets terminal tab titles based on current location and task.\n\nThis is completely based on [oh-my-zsh](https://github.com/ohmyzsh/ohmyzsh/blob/master/lib/termsupport.zsh) term support library.\n\n## Installation\n\n### Using [zinit](https://github.com/zdharma/zinit)\n\nAdd `zinit light trystan2k/zsh-tab-title` into `.zshrc`\n\n### Using [zpm](https://github.com/zpm-zsh/zpm)\n\nAdd `zpm load trystan2k/zsh-tab-title` into `.zshrc`\n\n### Using [oh-my-zsh](https://github.com/robbyrussell/oh-my-zsh)\n\nExecute `git clone https://github.com/trystan2k/zsh-tab-title ~/.oh-my-zsh/custom/plugins/zsh-tab-title`. Add `zsh-tab-title` into plugins array in `.zshrc`\n\n### Using [antigen](https://github.com/zsh-users/antigen)\n\nAdd `antigen bundle trystan2k/zsh-tab-title` into `.zshrc`\n\n### Using [zgen](https://github.com/tarjoilija/zgen)\n\nAdd `zgen load trystan2k/zsh-tab-title` into `.zshrc`\n\n## Configuration\n\nYou can configure the prefix and/or suffix to be showed in tab title, besides the current folder.\n\n### DISABLE\n\nYou can disable the plugin adding\n\n```sh\nZSH_TAB_TITLE_DISABLE_AUTO_TITLE=true\n```\n\n### CURRENT FOLDER\n\nYou can display in the tab title, just the last folder you are in. So for example, if you are at `/home/user/zsh-tab-title`, the tab will only display `zsh-tab-title`. The default behavior, it will show the complete path, truncated at 20 chars. To enable current folder only, do:\n\n```sh\nZSH_TAB_TITLE_ONLY_FOLDER=true\n```\n\n### CONCAT FOLDER AND PROCESS\n\nWhen executing a command, it is showed in the tab title. You can setup to concatenate the current folder to it, so it can display, for example, `zsh-tab-title:ls`, when doing a `ls` in `/home/user/zsh-tab-title`. To enable concat folder and process, do:\n\n```sh\nZSH_TAB_TITLE_CONCAT_FOLDER_PROCESS=true\n```\n\n### FULL COMMAND\n\nEnable to show the full command being run with it's arguments in the tab title. For example, ``nano .zshrc`` will show ``nano .zshrc`` instead of just ``nano``. Default is to display only the command without it's arguments.\n\n```sh\nZSH_TAB_TITLE_ENABLE_FULL_COMMAND=true\n```\n\n### PREFIX\n\nThe prefix can be configured using the variable `ZSH_TAB_TITLE_PREFIX` and it will be added **before** the current folder, in tab title. For example:\n\n```sh\nZSH_TAB_TITLE_PREFIX='$USER@$HOST - '\n```\n\nBy default, if no value is informed, it is used the value `%m@%n:` which will show the user name and computer name, separated by @. For example: `trystan2k@MyPC: /home/trystan2k`. This default value can be disabled if variable `ZSH_TAB_TITLE_DEFAULT_DISABLE_PREFIX` is set to true. For example:\n\n```sh\nZSH_TAB_TITLE_DEFAULT_DISABLE_PREFIX=true\n```\n\n### SUFFIX\n\nThe suffix can be configured using the variable `ZSH_TAB_TITLE_SUFFIX` and it will be added **after** the current folder, in tab title. For example:\n\n```sh\nZSH_TAB_TITLE_SUFFIX='- $USER'\n```\n\nThis variable has no default value, so if nothing is informed, no suffix is added\n\n### ADDITIONAL TERMS\n\nBy default the tab title is set for iTerm, Hyper, and where ``$TERM`` is set to one of ``cygwin,xterm*,putty*,rxvt*,ansi,screen*,tmux*``\nAdditional $TERMS to set the tab title for can be configured with the variable ``ZSH_TAB_TITLE_ADDITIONAL_TERMS``. For example:\n\n```sh\nZSH_TAB_TITLE_ADDITIONAL_TERMS='alacritty|kitty|foot'\n```\n\nThis variable has no default value, so if nothing is informed, no suffix is added\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrystan2k%2Fzsh-tab-title","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrystan2k%2Fzsh-tab-title","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrystan2k%2Fzsh-tab-title/lists"}