base on 💽 Soothing pastel theme for Tmux <!-- markdownlint-disable --> <h3 align="center"> <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/logos/exports/1544x1544_circle.png" width="100" alt="Logo"/><br/> <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/misc/transparent.png" height="30" width="0px"/> Catppuccin for <a href="https://github.com/tmux/tmux">Tmux</a> <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/misc/transparent.png" height="30" width="0px"/> </h3> <p align="center"> <a href="https://github.com/catppuccin/tmux/stargazers"><img src="https://img.shields.io/github/stars/catppuccin/tmux?colorA=363a4f&colorB=b7bdf8&style=for-the-badge"></a> <a href="https://github.com/catppuccin/tmux/issues"><img src="https://img.shields.io/github/issues/catppuccin/tmux?colorA=363a4f&colorB=f5a97f&style=for-the-badge"></a> <a href="https://github.com/catppuccin/tmux/contributors"><img src="https://img.shields.io/github/contributors/catppuccin/tmux?colorA=363a4f&colorB=a6da95&style=for-the-badge"></a> </p> <p align="center"> <img src="./assets/preview.webp"/> </p> <!-- markdownlint-enable --> ## Themes <details> <summary>🌻 Latte</summary>  </details> <details> <summary>🪴 Frappé</summary>  </details> <details> <summary>🌺 Macchiato</summary>  </details> <details> <summary>🌿 Mocha</summary>  </details> ## Installation In order to have the icons displayed correctly please use/update your favorite [nerd font](https://www.nerdfonts.com/font-downloads). If you do not have a patched font installed, you can override or remove any icon. Check the [documentation](./docs/reference/configuration.md) on the options available. ### Manual (Recommended) This method is recommended as TPM has some issues with name conflicts. <!-- x-release-please-start-version --> 1. Clone this repository to your desired location (e.g. `~/.config/tmux/plugins/catppuccin`). ```bash mkdir -p ~/.config/tmux/plugins/catppuccin git clone -b v2.1.2 https://github.com/catppuccin/tmux.git ~/.config/tmux/plugins/catppuccin/tmux ``` 1. Add the following line to your `tmux.conf` file: `run ~/.config/tmux/plugins/catppuccin/tmux/catppuccin.tmux`. 1. Reload Tmux by either restarting or reloading with `tmux source ~/.tmux.conf`. <!-- x-release-please-end --> Check out what to do next in the "[Getting Started Guide](./docs/tutorials/01-getting-started.md)". ### TPM <!-- x-release-please-start-version --> 1. Install [TPM](https://github.com/tmux-plugins/tpm) 1. Add the Catppuccin plugin: ```bash set -g @plugin 'catppuccin/tmux#v2.1.2' # See https://github.com/catppuccin/tmux/tags for additional tags # ...alongside set -g @plugin 'tmux-plugins/tpm' ``` 1. (Optional) Set your preferred flavor, it defaults to `"mocha"`: ```bash set -g @catppuccin_flavor 'mocha' # latte, frappe, macchiato or mocha ``` <!-- x-release-please-end --> > [!IMPORTANT] > You may have to run `~/.config/tmux/plugins/tpm/bin/clean_plugins` > if upgrading from an earlier version > (especially from `v0.3.0`). ### For TMUX versions prior to 3.2 This plugin uses features that were only introduced into tmux in version 3.2. If you are using a version earlier than this, you can still have lovely catppuccin colors, the installation method just looks a little different. ```sh # In your ~/.tmux.conf # Add the colors from the pallete. Check the themes/ directory for all options. # Some basic mocha colors. set -g @ctp_bg "#24273a" set -g @ctp_surface_1 "#494d64" set -g @ctp_fg "#cad3f5" set -g @ctp_mauve "#c6a0f6" set -g @ctp_crust "#181926" # status line set -gF status-style "bg=#{@ctp_bg},fg=#{@ctp_fg}" # windows set -gF window-status-format "#[bg=#{@ctp_surface_1},fg=#{@ctp_fg}] ##I ##T " set -gF window-status-current-format "#[bg=#{@ctp_mauve},fg=#{@ctp_crust}] ##I ##T " ``` ### Upgrading from v0.3 Breaking changes have been introduced since 0.3, to understand how to migrate your configuration, see pinned issue [#291](https://github.com/catppuccin/tmux/issues/291). ## Recommended Default Configuration This configuration shows some customisation options, that can be further extended as desired. This is what is used for the previews above.  ```bash # ~/.tmux.conf # Options to make tmux more pleasant set -g mouse on set -g default-terminal "tmux-256color" # Configure the catppuccin plugin set -g @catppuccin_flavor "mocha" set -g @catppuccin_window_status_style "rounded" # Load catppuccin run ~/.config/tmux/plugins/catppuccin/tmux/catppuccin.tmux # For TPM, instead use `run ~/.config/tmux/plugins/tmux/catppuccin.tmux` # Make the status line pretty and add some modules set -g status-right-length 100 set -g status-left-length 100 set -g status-left "" set -g status-right "#{E:@catppuccin_status_application}" set -agF status-right "#{E:@catppuccin_status_cpu}" set -ag status-right "#{E:@catppuccin_status_session}" set -ag status-right "#{E:@catppuccin_status_uptime}" set -agF status-right "#{E:@catppuccin_status_battery}" run ~/.config/tmux/plugins/tmux-plugins/tmux-cpu/cpu.tmux run ~/.config/tmux/plugins/tmux-plugins/tmux-battery/battery.tmux # Or, if using TPM, just run TPM ``` ## Documentation ### Guides - [Getting Started](./docs/tutorials/01-getting-started.md) - [Custom Status Line Segments](./docs/tutorials/02-custom-status.md) ### Reference - [Status Line](./docs/reference/status-line.md) - [Configuration Options Reference](./docs/reference/configuration.md) - [Tmux Configuration Showcase](https://github.com/catppuccin/tmux/discussions/317) ## 💝 Thanks to - [Pocco81](https://github.com/Pocco81) - [vinnyA3](https://github.com/vinnyA3) - [rogeruiz](https://github.com/rogeruiz) - [kales](https://github.com/kjnsn) &nbsp; <!-- markdownlint-disable --> <p align="center"> <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/footers/gray0_ctp_on_line.svg?sanitize=true" /></p> <p align="center">Copyright &copy; 2021-present <a href="https://github.com/catppuccin" target="_blank">Catppuccin Org</a> <p align="center"><a href="https://github.com/catppuccin/catppuccin/blob/main/LICENSE"><img src="https://img.shields.io/static/v1.svg?style=for-the-badge&label=License&message=MIT&logoColor=d9e0ee&colorA=363a4f&colorB=b7bdf8"/></a></p> <!-- markdownlint-enable --> ", Assign "at most 3 tags" to the expected json: {"id":"8627","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"