Skip to content

improve the image preview quality #3796

@caikn

Description

@caikn

yazi --debug output

Yazi
    Version: 26.1.22 (Homebrew 2026-01-22)
    Debug  : false
    Triple : aarch64-apple-darwin (macos-aarch64)
    Rustc  : 1.92.0 (ded5c06c 2025-12-08)

Ya
    Version: 26.1.22 (Homebrew 2026-01-22)

Config
    Init             : /Users/myuser/.config/yazi/init.lua (No such file or directory (os error 2))
    Yazi             : /Users/myuser/.config/yazi/yazi.toml (128 chars)
    Keymap           : /Users/myuser/.config/yazi/keymap.toml (No such file or directory (os error 2))
    Theme            : /Users/myuser/.config/yazi/theme.toml (No such file or directory (os error 2))
    VFS              : /Users/myuser/.config/yazi/vfs.toml (No such file or directory (os error 2))
    Package          : /Users/myuser/.config/yazi/package.toml (No such file or directory (os error 2))
    Dark/light flavor: "" / ""

Emulator
    TERM                : Some("xterm-256color")
    TERM_PROGRAM        : Some("iTerm.app")
    TERM_PROGRAM_VERSION: Some("3.6.6")
    Brand.from_env      : Some(Iterm2)
    Emulator.detect     : Emulator { kind: Left(Iterm2), version: "iTerm2 3.6.9", light: false, csi_16t: (0, 0), force_16t: false }

Adapter
    Adapter.matches    : Iip
    Dimension.available: Dimension { rows: 54, columns: 237, width: 3318, height: 1836 }

Desktop
    XDG_SESSION_TYPE           : None
    WAYLAND_DISPLAY            : None
    DISPLAY                    : None
    SWAYSOCK                   : None
    HYPRLAND_INSTANCE_SIGNATURE: None
    WAYFIRE_SOCKET             : None

SSH
    shared.in_ssh_connection: false

WSL
    WSL: false

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

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

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

Dependencies
    file          : 5.41
    ueberzugpp    : No such file or directory (os error 2)
    ffmpeg/ffprobe: 8.0.1 / 8.0.1
    pdftoppm      : 26.03.0
    magick        : 7.1.2-16
    fzf           : 0.70.0
    fd/fdfind     : 10.4.2 / No such file or directory (os error 2)
    rg            : 15.1.0
    chafa         : No such file or directory (os error 2)
    zoxide        : 0.9.9
    7zz/7z        : 26.00 / 17.05
    resvg         : 0.47.0
    jq            : 1.8.1

Clipboard
    wl-copy/paste: No such file or directory (os error 2) / No such file or directory (os error 2)
    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


See https://yazi-rs.github.io/docs/plugins/overview#debugging on how to enable logging or debug runtime errors.

Please describe the problem you're trying to solve

An improvement to yazi's image preview downscaling so that thumbnails displayed in the terminal preview pane are visibly sharper. The current pipeline uses the image crate's built-in resize() with configurable filter types, but the results appear noticeably less sharp than native image viewers like macOS Preview.
Core Value
Image previews in yazi should look as sharp as the terminal's pixel resolution allows — downscaling artifacts should not be the bottleneck.

Would you be willing to contribute this feature?

  • Yes, I'll give it a shot

Describe the solution you'd like

  • Improve the downscaling/resizing algorithm in yazi-adapter so preview thumbnails are visibly sharper
  • Maintain existing configurability (users can still select filter types)

Additional context

No response

Checklist

  • I have searched the existing issues/discussions
  • The latest nightly build doesn't already have this feature

Metadata

Metadata

Assignees

No one assigned

    Labels

    featureNew feature requestwaiting on opWaiting for more information from the original poster

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions