Skip to content

Snacks Explorer Extra

editor.snacks-explorer switches Blak’s configured explorer from Oil to Snacks. After enabling it, <leader>e and the dashboard Explorer action open or close Snacks explorer.

Enable it

-- ~/.config/blak/lua/blak/user.lua
return {
extras = {
enabled = {
"editor.snacks-explorer",
},
},
}

Or enable it interactively:

:BlakExtras enable editor.snacks-explorer

What it adds

SurfaceContribution
Configexplorer.provider = "snacks"
Snacksexplorer.enabled = true; explorer picker auto_close = true
Keymap<leader>e toggles Snacks explorer instead of opening Oil
External binaryfd is recommended for fast file discovery

The retargeted keymap appears in :BlakKeys. Blak also toggles an already-open Snacks explorer instead of opening a second one.

Configure explorer behavior

General Snacks explorer options go under snacks.explorer:

return {
extras = {
enabled = { "editor.snacks-explorer" },
},
snacks = {
explorer = {
replace_netrw = true,
trash = true,
},
},
}

The explorer is also a Snacks picker source. Configure its picker behavior under snacks.picker.sources.explorer:

return {
extras = {
enabled = { "editor.snacks-explorer" },
},
snacks = {
picker = {
sources = {
explorer = {
auto_close = false,
hidden = true,
ignored = false,
layout = {
layout = {
position = "right",
},
},
},
},
},
},
}

Switch back to Oil

Remove the extra or disable it:

:BlakExtras disable editor.snacks-explorer

If you set the provider manually, set it back:

return {
explorer = {
provider = "oil",
},
extras = {
enabled = {},
},
}

Restart Blak when you want already-loaded explorer hooks to disappear cleanly.