Neovim plugin to take screenshots of your Neovim session on MacOS.
Warning
This project is still a work in progress and not considered stable
See wiki for detailed information, configuration recipes, and demos.
render-nvim-demo.mov
- 📷 Capture image of window by process ID
- 🎥 Capture video recording
- 🟪 Capture image or video by window boundaries
- ✂️ Capture to clipboard
- 💾 Capture to file
- 🔳 Add window's shadow in window capture mode
- 🔢 Take capture after a delay
- 🎧 Play sound effect on capture
- 💥 Flash window on capture
- 🖱️ Show clicks during video recording
- 💅 Show floating thumbnail after capture
- 🏃♂️ Open captures in quick view
- 🔧 Open captures in quickfix list
- 🔍 Automatically open or preview capture
- ⏰ Limit capture video recording time
- 📝 Fine-tune cropping of window boundaries
- 🤳 Image formats
pngjpgpdfpsdtgabmpgiftif - 🎬 Video format
mov
| Command | API | Description |
|---|---|---|
:Render {profilename} |
require('render.api').render(string|table|nil) |
Capture image or video recording |
:RenderDryRun {profilename} |
require('render.api').dryrun(string|table|nil) |
Execute render logic without capturing result |
:RenderClean[!] |
require('render.api').clean(table|nil) |
Delete existing captures in output directory and reinstall dependencies |
:RenderExplore |
require('render.api').explore() |
Open render output directory in Neovim |
:RenderQuickfix[!] |
require('render.api').quickfix(table|nil) |
Toggle open output directory in quickfix window |
:RenderInterrupt |
require('render.api').interrupt() |
Send interrupt to stop video recoring |
:RenderQuicklook |
require('render.api').quicklook() |
Open all files in output directory with quick look |
:RenderSetWindowInfo {pid} |
require('render.api').set_window_info(integer|nil) |
Set the window information to the active Neovim session or by process ID |
Keymappings are enabled by default. If you would like to disable all keymappings, set the configuration features.keymaps to false.
{
features = {
keymaps = false,
},
}If you would like to override the keymappings defined on setup, then set the configuration
{
fn = {
keymap_setup = function()
-- custom keymaps
end,
},
}The following table lists the default keymappings.
<f13> is typically the print screen key, but this may vary depending on your keyboard. <f13> is equivalent to <shift-f1>.
| Keymaps | Mode | Description |
|---|---|---|
<f13> |
All | Capture image or video recording with default profile. Equivalent to require('render.api').render('default') |
<leader><f13> |
Normal | Send interrupt to stop video recoring. Equivalent to require('render.api').interrupt() |
<c-f13> |
Normal | Toggle open output directory in quickfix window. Equivalent to require('render.api').quickfix({toggle = true}) |
<cr>, <c-w><cr> |
Normal (Quickfix window) | Open the quickfix item using the command defined in configuration fn.open_cmd |
<tab> |
Normal (Quickfix window) | Open the quickfix item using quick look command qlmanage |
| Property | Type | Description |
|---|---|---|
| features.notify | boolean | |
| features.keymaps | boolean | |
| features.flash | boolean | |
| features.auto_open | boolean | |
| features.auto_preview | boolean | |
| features.sound_effect | boolean | |
| notify.level | string | |
| notify.msg | fun(msg, level, extra) | |
| notify.verbose | boolean | |
| fn.window_info.cmd | fun(): string | |
| fn.window_info.opts | fun(RenderOutputFiles, RenderProfileOptions): table | |
| fn.screencapture.cmd | fun(RenderWindowInfo, RenderOutputFiles, ProfileOptions): table|nil | |
| fn.screencapture.opts | fun(RenderOutputFiles, RenderProfileOptions, table): table | |
| TODO: left off here | ||
| fn.screencapture_location.cmd | ||
| fn.screencapture_location.opts |
The following table lists equivalent render.nvim options to the underlying screencapture command.
| Option | Argument | Description |
|---|---|---|
features.sound_effect = false |
-x |
Do not play sounds |
profile.delay = <seconds> |
-T<seconds> |
Take the capture after a delay of |
profile.filetype = '<format>' |
-t<format> |
Image format to create, default is png |
profile.image_capture_mode = 'bounds' |
-R<x,y,w,h> |
Capture screen rect |
profile.image_capture_mode = 'window' |
-l<id> |
Capture window with |
profile.mode = 'clipboard' |
-c |
Force screen capture to go to the clipboard |
profile.mode = 'preview' |
-u |
Present UI after screencapture is complete |
profile.show_clicks = true |
-k |
Show clicks in video recording mode |
profile.type = 'video' |
-v |
Capture video recording of the screen |
profile.window_shadow = false |
-o |
In window capture mode, do not capture the shadow of the window |
| Name | Description | Installation Method |
|---|---|---|
| Neovim v0.9+ | Neovim version 0.9 or greater | User installed |
| screencapture | Captures image and video of the whole, or part of the screen | Included on Mac |
| qlmanage | Displays quick look previews | Included on Mac |
| pdubs | Retreives window information for the Neovim session | Downloaded by render.nvim |
curl, shasum, tar |
Required to download, extract, and verify pdubs binary |
Included on Mac |
Using lazy.nvim
{
"mikesmithgh/render.nvim",
config = function()
require("render").setup()
end,
}Using Neovim's built-in package support pack
mkdir -p "$HOME/.local/share/nvim/site/pack/mikesmithgh/start/"
cd $HOME/.local/share/nvim/site/pack/mikesmithgh/start
git clone [email protected]:mikesmithgh/render.nvim.git
nvim -u NONE -c "helptags render.nvim/doc" -c q
echo "require('render').setup()" >> "$HOME/.config/nvim/init.lua" - Window information such as window ID, size and position are determined for the current process using pdubs
- Window information and configuration options are parsed and translated to a screencapture command
- macOS 13 Ventura
- macOS 12 Monterey
- macOS 11 Big Sur
Screen recording must be enabled in order for render.nvim to take screencaptures. This will need to be enabled for the application that is running Neovim. For example, Kitty, Alacritty, iTerm2, Neovide, etc. The first time you attempt to take a screenshot, you may see a prompt to allow access.
Open System Settings and enable screen recording for your application.
- Choose Apple menu 🍎 > System Settings, then click Privacy & Security ✋ in the sidebar. (You may need to scroll down.)
- Click Screen Recording.
- Turn screen recording on or off for each app in the list.
- 🐿️ gruvsquirrel.nvim Neovim colorscheme written in Lua inspired by gruvbox
- 🦬 pdubs A simple command-line utility to return macos window information for a given pid.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent