How to disable image preview in snacks.picker? #1431

Or1g3n · 2025-02-25T18:41:53Z

Or1g3n
Feb 25, 2025

My terminal does not support the kitty protocol and therefore results in a failure when using the file picker if it tries to preview an image file in the picker list. At work I use windows terminal on windows os.

I first tried to see if there was a way to turn off image preview in snacks.picker config but could not find a parameter for this. I then tried to explicitly disable snacks.image altogether by adding the following, but still getting an error in picker if it attemps to preview an image:

return {
    "folke/snacks.nvim",
    enabled = true,
    opts = {
	image = { enabled = false },
	picker = {
...

The error is always the same, something about title needing border to be set and then this window that pops up in the background concerning image error.

Any help would be greatly appreciated.

folke · 2025-02-25T19:26:19Z

folke
Feb 25, 2025
Maintainer

What's your full config? That error has nothing to do with images.
I'm not sure under what circumstances that can error, but I just pushed a change that probably fixes this.

0 replies

Or1g3n · 2025-02-25T20:26:32Z

Or1g3n
Feb 25, 2025
Author

Hey @folke, I just pulled in your latest commit and now getting a different kind of error:

Below is my full config as requested, it is mostly just your defaults (albeit from when I built this a few weeks ago, its possible something has changed):

return {
    "folke/snacks.nvim",
    enabled = true,
    opts = {
	image = { enabled = false },
	picker = {
	    prompt = " ",
	    sources = {},
	    layout = {
		cycle = true,
		--- Use the default layout or vertical if the window is too narrow
		preset = function()
		    return vim.o.columns >= 120 and "default" or "vertical"
		end,
	    },
	    ---@class snacks.picker.matcher.Config
	    matcher = {
		fuzzy = true, -- use fuzzy matching
		smartcase = true, -- use smartcase
		ignorecase = true, -- use ignorecase
		sort_empty = false, -- sort results when the search string is empty
		filename_bonus = true, -- give bonus for matching file names (last part of the path)
		file_pos = true, -- support patterns like `file:line:col` and `file:line`
	    },
	    sort = {
		-- default sort is by score, text length and index
		fields = { "score:desc", "#text", "idx" },
	    },
	    ui_select = true, -- replace `vim.ui.select` with the snacks picker
	    ---@class snacks.picker.formatters.Config
	    formatters = {
		file = {
		    filename_first = false, -- display filename before the file path
		},
		selected = {
		    show_always = false, -- only show the selected column when there are multiple selections
		    unselected = true, -- use the unselected icon for unselected items
		},
	    },
	    ---@class snacks.picker.previewers.Config
	    previewers = {
		git = {
		    native = false, -- use native (terminal) or Neovim for previewing git diffs and commits
		},
		file = {
		    max_size = 1024 * 1024, -- 1MB
		    max_line_length = 500, -- max line length
		    ft = nil, ---@type string? filetype for highlighting. Use `nil` for auto detect
		},
		man_pager = nil, ---@type string? MANPAGER env to use for `man` preview
	    },
	    ---@class snacks.picker.jump.Config
	    jump = {
		jumplist = true, -- save the current position in the jumplist
		tagstack = false, -- save the current position in the tagstack
		reuse_win = false, -- reuse an existing window if the buffer is already open
	    },
	    win = {
		-- input window
		input = {
		    keys = {
			["<Esc>"] = "close",
			["<C-c>"] = { "close", mode = "i" },
			-- to close the picker on ESC instead of going to normal mode,
			-- add the following keymap to your config
			-- ["<Esc>"] = { "close", mode = { "n", "i" } },
			["<CR>"] = { "confirm", mode = { "n", "i" } },
			["G"] = "list_bottom",
			["gg"] = "list_top",
			["j"] = "list_down",
			["k"] = "list_up",
			["/"] = "toggle_focus",
			["q"] = "close",
			["?"] = "toggle_help",
			["<a-d>"] = { "inspect", mode = { "n", "i" } },
			["<c-a>"] = { "select_all", mode = { "n", "i" } },
			["<a-m>"] = { "toggle_maximize", mode = { "i", "n" } },
			["<a-p>"] = { "toggle_preview", mode = { "i", "n" } },
			["<a-w>"] = { "cycle_win", mode = { "i", "n" } },
			["<C-w>"] = { "<c-s-w>", mode = { "i" }, expr = true, desc = "delete word" },
			["<C-Up>"] = { "history_back", mode = { "i", "n" } },
			["<C-Down>"] = { "history_forward", mode = { "i", "n" } },
			["<Tab>"] = { "select_and_next", mode = { "i", "n" } },
			["<S-Tab>"] = { "select_and_prev", mode = { "i", "n" } },
			["<Down>"] = { "list_down", mode = { "i", "n" } },
			["<Up>"] = { "list_up", mode = { "i", "n" } },
			["<c-j>"] = { "list_down", mode = { "i", "n" } },
			["<c-k>"] = { "list_up", mode = { "i", "n" } },
			["<c-n>"] = { "list_down", mode = { "i", "n" } },
			["<c-p>"] = { "list_up", mode = { "i", "n" } },
			["<c-b>"] = { "preview_scroll_up", mode = { "i", "n" } },
			["<c-d>"] = { "list_scroll_down", mode = { "i", "n" } },
			["<c-f>"] = { "preview_scroll_down", mode = { "i", "n" } },
			["<c-g>"] = { "toggle_live", mode = { "i", "n" } },
			["<c-u>"] = { "list_scroll_up", mode = { "i", "n" } },
			["<ScrollWheelDown>"] = { "list_scroll_wheel_down", mode = { "i", "n" } },
			["<ScrollWheelUp>"] = { "list_scroll_wheel_up", mode = { "i", "n" } },
			["<c-v>"] = { "edit_vsplit", mode = { "i", "n" } },
			["<c-s>"] = { "edit_split", mode = { "i", "n" } },
			["<c-q>"] = { "qflist", mode = { "i", "n" } },
			["<a-i>"] = { "toggle_ignored", mode = { "i", "n" } },
			["<a-h>"] = { "toggle_hidden", mode = { "i", "n" } },
			["<a-f>"] = { "toggle_follow", mode = { "i", "n" } },
		    },
		    b = {
			minipairs_disable = true,
		    },
		},
		-- result list window
		list = {
		    keys = {
			["<CR>"] = "confirm",
			["gg"] = "list_top",
			["G"] = "list_bottom",
			["i"] = "focus_input",
			["j"] = "list_down",
			["k"] = "list_up",
			["q"] = "close",
			["<Tab>"] = "select_and_next",
			["<S-Tab>"] = "select_and_prev",
			["<Down>"] = "list_down",
			["<Up>"] = "list_up",
			["<a-d>"] = "inspect",
			["<c-d>"] = "list_scroll_down",
			["<c-u>"] = "list_scroll_up",
			["zt"] = "list_scroll_top",
			["zb"] = "list_scroll_bottom",
			["zz"] = "list_scroll_center",
			["/"] = "toggle_focus",
			["<ScrollWheelDown>"] = "list_scroll_wheel_down",
			["<ScrollWheelUp>"] = "list_scroll_wheel_up",
			["<c-a>"] = "select_all",
			["<c-f>"] = "preview_scroll_down",
			["<c-b>"] = "preview_scroll_up",
			["<c-v>"] = "edit_vsplit",
			["<c-s>"] = "edit_split",
			["<c-j>"] = "list_down",
			["<c-k>"] = "list_up",
			["<c-n>"] = "list_down",
			["<c-p>"] = "list_up",
			["<a-w>"] = "cycle_win",
			["<Esc>"] = "close",
		    },
		    wo = {
			conceallevel = 2,
			concealcursor = "nvc",
		    },
		},
		-- preview window
		preview = {
		    keys = {
			["<Esc>"] = "close",
			["q"] = "close",
			["i"] = "focus_input",
			["<ScrollWheelDown>"] = "list_scroll_wheel_down",
			["<ScrollWheelUp>"] = "list_scroll_wheel_up",
			["<a-w>"] = "cycle_win",
		    },
		},
	    },
	    ---@class snacks.picker.icons
	    icons = {
		files = {
		    enabled = true, -- show file icons
		},
		indent = {
		    vertical    = "│ ",
		    middle = "├╴",
		    last   = "└╴",
		},
		undo = {
		    saved   = " ",
		},
		ui = {
		    live        = "󰐰 ",
		    hidden      = "h",
		    ignored     = "i",
		    follow      = "f",
		    selected    = "● ",
		    unselected  = "○ ",
		    -- selected = " ",
		},
		git = {
		    commit = "󰜘 ",
		},
		diagnostics = {
		    Error = " ",
		    Warn  = " ",
		    Hint  = " ",
		    Info  = " ",
		},
		kinds = {
		    Array         = " ",
		    Boolean       = "󰨙 ",
		    Class         = " ",
		    Color         = " ",
		    Control       = " ",
		    Collapsed     = " ",
		    Constant      = "󰏿 ",
		    Constructor   = " ",
		    Copilot       = " ",
		    Enum          = " ",
		    EnumMember    = " ",
		    Event         = " ",
		    Field         = " ",
		    File          = " ",
		    Folder        = " ",
		    Function      = "󰊕 ",
		    Interface     = " ",
		    Key           = " ",
		    Keyword       = " ",
		    Method        = "󰊕 ",
		    Module        = " ",
		    Namespace     = "󰦮 ",
		    Null          = " ",
		    Number        = "󰎠 ",
		    Object        = " ",
		    Operator      = " ",
		    Package       = " ",
		    Property      = " ",
		    Reference     = " ",
		    Snippet       = "󱄽 ",
		    String        = " ",
		    Struct        = "󰆼 ",
		    Text          = " ",
		    TypeParameter = " ",
		    Unit          = " ",
		    Unknown        = " ",
		    Value         = " ",
		    Variable      = "󰀫 ",
		},
	    },
	    ---@class snacks.picker.debug
	    debug = {
		scores = false, -- show scores in the list
		leaks = false, -- show when pickers don't get garbage collected
	    },
	},
    },
    keys = {
	{ mode = 'n', "<leader>,", function() Snacks.picker.buffers() end, desc = "snacks.picker: Find Buffers" },
	{ mode = 'n', "<leader>/", function() Snacks.picker.grep() end, desc = "snacks.picker: Find Grep" },
	{ mode = 'n', "<leader>:", function() Snacks.picker.command_history() end, desc = "snacks.picker: Search Command History" },
	{ mode = 'n', "<leader><space>", function() Snacks.picker.files() end, desc = "snacks.picker: Find Files" },
	-- Find files
	{ mode = 'n', "<leader>fb", function() Snacks.picker.buffers() end, desc = "snacks.picker: Find Buffers" },
	{ mode = 'n', "<leader>fc", function() Snacks.picker.files({ cwd = vim.fn.stdpath("config") }) end, desc = "snacks.picker: Find Config File" },
	{ mode = 'n', "<leader>ff", function() Snacks.picker.files() end, desc = "snacks.picker: Find Files" },
	{ mode = 'n', "<leader>fg", function() Snacks.picker.git_files() end, desc = "snacks.picker: Find Git Files" },
	{ mode = 'n', "<leader>fr", function() Snacks.picker.recent() end, desc = "snacks.picker: Find Recent" },
	-- Git
	{ mode = 'n', "<leader>gl", function() Snacks.picker.git_log() end, desc = "snacks.picker: Git Log" },
	{ mode = 'n', "<leader>gs", function() Snacks.picker.git_status() end, desc = "snacks.picker: Git Status" },
	-- Grep
	{ mode = 'n', "<leader>sb", function() Snacks.picker.lines() end, desc = "snacks.picker: Search Buffer Lines" },
	{ mode = 'n', "<leader>sB", function() Snacks.picker.grep_buffers() end, desc = "snacks.picker: Grep Open Buffers" },
	{ mode = 'n', "<leader>sg", function() Snacks.picker.grep() end, desc = "snacks.picker: Grep" },
	{ mode = 'n', "<leader>sw", function() Snacks.picker.grep_word() end, desc = "snacks.picker: Search Visual selection or word" },
	{ mode = 'x', "<leader>sw", function() Snacks.picker.grep_word() end, desc = "snacks.picker: Search Visual selection or word" },
	-- Search contents
	{ mode = 'n', '<leader>s"', function() Snacks.picker.registers() end, desc = "snacks.picker: Search Registers" },
	{ mode = 'n', "<leader>sa", function() Snacks.picker.autocmds() end, desc = "snacks.picker: Search Autocmds" },
	{ mode = 'n', "<leader>sc", function() Snacks.picker.command_history() end, desc = "snacks.picker: Search Command History" },
	{ mode = 'n', "<leader>sC", function() Snacks.picker.commands() end, desc = "snacks.picker: Search Commands" },
	{ mode = 'n', "<leader>sd", function() Snacks.picker.diagnostics() end, desc = "snacks.picker: Search Diagnostics" },
	{ mode = 'n', "<leader>sh", function() Snacks.picker.help() end, desc = "snacks.picker: Search Help Pages" },
	{ mode = 'n', "<leader>sH", function() Snacks.picker.highlights() end, desc = "snacks.picker: Search Highlights" },
	{ mode = 'n', "<leader>sj", function() Snacks.picker.jumps() end, desc = "snacks.picker: Search Jumps" },
	{ mode = 'n', "<leader>sk", function() Snacks.picker.keymaps() end, desc = "snacks.picker: Search Keymaps" },
	{ mode = 'n', "<leader>sl", function() Snacks.picker.loclist() end, desc = "snacks.picker: Search Location List" },
	{ mode = 'n', "<leader>sM", function() Snacks.picker.man() end, desc = "snacks.picker: Search Man Pages" },
	{ mode = 'n', "<leader>sm", function() Snacks.picker.marks() end, desc = "snacks.picker: Search Marks" },
	{ mode = 'n', "<leader>sR", function() Snacks.picker.resume() end, desc = "snacks.picker: Search Resume" },
	{ mode = {'n','v'}, "<leader>sp", function() Snacks.picker.spelling() end, desc = "snacks.picker: Search spelling" },
	{ mode = 'n', "<leader>sq", function() Snacks.picker.qflist() end, desc = "snacks.picker: Search Quickfix List" },
	{ mode = 'n', "<leader>uC", function() Snacks.picker.colorschemes() end, desc = "snacks.picker: Search Colorschemes" },
	{ mode = 'n', "<leader>qp", function() Snacks.picker.projects() end, desc = "snacks.picker: Search Projects" },
	-- LSP
	-- see lspconfig for snacks.picker based keymaps
    }
}

3 replies

folke Feb 25, 2025
Maintainer

I don't see how this can happen. Same as your previous error. Both can't happen under normal circumstances.

Your config: it's a really bad practice to copy over default options to your own config. Not sure if this gives this issue, but I really wouldn't do that.

If you want me to further look into this, then please open an issue and provide a minimal repro.lua as is instructed in the issue template. Together with the exact steps to reproduce.

Or1g3n Feb 25, 2025
Author

Okay, I do it this way to understand what the defaults are and then tweak as needed. For me it solves the "you don't know what you don't know" problem so seeing the defaults make it easy to modify as needed. But I can also see where this could not be considered best practice so will definitely take your advice into account.

I decided to clear out the entire config so that only the defaults are present. But still getting the error. The reason why I thought this was related to the image preview, is bc this ONLY occurs when the item selector cycles over a .png file.

After that message clears, there is a pane that shows in the background concerning image preview:

I can definitely put in an issue in and follow the template. Thanks!

Or1g3n Apr 4, 2025
Author

@folke

Howdy, just wanted to check back in to let you know that the issue described above is no longer present. The previewer for snacks.picker is now working flawlessly with no crash on images/pdfs/etc. I am also on Nvim 11.0, not sure if that made any difference but whatever updates you have made since my last post resolved the issue. Thanks! Going to mark this done.

reekta92 · 2025-05-23T07:56:29Z

reekta92
May 23, 2025

I know it's kinda late but if anyone else needs it this works:

picker = {
    enabled = true,
    preview = { enabled = false, }
}

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

How to disable image preview in snacks.picker? #1431

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Replies: 3 comments 3 replies

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

How to disable image preview in snacks.picker? #1431

Uh oh!

Uh oh!

Or1g3n Feb 25, 2025

Replies: 3 comments · 3 replies

Uh oh!

folke Feb 25, 2025 Maintainer

Uh oh!

Or1g3n Feb 25, 2025 Author

Uh oh!

folke Feb 25, 2025 Maintainer

Uh oh!

Uh oh!

Or1g3n Feb 25, 2025 Author

Uh oh!

Or1g3n Apr 4, 2025 Author

Uh oh!

reekta92 May 23, 2025

Or1g3n
Feb 25, 2025

Replies: 3 comments 3 replies

folke
Feb 25, 2025
Maintainer

Or1g3n
Feb 25, 2025
Author

folke Feb 25, 2025
Maintainer

Or1g3n Feb 25, 2025
Author

Or1g3n Apr 4, 2025
Author

reekta92
May 23, 2025