In macos kitty the plugin background not work<

[1096015776]

I am not requesting help with my configuration and believe something is genuinely broken.

• Something is really actually broken.

Is there an existing issue outlining your problem?

• I have searched the existing issues and troubleshooting guide, and they do not solve my problem.

Describe your problem.

tmux 3.5a font_family MonolisaStatic Nerd Font Regular term xterm-256color

Paste your configuration.

my tmux config is

# Set the default terminal mode to 256color mode
set-option -g default-terminal "xterm-256color"
set-option -g terminal-overrides ",xterm-256color:RGB"

# Change prefix
set -g prefix C-a
unbind C-b
bind C-a send-prefix

set -s escape-time 0

bind-key x kill-pane
bind-key & kill-window

# Reload config
bind r source-file ~/.tmux.conf \; \
display-message "Config Reloaded."

set -g default-terminal "${TERM}"

# Window and pane index form 1
set -g base-index 1
set -g pane-base-index 1
set -g detach-on-destroy off
set -g renumber-windows on

set -g pane-active-border-style 'fg=magenta,bg=default'
set -g pane-border-style 'fg=brightblack,bg=default'

set -g mouse on

# Enable vi keys.
setw -g mode-keys vi

# set status top
set -g status-position top

# Increase scrollback buffer size
set -g history-limit 1000000


# Window title
set -g automatic-rename on
set -g set-titles on
set -g set-titles-string "#S #I:#P #W:#T"

bind \\ split-pane -h -c "#{pane_current_path}"
bind - split-pane -v -c "#{pane_current_path}"
unbind '"'
unbind %

# Resizing panes with Prefix H,J,K,L
bind -r H resize-pane -L 5
bind -r L resize-pane -R 5
bind -r K resize-pane -U 5
bind -r J resize-pane -D 5

# Move between windows with Shift + Arrow keys
bind -n S-Left  previous-window
bind -n S-Right next-window

# neovim tmux navigator
# Smart pane switching with awareness of Vim splits.
# See: https://github.com/christoomey/vim-tmux-navigator
is_vim="ps -o state= -o comm= -t '#{pane_tty}' \
    | grep -iqE '^[^TXZ ]+ +(\\S+\\/)?g?(view|l?n?vim?x?|fzf)(diff)?$'"
bind-key -n 'C-h' if-shell "$is_vim" 'send-keys C-h'  'select-pane -L'
bind-key -n 'C-j' if-shell "$is_vim" 'send-keys C-j'  'select-pane -D'
bind-key -n 'C-k' if-shell "$is_vim" 'send-keys C-k'  'select-pane -U'
bind-key -n 'C-l' if-shell "$is_vim" 'send-keys C-l'  'select-pane -R'

bind-key -T copy-mode-vi 'C-h' select-pane -L
bind-key -T copy-mode-vi 'C-j' select-pane -D
bind-key -T copy-mode-vi 'C-k' select-pane -U
bind-key -T copy-mode-vi 'C-l' select-pane -R

set -g @fzf-url-fzf-options '-p 60%,30% --prompt="   " --border-label=" Open URL "'
set -g @fzf-url-history-limit '2000'

# List of plugins
set -g @plugin 'tmux-plugins/tpm'
set -g @plugin 'tmux-plugins/tmux-sensible'
set -g @plugin 'fcsonline/tmux-thumbs'
set -g @plugin 'sainnhe/tmux-fzf'
set -g @plugin 'wfxr/tmux-fzf-url'
set -g @plugin 'tmux-plugins/tmux-yank'
set -g @plugin 'catppuccin/tmux'
set -g @plugin 'tmux-plugins/tmux-battery'
set -g @plugin 'tmux-plugins/tmux-cpu'
set -g @plugin 'omerxx/tmux-sessionx'
set -g @plugin 'omerxx/tmux-floax'
set -g @plugin 'tmux-plugins/tmux-resurrect'
set -g @plugin 'tmux-plugins/tmux-continuum'

# I recommend using `o` if not already in use, for least key strokes when launching
set -g @sessionx-bind 'o'
set -g @sessionx-window-height '85%'
set -g @sessionx-window-width '75%'

set -g @floax-width '80%'
set -g @floax-height '80%'
set -g @floax-border-color 'magenta'
set -g @floax-text-color 'blue'
set -g @floax-bind 'p'
set -g @floax-change-path 'false'

set -g @continuum-restore 'on'
set -g @resurrect-strategy-nvim 'session'

set -g @catppuccin_flavour 'mocha'
set -g @catppuccin_status_default "on"
set -g @catppuccin_status_background "default"
set -g @catppuccin_status_justify "centre"


set -g @catppuccin_window_left_separator ""
set -g @catppuccin_window_right_separator " "
set -g @catppuccin_window_middle_separator " | "

set -g @catppuccin_window_number_position "right"

set -g @catppuccin_window_current_fill "all"
set -g @catppuccin_window_current_text "#{b:pane_current_path}"

set -g @catppuccin_status_modules_left "application session"
set -g @catppuccin_status_modules_right "date_time cpu battery"
set -g @catppuccin_status_left_separator  " "
set -g @catppuccin_status_right_separator ""
set -g @catppuccin_status_fill "icon"
set -g @catppuccin_status_connect_separator "no"

set -g @catppuccin_date_time_text "%Y-%m-%d %H:%M"


# Install `tpm` if needed.
if "test ! -d ~/.tmux/plugins/tpm" \
   "run 'git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm && ~/.tmux/plugins/tpm/bin/install_plugins'"

# Run tpm
run -b '~/.tmux/plugins/tpm/tpm'

Attach screenshots.

No response

What tmux version are you seeing the issue on?

tmux 3.5a

What shell are you using?

zsh

Any additional comments?

I don't know what happen let it not work,please help me

[kjnsn]

The status line is appearing exactly as you have configured it. Where did you get the configuration from? It is not from the documentation in this repository

I've noticed that you have opened several issues across different open source projects that were either marked as invalid, or did not contain enough information to debug. Open source projects are run by volunteers, often those volunteers are close to burnout.

[fn-9li9]

Why This Happens

The issue is that you're using legacy configuration syntax from catppuccin/tmux v0.3.x, but the plugin has been completely rewritten in v2.x with a new configuration format.

The options you're using like @catppuccin_window_left_separator, @catppuccin_status_modules_left, etc., no longer exist in the current version. This is why the maintainer mentioned your config doesn't match the current documentation.

Additionally, there's a conflict in your terminal settings:

set-option -g default-terminal "xterm-256color"
# ...later...
set -g default-terminal "${TERM}"  # This overrides the previous setting

---

How To Fix It

Step 1: Update your terminal settings

Replace your terminal configuration with:

# Proper terminal and color support for Kitty
set -g default-terminal "tmux-256color"
set -ag terminal-overrides ",xterm-kitty:RGB"

Step 2: Update to the new catppuccin v2.x syntax

The new plugin uses a completely different configuration. Replace all your @catppuccin_* options with:

# Load catppuccin BEFORE setting options
set -g @plugin 'catppuccin/tmux#v2.1.2'

# Catppuccin options (new v2.x syntax)
set -g @catppuccin_flavor 'mocha'
set -g @catppuccin_status_background 'default'

# Window styling
set -g @catppuccin_window_status_style 'rounded'
set -g @catppuccin_window_number_position 'right'
set -g @catppuccin_window_text ' #{b:pane_current_path}'
set -g @catppuccin_window_current_text ' #{b:pane_current_path}'

# Status bar
set -g @catppuccin_status_left_separator '█'
set -g @catppuccin_status_right_separator '█'

# Load status modules
set -g status-left '#{E:@catppuccin_status_session}'
set -g status-right '#{E:@catppuccin_status_date_time}'

Step 3: Ensure correct loading order

Critical: All @catppuccin_* options must be set AFTER declaring the plugin but the plugin runs at the end with TPM. Move catppuccin plugin declaration to the top of your plugins list:

# List of plugins (catppuccin should be early)
set -g @plugin 'tmux-plugins/tpm'
set -g @plugin 'catppuccin/tmux#v2.1.2'  # Pin to specific version
set -g @plugin 'tmux-plugins/tmux-sensible'
# ... other plugins

Step 4: Reload tmux completely

# Kill all tmux sessions and restart fresh
tmux kill-server
tmux

---

Additional Recommendations

1. Pin your plugin version

Always pin to a specific version to avoid breaking changes:

set -g @plugin 'catppuccin/tmux#v2.1.2'

2. Kitty-specific configuration

Add this to your kitty.conf for better tmux compatibility:

# In ~/.config/kitty/kitty.conf
allow_remote_control yes
listen_on unix:/tmp/kitty
shell_integration enabled

3. Check the official documentation

The plugin was completely rewritten. Please refer to the updated docs:

• Configuration Guide
• Status Modules
• Troubleshooting

4. Verify your setup

After applying changes, run:

tmux show-options -g | grep catppuccin

This should display your catppuccin options correctly.

---

Let me know if this resolves your issue!