Migration to ratatui_image instead of viuer

[sakashimaa]

Resolves #963

Screenshot:

Summary

• Replace viuer with ratatui-image for rendering cover images
• Remove manual set_skip / clear_area hacks — ratatui-image renders as a native ratatui widget
• Remove viuer initialization in main.rs, use Picker::from_query_stdio() for protocol auto-detection
• Remove cover_img_scale usage (no longer needed — scaling is handled by ratatui-image)

Notes

Picker::from_query_stdio() must run after enable_raw_mode() but before EnterAlternateScreen for correct protocol detection.

In nested terminals (e.g. neovim floating terminal), stdio queries don't reach the actual terminal emulator, so the protocol falls back to Halfblocks. This is a known limitation of ratatui-image's detection approach. Regular terminals (foot, kitty, iTerm2, etc.) work correctly

[aome510]

This doesn't seem to work on iTerm2 for me

[aome510]

can you also look into updating the documents (README.md, config.md) to ensure they are up-to-date?

[sakashimaa]

yeah i`ll watch iterm2 and docs

[sakashimaa]

ive just installed fresh iterm2 on my mac air m2 and run app with --features image and it seems to work just fine. Which version of iterm2 you have?

[aome510]

ive just installed fresh iterm2 on my mac air m2 and run app with --features image and it seems to work just fine. Which version of iterm2 you have?

hmm interesting, I got Build 3.6.9

[hanzpo]

I tested it on ghostty + tmux on macos with allow-passthrough on for tmux. It didn't work properly until i manually forced picker.set_protocol_type(ProtocolType::Kitty). Not sure if this is a configuration issue on my end but hope this helps!

[csanthiago]

I tested the PR, the image doesn't load, but spotify_player works as expected.

Sending some specs, in case it helps.

OS: NixOS 26.11 (Zokor) x86_64
Kernel: Linux 7.0.10
Shell: fish 4.7.1
WM: niri unstable 2026-06-05 (Wayland)
Terminal: zellij 0.44.3
Terminal Emulator: kitty 0.47.1