{"id":13680779,"url":"https://github.com/catppuccin/tmux","last_synced_at":"2026-04-08T13:01:05.394Z","repository":{"id":39443027,"uuid":"427086759","full_name":"catppuccin/tmux","owner":"catppuccin","description":"💽 Soothing pastel theme for Tmux","archived":false,"fork":false,"pushed_at":"2026-04-07T16:49:26.000Z","size":2357,"stargazers_count":2936,"open_issues_count":34,"forks_count":822,"subscribers_count":10,"default_branch":"main","last_synced_at":"2026-04-07T18:27:20.498Z","etag":null,"topics":["catppuccin","colors","colorscheme","hacktoberfest","tmux","tmux-conf","tmux-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/catppuccin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"catppuccin","open_collective":"catppuccin"}},"created_at":"2021-11-11T17:28:19.000Z","updated_at":"2026-04-07T15:10:12.000Z","dependencies_parsed_at":"2023-02-04T09:31:34.086Z","dependency_job_id":"939c5e7b-6cf8-488f-a751-0502276cfbc2","html_url":"https://github.com/catppuccin/tmux","commit_stats":{"total_commits":261,"total_committers":69,"mean_commits":3.782608695652174,"dds":0.8237547892720307,"last_synced_commit":"ba9bd88c98c81f25060f051ed983e40f82fdd3ba"},"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"purl":"pkg:github/catppuccin/tmux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catppuccin%2Ftmux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catppuccin%2Ftmux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catppuccin%2Ftmux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catppuccin%2Ftmux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/catppuccin","download_url":"https://codeload.github.com/catppuccin/tmux/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/catppuccin%2Ftmux/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31556239,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T10:21:54.569Z","status":"ssl_error","status_checked_at":"2026-04-08T10:21:38.171Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["catppuccin","colors","colorscheme","hacktoberfest","tmux","tmux-conf","tmux-theme"],"created_at":"2024-08-02T13:01:21.836Z","updated_at":"2026-04-08T13:01:05.381Z","avatar_url":"https://github.com/catppuccin.png","language":"Shell","funding_links":["https://github.com/sponsors/catppuccin","https://opencollective.com/catppuccin"],"categories":["Shell","Themes"],"sub_categories":[],"readme":"\u003c!-- markdownlint-disable --\u003e\n\u003ch3 align=\"center\"\u003e\n \u003cimg src=\"https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/logos/exports/1544x1544_circle.png\" width=\"100\" alt=\"Logo\"/\u003e\u003cbr/\u003e\n \u003cimg src=\"https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/misc/transparent.png\" height=\"30\" width=\"0px\"/\u003e\n Catppuccin for \u003ca href=\"https://github.com/tmux/tmux\"\u003eTmux\u003c/a\u003e\n \u003cimg src=\"https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/misc/transparent.png\" height=\"30\" width=\"0px\"/\u003e\n\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n    \u003ca href=\"https://github.com/catppuccin/tmux/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/catppuccin/tmux?colorA=363a4f\u0026colorB=b7bdf8\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/catppuccin/tmux/issues\"\u003e\u003cimg src=\"https://img.shields.io/github/issues/catppuccin/tmux?colorA=363a4f\u0026colorB=f5a97f\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/catppuccin/tmux/contributors\"\u003e\u003cimg src=\"https://img.shields.io/github/contributors/catppuccin/tmux?colorA=363a4f\u0026colorB=a6da95\u0026style=for-the-badge\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"./assets/preview.webp\"/\u003e\n\u003c/p\u003e\n\u003c!-- markdownlint-enable --\u003e\n\n## Themes\n\n\u003cdetails\u003e\n\u003csummary\u003e🌻 Latte\u003c/summary\u003e\n\n![Latte Flavor Preview](./assets/latte.webp)\n\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e🪴 Frappé\u003c/summary\u003e\n\n![Frappe Flavor Preview](./assets/frappe.webp)\n\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e🌺 Macchiato\u003c/summary\u003e\n\n![Macchiato Flavor Preview](./assets/macchiato.webp)\n\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003e🌿 Mocha\u003c/summary\u003e\n\n![Mocha Flavor Preview](./assets/mocha.webp)\n\n\u003c/details\u003e\n\n## Installation\n\nIn order to have the icons displayed correctly please use/update your favorite\n[nerd font](https://www.nerdfonts.com/font-downloads).\nIf you do not have a patched font installed, you can override or remove any\nicon. Check the [documentation](./docs/reference/configuration.md) on the\noptions available.\n\n### Manual (Recommended)\n\nThis method is recommended as TPM has some issues with name conflicts.\n\n\u003c!-- x-release-please-start-version --\u003e\n\n1. Clone this repository to your desired location (e.g.\n   `~/.config/tmux/plugins/catppuccin`).\n\n   ```bash\n   mkdir -p ~/.config/tmux/plugins/catppuccin\n   git clone -b v2.2.1 https://github.com/catppuccin/tmux.git ~/.config/tmux/plugins/catppuccin/tmux\n   ```\n\n1. Add the following line to your `tmux.conf` file:\n   `run ~/.config/tmux/plugins/catppuccin/tmux/catppuccin.tmux`.\n1. Reload Tmux by either restarting or reloading with `tmux source ~/.tmux.conf`.\n\u003c!-- x-release-please-end --\u003e\n\nCheck out what to do next in the \"[Getting Started Guide](./docs/tutorials/01-getting-started.md)\".\n\n### TPM\n\n\u003c!-- x-release-please-start-version --\u003e\n\n1.  Install [TPM](https://github.com/tmux-plugins/tpm)\n1.  Add the Catppuccin plugin:\n\n    ```bash\n    set -g @plugin 'catppuccin/tmux#v2.2.1' # See https://github.com/catppuccin/tmux/tags for additional tags\n    # ...alongside\n    set -g @plugin 'tmux-plugins/tpm'\n    ```\n\n1.  (Optional) Set your preferred flavor, it defaults to `\"mocha\"`:\n\n    ```bash\n    set -g @catppuccin_flavor 'mocha' # latte, frappe, macchiato or mocha\n    ```\n\n    \u003c!-- x-release-please-end --\u003e\n\n\u003e [!IMPORTANT]\n\u003e You may have to run `~/.config/tmux/plugins/tpm/bin/clean_plugins`\n\u003e if upgrading from an earlier version\n\u003e (especially from `v0.3.0`).\n\n### For TMUX versions prior to 3.2\n\nThis plugin uses features that were only introduced into tmux in version 3.2.\nIf you are using a version earlier than this, you can still have lovely\ncatppuccin colors, the installation method just looks a little different.\n\n```sh\n# In your ~/.tmux.conf\n\n# Add the colors from the pallete. Check the themes/ directory for all options.\n\n# Some basic mocha colors.\nset -g @ctp_bg \"#24273a\"\nset -g @ctp_surface_1 \"#494d64\"\nset -g @ctp_fg \"#cad3f5\"\nset -g @ctp_mauve \"#c6a0f6\"\nset -g @ctp_crust \"#181926\"\n\n# status line\nset -gF status-style \"bg=#{@ctp_bg},fg=#{@ctp_fg}\"\n\n# windows\nset -gF window-status-format \"#[bg=#{@ctp_surface_1},fg=#{@ctp_fg}] ##I ##T \"\nset -gF window-status-current-format \"#[bg=#{@ctp_mauve},fg=#{@ctp_crust}] ##I ##T \"\n```\n\n### For TMUX versions prior to 3.6\n\nThis plugin can be used in conjunction with the support for tmux to\nautomatically report dark or light themes using hooks. You can leverage these\nhooks in your tmux configuration file like so:\n\n```conf\nset-hook -g client-dark-theme {\n  set -g @catppuccin_flavor \"frappe\"\n  set -g @catppuccin_reset \"true\"\n\n  # NOTE: you may need to set more `@catppuccin_*` variables to fully reset\n  # everything.\n\n  run ~/code/github.com/catppuccin/tmux/catppuccin.tmux\n}\nset-hook -g client-light-theme {\n  set -g @catppuccin_flavor \"latte\"\n  set -g @catppuccin_reset \"true\"\n\n  # NOTE: you may need to set more `@catppuccin_*` variables to fully reset\n  # everything.\n\n  run ~/code/github.com/catppuccin/tmux/catppuccin.tmux\n}\n```\n\nThe above is only possible with versions of tmux 3.6+. To replicate this\nfunctionality with versions prior to 3.6, you can will need to set variables and\nrun the `cappuccin.tmux` file and trigger it yourself. If you'd like some\ninspiration for how to do this, read through [the Bash code found in this Nix\nfunction here][reload-example] which reloads Catppuccin on-demand without\nrelying on tmux hooks.\n\n[reload-example]: https://git.sr.ht/~rogeruiz/.files.nix/tree/1dedf4da47f995ec41e07d37b65008ad0f464717/item/module/tools/terminal/tmux/catppuccin/bin/default.nix \"An example from a catppuccin/tmux maintainer on how to manually reload the Catppuccin configuration on macOS.\"\n\n\u003e [!IMPORTANT]\n\u003e As mentioned in the comments in the `conf` snippet above, you may find that\n\u003e you'll need to add to the list of `@catppuccin_*` variables. Test your\n\u003e configuration by switching themes and noting what of the Tmux session isn't\n\u003e getting reset to an expected color.\n\n### Upgrading from v0.3\n\nBreaking changes have been introduced since 0.3, to understand how to migrate\nyour configuration, see pinned issue [#487](https://github.com/catppuccin/tmux/issues/487).\n\n## Recommended Default Configuration\n\nThis configuration shows some customisation options, that can be further\nextended as desired.\nThis is what is used for the previews above.\n\n![Example configuration](./assets/mocha.webp)\n\n```bash\n# ~/.tmux.conf\n\n# Options to make tmux more pleasant\nset -g mouse on\nset -g default-terminal \"tmux-256color\"\n\n# Configure the catppuccin plugin\nset -g @catppuccin_flavor \"mocha\"\nset -g @catppuccin_window_status_style \"rounded\"\n\n# Load catppuccin\nrun ~/.config/tmux/plugins/catppuccin/tmux/catppuccin.tmux\n# For TPM, instead use `run ~/.tmux/plugins/tmux/catppuccin.tmux`\n\n# Make the status line pretty and add some modules\nset -g status-right-length 100\nset -g status-left-length 100\nset -g status-left \"\"\nset -g status-right \"#{E:@catppuccin_status_application}\"\nset -agF status-right \"#{E:@catppuccin_status_cpu}\"\nset -ag status-right \"#{E:@catppuccin_status_session}\"\nset -ag status-right \"#{E:@catppuccin_status_uptime}\"\nset -agF status-right \"#{E:@catppuccin_status_battery}\"\n\nrun ~/.config/tmux/plugins/tmux-plugins/tmux-cpu/cpu.tmux\nrun ~/.config/tmux/plugins/tmux-plugins/tmux-battery/battery.tmux\n# Or, if using TPM, just run TPM\n```\n\n## Documentation\n\n### Guides\n\n- [Getting Started](./docs/tutorials/01-getting-started.md)\n- [Custom Status Line Segments](./docs/tutorials/02-custom-status.md)\n- [Troubleshooting](./docs/guides/troubleshooting.md)\n\n### Reference\n\n- [Status Line](./docs/reference/status-line.md)\n- [Configuration Options Reference](./docs/reference/configuration.md)\n- [Tmux Configuration Showcase](https://github.com/catppuccin/tmux/discussions/317)\n\n## 💝 Thanks to\n\n- [Pocco81](https://github.com/Pocco81)\n- [vinnyA3](https://github.com/vinnyA3)\n- [rogeruiz](https://github.com/rogeruiz)\n- [kales](https://github.com/kjnsn)\n\n\u0026nbsp;\n\n\u003c!-- markdownlint-disable --\u003e\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/footers/gray0_ctp_on_line.svg?sanitize=true\" /\u003e\u003c/p\u003e\n\u003cp align=\"center\"\u003eCopyright \u0026copy; 2021-present \u003ca href=\"https://github.com/catppuccin\" target=\"_blank\"\u003eCatppuccin Org\u003c/a\u003e\n\u003cp align=\"center\"\u003e\u003ca href=\"https://github.com/catppuccin/catppuccin/blob/main/LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/static/v1.svg?style=for-the-badge\u0026label=License\u0026message=MIT\u0026logoColor=d9e0ee\u0026colorA=363a4f\u0026colorB=b7bdf8\"/\u003e\u003c/a\u003e\u003c/p\u003e\n\u003c!-- markdownlint-enable --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcatppuccin%2Ftmux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcatppuccin%2Ftmux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcatppuccin%2Ftmux/lists"}