iframe-proxy

jerek · 2025-12-31T23:33:11Z

This is actually two fixes, which address issue #409. This PR is also an alternative to pr #568.

Always use the status bg color as an actual background color (as opposed to a foreground color), so that terminals can make its color transparent and it works in rounded and slanted styles.
Set the default bg color when @catppuccin_status_background is set to 'none', so that it works in rounded and slanted styles.

Details

The configuration documentation says to set @catppuccin_status_background to none to make the status bar transparent, but this doesn't work in the rounded or slanted window status styles. Attempting to work around the problem by setting it to the background color that the terminal is making transparent also doesn't work for the rounded or slanted styles.

These two similar issues have different causes:

While terminals can have a particular color chosen as the one to make transparent, it only works on background colors, and the existing configuration was using the status background color as a foreground color.
- This PR's fix: Change the usage of @catppuccin_status_background's value to only apply it as a background color, which allows users to set it to a background color that their terminal will make transparent.
Setting @catppuccin_status_background to none doesn't work due to how it internally sets @_ctp_status_bg to 'none', which isn't valid for tmux. In the tmux man page the value 'none' is referenced for clearing all formatting, but not as a valid value for a particular property like bg or fg. Instead, the man page has an example of 'default' being used for that.
- This PR's fix: When the user sets @catppuccin_status_background to 'none', set the value of @_ctp_status_bg to 'default' instead of 'none', which tmux handles correctly.

I tested the changes in Wezterm primarily, but also checked that it works in Kitty and Ghostty.

Comparison Screenshots

Before — background set to 'none'

Before — background set to terminal's transparent background color

After — either transparency method

After — non-transparent colors still work as expected, as shown here

…ke its color transparent The [configuration documentation](https://github.com/catppuccin/tmux/blob/8b0b9150f9d7dee2a4b70cdb50876ba7fd6d674a/docs/reference/configuration.md#status-line) says to set `@catppuccin_status_background` to `none` to make the status bar transparent, but this doesn't work in the rounded or slanted window status styles. Terminals can have a particular color chosen as the one to make transparent, but this only works on background colors, and the existing configuration was using the status background color as a foreground color. This changes the usage of `@catppuccin_status_background`'s value to only apply it as a background color, which allows users to set it to a background color that their terminal will make transparent.

… set to 'none' The [configuration documentation](https://github.com/catppuccin/tmux/blob/8b0b9150f9d7dee2a4b70cdb50876ba7fd6d674a/docs/reference/configuration.md#status-line) says to set `@catppuccin_status_background` to `none` to make the status bar transparent, but this doesn't work in the rounded or slanted window status styles, because of how it internally sets `@_ctp_status_bg` to 'none'. In the tmux man page the value 'none' is referenced for clearing all formatting, but not as a valid value for a particular property like `bg` or `fg`. Instead, the man page has an example of 'default' being used for that. This changes the value of `@_ctp_status_bg` to be set to 'default' instead of 'none', when the user sets `@catppuccin_status_background` to 'none', so that the setting works in the rounded and slanted window status styles.

Pawel-Parma · 2026-03-17T17:58:51Z

…ncy, when the number position option is changed

jerek · 2026-03-27T05:09:56Z

@Pawel-Parma Fixed!

Pawel-Parma · 2026-03-27T08:15:05Z

Thanks, hope it will be merged soon

Rutger505 · 2026-03-31T12:26:17Z

Hi! I am also running into this issue and i tried using this branch, but I still seem to get those same edges when using Ghostty. See the screenshot:

Here is my config (or check the full config file here):

set -g @plugin 'jerek/catppuccin-tmux-fixed-transparency'

set -g @catppuccin_flavor "mocha"

set -g @catppuccin_window_status_style "rounded"

set -g status-position top
set -g status-left "#{E:@catppuccin_status_session} "
set -g status-right "#{E:@catppuccin_status_application}"

run '~/.local/share/tmux/plugins/tpm/tpm'

set -g status-bg default
set -g status-style bg=default

Pawel-Parma · 2026-03-31T14:23:05Z

@Rutger505 you need to manually specify the branch to the one with fixes:

set -g @plugin 'jerek/catppuccin-tmux-fixed-transparency#transparent-status-background-support'

I additionally had to remove manually the repo cloned by tpm and install it again

Rutger505 · 2026-04-01T12:13:00Z

@Pawel-Parma I see, I did not catch that. But even now when switching to the branch i still have the same edges. Here is my config:

set -g @plugin 'jerek/catppuccin-tmux-fixed-transparency#transparent-status-background-support'
set -g @catppuccin_status_connect_separator "no"

set -g @catppuccin_status_left_separator  ""
set -g @catppuccin_status_right_separator ""

set -g @catppuccin_window_status_style "rounded"
set -g @catppuccin_window_default_text " #W"
set -g @catppuccin_window_current_text " #W#{?window_zoomed_flag, 󰁌 ,}"
set -g @catppuccin_window_text " #W"

set -g status-position top
set -g status-left "#{E:@catppuccin_status_session} "
set -g status-right "#{E:@catppuccin_status_application}"

run '~/.local/share/tmux/plugins/tpm/tpm'

set -g status-bg default
set -g status-style bg=default

I have fully removed the catppuccin directories and reinstalled them but still the same outcome:

Pawel-Parma · 2026-04-01T12:45:30Z

@Rutger505 you need to set:

set -g @catppuccin_status_background "none"

And I think you can then remove this:

set -g status-bg default
set -g status-style bg=default

Rutger505 · 2026-04-01T13:34:10Z

Works like a charm now thank you!

jerek · 2026-04-10T00:45:10Z

Ah, yeah, the whole "none" vs "default" thing is a bit confusing. It seems like the usage of "none" here is a keyword specific to the Catppuccin theme for Tmux, which activates its transparency features.

Maybe "transparent" would be clearer? Though that's outside the scope of this fix anyway.

phucisstupid · 2026-04-18T04:18:46Z

@Pawel-Parma Fixed!

how you config tmux to show both directory name and running program?

jerek · 2026-04-19T14:55:24Z

how you config tmux to show both directory name and running program?

It's a combination of things. I don't change the settings of tmux itself for this, but rather the settings of zsh (which I use instead of bash) and Neovim. I also customize the tmux pane title in various scripts of mine.

Here are some of my settings:

In my zshrc

autoload -Uz add-zsh-hook

_precmd_title() {
    print -Pn "\e]0;%~\a"
}

add-zsh-hook precmd _precmd_title

And if you want to add something before the file path, such as a Nerd Font folder icon, change the function in the middle like this:

_precmd_title() {
    print -Pn "\e]0; %~\a"
}

In my Neovim Lua config

The two local vars at the top are an easy way to customize this a little.
I commented out the path substitutions section, since that calls one of my custom scripts. But I left it in a comment, in case you want to do something like that.

--  TITLE 
function _G.getTitleString()
    local prefix = ' '
    local maxChars = 50

    -- Get the name of the current buffer.
    local name = vim.api.nvim_buf_get_name(0)

    -- If there's no open buffer, just show the Neovim name.
    if name == '' then
        return prefix .. 'Neovim'
    end

    -- Use my path substitutions script to customize the name.
    -- local handle = io.popen(vim.fn.expand '~/.config/j-scripts/shell/path-substitutions.sh' .. ' "' .. prefix .. name .. '"')
    -- if handle then
    --     name = handle:read '*a'
    --     handle:close()
    -- end

    -- If the text is longer than maxChars, trim the left side.
    local substr = string.sub(name, -1 * maxChars)
    if string.len(substr) == maxChars then
        if string.sub(name, 0, 1) == '/' then
            substr = string.sub(name, -1 * (maxChars - 1))
        end

        local firstSlash = string.find(substr, '/')
        if firstSlash then
            substr = '…' .. string.sub(substr, firstSlash)
        end
    end

    return substr
end
vim.opt.title = true
vim.opt.titlelen = 0 -- Disable's Neovim's path limit, since it's handled above.
vim.opt.titlestring = '%{luaeval("getTitleString()")}'

In my zsh/bash aliases

This falls back on setting the title in WezTerm, but it won't error if you're using a different terminal emulator.
I use this so that in my scripts I can include commands like:
setSmartTitle ' Starting container...'

# Sets the title of the tmux pane (tab), or the terminal when not in tmux.
setSmartTitle() {
    title=$*

    if [[ -z "$TMUX" || $TERM_PROGRAM == 'tmux' ]]; then
        tmux select-pane -T "$title"
    elif [[ $TERM_PROGRAM == 'WezTerm' ]]; then
        wezterm cli set-tab-title "$title"
    fi
}

jerek added 2 commits December 31, 2025 16:22

This was referenced Dec 31, 2025

fix: make rounded preset work with transparency #568

Open

Transparency for separators #409

Open

jerek force-pushed the transparent-status-background-support branch from d0e1569 to 4508c1d Compare January 1, 2026 17:55

fix: correctly set the left and right separators, including transpare…

c7437de

…ncy, when the number position option is changed

jerek mentioned this pull request Mar 30, 2026

Background transparency not working properly for Window Title Widgets #575

Open

2 tasks done

Sunbelt Computer Software

PL/B Language Development and Support

Navigation Menu

Repository navigation

Fix: Transparent status background support with rounded and slanted styles - #577

Fix: Transparent status background support with rounded and slanted styles#577
jerek wants to merge 3 commits into
catppuccin:mainfrom
jerek:transparent-status-background-support

jerek commented Dec 31, 2025 •

edited

Loading

Uh oh!

Pawel-Parma commented Mar 17, 2026

Uh oh!

jerek commented Mar 27, 2026

Uh oh!

Pawel-Parma commented Mar 27, 2026

Uh oh!

Rutger505 commented Mar 31, 2026 •

edited

Loading

Uh oh!

Pawel-Parma commented Mar 31, 2026

Uh oh!

Rutger505 commented Apr 1, 2026

Uh oh!

Pawel-Parma commented Apr 1, 2026 •

edited

Loading

Uh oh!

Rutger505 commented Apr 1, 2026

Uh oh!

jerek commented Apr 10, 2026

Uh oh!

phucisstupid commented Apr 18, 2026 •

edited

Loading

Uh oh!

jerek commented Apr 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Sunbelt Computer Software

PL/B Language Development and Support

Conversation

jerek commented Dec 31, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Details

Comparison Screenshots

Uh oh!

Pawel-Parma commented Mar 17, 2026

Uh oh!

jerek commented Mar 27, 2026

Uh oh!

Pawel-Parma commented Mar 27, 2026

Uh oh!

Rutger505 commented Mar 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Pawel-Parma commented Mar 31, 2026

Uh oh!

Rutger505 commented Apr 1, 2026

Uh oh!

Pawel-Parma commented Apr 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Rutger505 commented Apr 1, 2026

Uh oh!

jerek commented Apr 10, 2026

Uh oh!

phucisstupid commented Apr 18, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jerek commented Apr 19, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

jerek commented Dec 31, 2025 •

edited

Loading

Rutger505 commented Mar 31, 2026 •

edited

Loading

Pawel-Parma commented Apr 1, 2026 •

edited

Loading

phucisstupid commented Apr 18, 2026 •

edited

Loading