NORMAL ~/wkd/p/hover :set skin=modern utf-8

hover.nvim

Rest the cursor on something that points at a file — a markdown link, or a path written as plain text — and a small float shows what it points at.

status
beta — Beta stage — active development. This repository is past its first shape and in active use, but the surface is not frozen: breaking changes are still possible. Pin a commit or tag if you depend on it.
category
Files & navigation
neovim
0.11+
repo
github.com/WKDSteve/hover.nvim
commits
268
help
:help hover

demo

recorded with VHS from demos/hover.tape in a clean Neovim — re-recorded weekly
what is shown when
  1. :Hover show on a markdown link -> markdown.nvim finds the target -> the file, previewed in place
  2. :Hover show on a bare path in prose -> resolved next to the buffer -> previewed the same way
  3. :Hover show on file.md#heading -> that section of the file, not its top
  4. :Hover show on https://wkdsteve.github.io/wkd/ -> curl fetches the page -> status, title, first words
video and PDF links · recorded with VHS from demos/hover-media.tape in a clean Neovim — re-recorded weekly · needs media.nvim , pdfport.nvim What the float can hold depends on the terminal: with a graphics protocol (kitty, sixel) it draws a frame of the video and page 1 of the PDF; this recording runs in one without, so it shows what hover.nvim says instead.
what is shown when
  1. :Hover show on an mp4 link -> media.nvim probes it with ffprobe -> type, size, resolution, length
  2. :Hover show on a PDF link -> pdfport.nvim renders page 1 in a graphics terminal -> here: what the float says
  3. :Hover why on plain prose -> the gate that refused, and what would let it through

screenshots

hover.nvim: A bare path in prose: the file it points at, in a float with the name in the border.
A bare path in prose: the file it points at, in a float with the name in the border.
hover.nvim: An image link: with images.nvim in a graphics-capable terminal, the picture itself is drawn into the float. Not something a recording can show, hence a screenshot.
An image link: with images.nvim in a graphics-capable terminal, the picture itself is drawn into the float. Not something a recording can show, hence a screenshot.

install

{
  "WKDSteve/hover.nvim",
  opts = {},
}

docs/

git log

  1. fix directory: a one-row float shows the count alone; a cut sub-folder count keeps the floor
  2. test sheets: the http live sheet names no variable
  3. fix directory: the '… N more' line of a cut listing is on screen
  4. fix scroll: a file:42 hover scrolls on from the line it opened at
  5. fix text: scrolling back skips no line, a range as long as the page keeps its last line
  6. fix text: the … of a cut text page is on screen
  7. feat registry: chain several previews for one target type
  8. test sheets: :Hover images off and on, on the picture of the zoom sheet
  9. test sheets: what six :Hover switches do, by the trigger and :Hover why
  10. fix float: build each page as tall as the window beside the cursor
  11. ci check fileops.nvim out at ci-verified instead of a pinned commit
  12. fix float: never cover the cursor line on a small screen

keys

j / k
next / previous line
gg / G
first / last line
⏎
open the line under the cursor
/
search plugins and apps (app: x or plugin: x narrows)
:
command line — Tab completes
:help x
vimdoc of a plugin (:e x = plugin page)
:ls · :apps · :play · :log · :stack
plugin list · app list · play area · activity stream · dependency graph
:log apps
the stream of one area (plugins or apps)
:colo x
colorscheme
:set skin=
modern | tui
?
this help
esc
close