Preview SVG: resvg background color

[kmcnayr]

What system are you running Yazi on?

Linux Wayland

What terminal are you running Yazi in?

foot

yazi --debug output

Yazi
    Version: 25.5.31 (Arch Linux 2025-07-23)
    Debug  : false
    Triple : x86_64-unknown-linux-gnu (linux-x86_64)
    Rustc  : 1.88.0 (6b00bc38 2025-06-23)

Ya
    Version: 25.5.31 (Arch Linux 2025-07-23)

Emulator
    TERM                : Some("xterm-256color")
    TERM_PROGRAM        : None
    TERM_PROGRAM_VERSION: None
    Brand.from_env      : None
    Emulator.detect     : Emulator { kind: Left(Foot), light: false, csi_16t: (9, 20), force_16t: false }

Adapter
    Adapter.matches    : Sixel
    Dimension.available: Dimension { rows: 48, columns: 99, width: 891, height: 960 }

Desktop
    XDG_SESSION_TYPE           : Some("wayland")
    WAYLAND_DISPLAY            : Some("wayland-1")
    DISPLAY                    : Some(":0")
    SWAYSOCK                   : None
    HYPRLAND_INSTANCE_SIGNATURE: Some("71a1216abcc7031776630a6d88f105605c4dc1c9_1765286695_862206102")
    WAYFIRE_SOCKET             : None

SSH
    shared.in_ssh_connection: false

WSL
    WSL: false

Variables
    SHELL           : Some("/bin/fish")
    EDITOR          : None
    VISUAL          : None
    YAZI_FILE_ONE   : None
    YAZI_CONFIG_HOME: None
    YAZI_ZOXIDE_OPTS: None
    FZF_DEFAULT_OPTS: None

Text Opener
    default     : Some(OpenerRule { run: "${EDITOR:-vi} \"$@\"", block: true, orphan: false, desc: "$EDITOR", for: None, spread: true })
    block-create: Some(OpenerRule { run: "${EDITOR:-vi} \"$@\"", block: true, orphan: false, desc: "$EDITOR", for: None, spread: true })
    block-rename: Some(OpenerRule { run: "${EDITOR:-vi} \"$@\"", block: true, orphan: false, desc: "$EDITOR", for: None, spread: true })

Multiplexers
    TMUX               : false
    tmux version       : tmux 3.5a
    tmux build flags   : enable-sixel=Unknown
    ZELLIJ_SESSION_NAME: None
    Zellij version     : No such file or directory (os error 2)

Dependencies
    file          : 5.46
    ueberzugpp    : No such file or directory (os error 2)
    ffmpeg/ffprobe: 8.0.1 / 8.0.1
    pdftoppm      : 25.10.0
    magick        : 7.1.2-10
    fzf           : 0.66.1
    fd/fdfind     : 10.3.0 / No such file or directory (os error 2)
    rg            : 15.1.0
    chafa         : No such file or directory (os error 2)
    zoxide        : No such file or directory (os error 2)
    7zz/7z        : No such file or directory (os error 2) / 25.01
    resvg         : 0.45.1
    jq            : 1.8.1

Clipboard
    wl-copy/paste: 2.2.1 / 2.2.1
    xclip        : No such file or directory (os error 2)
    xsel         : No such file or directory (os error 2)

Routine
    `file -bL --mime-type`: text/plain

Describe the question

The svg plugin allows for a bg argument to be passed which adds "--background" to the call to resvg. How do you pass this argument? Do I put it in my yazi.toml along with the mime type, run?

I don't see any examples of this in the preset toml config file.

I would like to set the svg preview background to white.

here is the relevant piece from the preset svg plugin:

local cmd = Command("resvg"):arg {
		"-w", rt.preview.max_width, "-h", rt.preview.max_height,
		"--image-rendering", "optimizeSpeed",
}
if job.args.bg then
	cmd = cmd:arg { "--background", job.args.bg }
end

Anything else?

No response

Checklist

• I have read all the documentation
• I have searched the existing discussions/issues

[sxyazi]

Add this to your yazi.toml:

[plugin]
prepend_preloaders = [
  { mime = "image/svg+xml", run = "svg --bg=white" }
]
prepend_previewers = [
  { mime = "image/svg+xml", run = "svg --bg=white" }
]

and do a yazi --clear-cache before restarting Yazi should work

Edit: note that the --bg option is newly introduced in #3189 and a nightly build is required at the moment

[kmcnayr]

aha, thank you! I did not realize this was not in the current release. I didn't event think to look in PR's, was looking in issues and discussions. Sorry for the trouble.