[GH-ISSUE #740] Warp Terminal: Kitty Graphics Protocol for Album Art Not Auto-Detecting #1377

New issue

Closed

opened 2026-03-14 14:34:41 +03:00 by kerem · 3 comments

kerem commented

2026-03-14 14:34:41 +03:00

Owner

Originally created by @ryancohan on GitHub (Jun 2, 2025).
Original GitHub issue: https://github.com/aome510/spotify-player/issues/740

Describe the bug
When using Warp Terminal, spotify-player isn't detecting terminal graphics capabilities and falling back to block art.

To Reproduce

Install and run Warp Terminal.
echo $TERM # note output is xterm-256color
Install spotify-player with --features image
Setup ~/.config/spotify-player/app.toml with:

[image]
enable_cover_image_cache = true
cover_img_width = 40
cover_img_length= 20

[image.term_backgrounds]
"WarpTerminal" = 1.0

Run spotify-player; note album art is distorted blocks
Quit spotify-player and rerun as TERM=xterm-kitty spotify_player; note album art is clean

Expected behaviour
Expect spotify-player to detect graphics mode and render album art non-distorted.

Log and backtrace

Please refer to this URL for more details.

Screenshots
If applicable, add screenshots to help explain your problem.

Environment

OS: MacOS 15.5 (24F74)
Application version: 0.20.5
Application features: cargo build --release --features image

Additional context

Originally created by @ryancohan on GitHub (Jun 2, 2025). Original GitHub issue: https://github.com/aome510/spotify-player/issues/740 **Describe the bug** When using Warp Terminal, spotify-player isn't detecting terminal graphics capabilities and falling back to block art. **To Reproduce** 1. Install and run Warp Terminal. 2. `echo $TERM # note output is xterm-256color` 3. Install spotify-player with `--features image` 4. Setup ~/.config/spotify-player/app.toml with: > [image] > enable_cover_image_cache = true > cover_img_width = 40 > cover_img_length= 20 > > [image.term_backgrounds] > "WarpTerminal" = 1.0 5. Run spotify-player; note album art is distorted blocks 6. Quit spotify-player and rerun as `TERM=xterm-kitty spotify_player`; note album art is clean **Expected behaviour** Expect spotify-player to detect graphics mode and render album art non-distorted. **Log and backtrace** Please refer to [this URL](https://github.com/aome510/spotify-player?tab=readme-ov-file#logging) for more details. **Screenshots** If applicable, add screenshots to help explain your problem. **Environment** - OS: MacOS 15.5 (24F74) - Application version: 0.20.5 - Application features: `cargo build --release --features image` **Additional context**

kerem

2026-03-14 14:34:41 +03:00

closed this issue
added the
bug
label

kerem commented

2026-03-14 14:34:58 +03:00

Author

Owner

@aome510 commented on GitHub (Jun 22, 2025):

That is expected and not really a bug from spotify_player side. You can find the logic to detect kitty support in the viuer library: github.com/atanunq/viuer@a9921f5d3d/src/printer/kitty.rs (L58-L69)

@aome510 commented on GitHub (Jun 22, 2025): That is expected and not really a bug from `spotify_player` side. You can find the logic to detect kitty support in the `viuer` library: https://github.com/atanunq/viuer/blob/a9921f5d3d1ef44b59cdd2a5f16d5f480eb1d731/src/printer/kitty.rs#L58-L69

kerem commented

2026-03-14 14:35:03 +03:00

Author

Owner

@j4james commented on GitHub (Jun 22, 2025):

FYI, someone is currently working on a PR for viuer which detects the kitty protocol more reliably, so it doesn't have to rely on a hardcoded lists of TERM values (see https://github.com/atanunq/viuer/pull/79). In theory that should get Warp Terminal to work correctly.

@j4james commented on GitHub (Jun 22, 2025): FYI, someone is currently working on a PR for viuer which detects the kitty protocol more reliably, so it doesn't have to rely on a hardcoded lists of `TERM` values (see https://github.com/atanunq/viuer/pull/79). In theory that should get Warp Terminal to work correctly.

kerem commented

2026-03-14 14:35:08 +03:00

Author

Owner

@aome510 commented on GitHub (Jun 22, 2025):

FYI, someone is currently working on a PR for viuer which detects the kitty protocol more reliably, so it doesn't have to rely on a hardcoded lists of TERM values (see atanunq/viuer#79). In theory that should get Warp Terminal to work correctly.

Gotcha, thanks for the heads up. I'll keep an eye out for any updates from the library

@aome510 commented on GitHub (Jun 22, 2025): > FYI, someone is currently working on a PR for viuer which detects the kitty protocol more reliably, so it doesn't have to rely on a hardcoded lists of `TERM` values (see [atanunq/viuer#79](https://github.com/atanunq/viuer/pull/79)). In theory that should get Warp Terminal to work correctly. Gotcha, thanks for the heads up. I'll keep an eye out for any updates from the library