Small.nvim

This is a collection of small plugins that I created just because.

I don't plan on doing good maintenance, so I might change things without warning.

Some of the plugins are a complete hack while others are top quality

The documentation is not up to date.

Optional dependencies:

• nvim-telescope/telescope.nvim: many plugins use a selector
• rcarriga/nvim-notify or something similar: many plugins use vim.notify

Beacon

Summary: Simple flash cursor at pos.
Commands:

• beacon.flash flashes the cursor
• beacon.create_autocmd returns an autocmd to flash the cursor on move

Config:

• beacon.conf.interval ms between flashes
• beacon.conf.count how many flashes
• beacon.conf.color color of flash (may be #rgb or color-name)
• beacon.conf.minimal minimal size of move to flash cursor

Rewrite into normal plugin: https://github.com/altermo/beacon.nvim

Bottombar

Summary: Bottombar shows information in the bottom right corner.
Setup: bottombar.setup()

Bufend

Summary: Bufend makes it easy to quickly goto a specific file in your file system.
Commands: bufend.run()

Pseudocode explanation: of what bufend.run() does

char=getchar()
if char=='<esc>':return
elif char=='<tab>':
    set_mark(getchar(),select_file_from_opend())
elif char=='<bs>':
    del_mark(getchar())
elif char=='<cr>':
    edit(select_file_from_opend())
else:
    if marks[char]:
        edit(marks[char])
    elif (files:=get_opened_file_with_starting_char(char)):
        edit(files[0] if len(files)==1 or select(files))
    else:
        edit(select(get_files_with_starting_char(char)))

builder

Optional: python,mojo,fish,lua5.1,fennel,dotnet,rust,zig (used also for c/c++),make
Summary: Basically, a simple run file system.
Commands:

• builder.termbuild runs the file in the terminal
• builder.eval evaluates the file as vim code
• builder.swap swap commonly used runners (like rustc and cargo run)
• builder.set set the builder for the current filetype

Config:

• builder.conf.builders a table of builders, (see source code)

Chat

Required: some chat program that has a bin chat Summary: Runs chat in buffer
Commands: chat.run()

Cmd2ins

Summary: Run insert mappings (like nvim-autopairs) in the cmdline
Commands:

• cmd2ins.map(key) run key from command mode in insert mode

Color_cmdline

Summary: Color the cmdline
Setup: color_cmdline.setup()
NOTE: it uses some internal things (which are only there for testing) to accomplish this

Color_shift

Summary: slowly shifts between two colors
Commands: color_shift.shift(to_colorscheme,time,steps?)

Colorfn

Summary: shift r, g or b by amount
Commands: colorfn.run()

Colors

Summary: select between colors (offline and online)
Commands:

• colors.search_colors: search colors in runtimepath
• colors.search_colors_online: search colors on neovimcraft.com

Copyring

Summary: minimal yankring Setup: copyring.setup()

Curosr

Summary: Create multiple cursors
Setup: cursor.setup()
Commands:

• cursor.create_cursor() create a cursor
• cursor.goto_next_cursor(create_cursor) goes to next cursor, if create_cursor is true, creates a cursor before jumping
• clear_cursor clears the cursors in current buffer

Cursor_xray

Summary: xray current buffer if cursor covered by floating window
Setup: cursor_xray.setup()

Dapnvim

Summary: Similar to osv.run_this but opens nvim instance in a terminal buffer Requires: nvim-dap, one-small-step-for-vimkind Commands:

• dapnvim.start: Runs osv inside a new neovim instance and opens instance in new window

Debugger

Summary: Open a debugger buffer on error Commands: debugger.error(): run the debugger debugger.override_error(): replace normal error with the debugger

Dff

Summary: The hop/leap/flash style selector + a file explorer (not manager).
Commands:

• dff.file_expl(dir?) opens a dff file selector. Use <esc> to quit.

Pseudocode explanation: of how the dff algorithm works

items=get_items()
col=0
while len(items)!=1:
    char_at_col=items[0][col]
    while all(map(lambda x:x[col]==char_at_col,items)):
        col=col+1
    char=getchar()
    if char=='<esc>':break
    items=filter(lambda x:x[col]==char,items)

Elastic_tabstop

Summary: elastic tabstop. info
Setup: elastic_tabstop.setup()

Exchange

Summary: Exchange two selected regions.
Commands:

• exchange.ex_line() exchange current line
• exchange.ex_oper() exchange operator
• exchange.ex_visual() exchange visual
• exchange.ex_eol() exchange to end of line
• exchange.ex_cancel() cancel exchange

Keymap (example):

vim.keymap.set('n','cx',exchange.ex_oper)
vim.keymap.set('n','cX',exchange.ex_eol)
vim.keymap.set('n','cxx',exchange.ex_line)
vim.keymap.set('n','cxc',exchange.ex_cancel)
vim.keymap.set('x','X',exchange.ex_visual)

Fastmultif

Summary: A faster way to do multiple finds Commands:

• fastmultif.find: run fastmultif forwards
• fastmultif.rfind: run fastmultif backwards Config:
• fastmultif.conf.labels labels to use

Fendy

Summary: luay but for fend.
Commands: fendy.run()

Filetree

Required: netrw
Summary: Filetree using netrw
Setup filetree.setup() (only changes netrw options)
Commands: filetree.toggle()

Float

Summary: create, move and resize floating windows, use ctrl-mouse to move/resize windows
Setup: float.setup()
Commands:

• float.make_floating(win,opt) make win floating

Config:

• float.conf.make_non_float_float_on_drag when dragging non-floating window, make it floating

Foldselect

Summary: Select from folds using vim.ui.select.
Commands: foldselect.run()

Foldtext

Summary: A simple foldtext.
Setup: foldtext.setup() Config:

• foldtext.conf.treesitter whether to use treesitter Highlighting

Format

Summary: format file with formatter if config exist, fallback lsp.format.
Commands: format.run()

Help_cword

Summary: Try to get help from current word.
Commands: help_cword.run()

Help_readme

Required: ctags
Summary: Generates tag with the prefix readme- from readme files (so that you can :help readme-*).
Setup: help_readme.setup()
Commands:

• help_readme.generate() generate tag file from readme to path

Config:

• help_readme.conf.path where the readmes/tagfile is put

Highlight_selected

Summary: Highlight matching selected text in visual mode.
Setup: highlight_selected.setup()

Iedit

Summary: rewrite of emacs-iedit in neovim
Commands:

• iedit.visual_all() run iedit on current visual selection
• iedit.visual_select() interactive select and iedit on current visual selection

Rewrite into normal plugin: https://github.com/altermo/iedit.nvim

Incdec

Summary: ctrl-a/x but also dates. Commands:

• incdec.inc() increment value
• incdec.dec() decrement value

Kitty

Summary: Synchronize with kitty terminal
NOTE: Can't be configured yet.
Setup: kitty.setup()

Jumpall

Inspired by: longbow
Summary: Using 2 length de Bruijn sequence jump to anywhere without problem.
Commands: jumpall.run()
Config:

• jumpall.conf.labels labels to use for jumping

Labull

Summary: Auto adds bullets for bullet-list.
Commands: labull.run() (map-expr) Keymap (example):

vim.keymap.set('n','o',labull.run,{expr=true})

Large

Summary: Makes letters large.
Commands:

• labull.start(): makes letters large (NOTE: does not have a stop)

Layout

Summary: Save and load current tabpage layout.
Commands:

• layout.save() save current tabpage layout to path
• layout.load() load tabpage layout from path

Config:

• layout.conf.savepath path to save the layout

Lbpr

Inspired by: pyro
Summary: Code based replace file wide.
Commands: lbpr.run()
NOTE:

• :write on script buf to run script.
• :write on preview buf to save changes.

Luay

Inspired by: luapad
Summary: a minimal version of luapad.
Commands: luay.run()

Macro

Summary: A simple macro plugin
Commands:

• macro.toggle_rec(): toggle the recoding of macro
• macro.play_rec(): play the macro
• macro.edit_rec(): edit the macro

Matchall

Summary: Match current word + vim.lsp.buf.document_highlight
Setup: matchall.setup()

Node_eval

Required: treesitter
Summary: Evaluate node with bin
Setup: node_eval.setup()

Config:

• node_eval.conf.node the node type to evaluate
• node_eval.conf.bin the bin to evaluate with
• node_eval.conf.handle the function to handle the output
• node_eval.conf.pre_handle the function to do stuff before running the bin (not required)

Nodeswap

Required: treesitter
Summary: Smarter node swap
Commands:

• nodeswap.swap_next() swap with next node
• nodeswap.swap_prev() swap with prev node
• nodeswap.over() undo swap and swap with parent node

Config:

• nodeswap.conf.nodes which tsnodes should be considered as nodes

Notify

summary: a rewrite of fidget.nvim
Commands:

• notify.notify(msg,level,opts) do a notify
• notify.open_history() open the history in a new buffer
• notify.override_notify() override vim.notify
• notify.dismiss() dismiss the current notifications

Config:

• notify.conf.style: what styles to use for which level
• notify.conf.fallback_notify: fallback notify (not used)
• notify.conf.timeout=2000: time until notification closes
• notify.conf.historysize=100: the size of history

Nterm

Summary: Run terminal or use neovim as a terminal.
Commands:

• nterm.run(cmd?,smart_quit_nvim?) creates a new terminal
  • cmd?: the cmd to run, defaults to &shell
  • smart_quit_nvim?: if is the only buffer open, quits neovim

Example: Here is an example of how to use neovim-qt as a terminal:

nvim-qt -- -c "lua require'small.nterm'.run(nil,true)"

Onelinecomment

Optional: treesitter
Summary: Toggle comments out the text, can detect filetype with treesitter.
Commands: onelinecomment.run() (map-expr)
Keymap (example):

vim.keymap.set('x','gc',onelinecomment.run)
vim.keymap.set('n','gc',onelinecomment.run)

Own

Summary: Colorscheme

Plugin_search

Required: curl
Summary: Searches and download and inits plugins using nvim.sh
Commands: plugin_search.run()

Qrun

Summary: Quick run neovim
Commands: qrun.run()

Qvim2

Summary: Quick run neovim (version 2)
Commands: qrun.run()

Rainbow_pair

Required: treesitter
Summary: rainbow pairs
Setup: rainbow_pair.setup()\

Ranger

Required: ranger
Summary: simple ranger wrapper
Commands: ranger.run(file?)
Config:

• ranger.conf.exit_if_single: exit neovim when quitting ranger if it is the only buffer

Recenter_top_bottom

Summary: Works like emacs's (recenter-top-bottom)
Commands: recenter_top_bottom()

Reminder

Summary: Searches the reminder.conf.path for any bullet list with -, and a date (@YYYY-MM-DD HH:MM), and does a reminder when the time comes.
Setup: reminder.setup()
Commands:

• reminder.sidebar: open a sidebar with all the reminders

Config:

• reminder.conf.path (required) file to find reminders in

Reminder2

Summary: Searches the reminder2.conf.path for any bullet list with -, and a date @YYYY-MM-DD, and does a reminder when the time comes. Setup: reminder2.setup()
Commands:

• reminder2.sidebar: open a sidebar with all the reminders

Config:

• reminder2.conf.path (required) file to find reminders in

Remote

Summary: Remote control nvim from another neovim.
Run: remote.run()

Ruler

Summary: A simple ruler.
Setup: tabline.setup()

Small_loader

Summary: a lazy loader for small plugins.
Run: small_loade.run()

Specfile

Summary: Run scripts on specific file opens.
Setup: specfile.setup()
Config:

• specfile.conf.ext which file ext runs which command name
• specfile.conf.prgm command name to command
• specfile.conf.bigfile limit the max file size
• specfile.conf.startinsert start insert on term command

Splitbuf

Summary: A replacement for :split and :vsplit.
Commands:

• splitbuf.split(): splits then splitbuf.open()
• splitbuf.vsplit() splits then splitbuf.open()
• splitbuf.open(): Opens a window with some commands, if you press a key linked with the command, the command will run, otherwise the key will be sent to the buffer

Config:

• splitbuf.conf.options a table of commands (see source code)
• splitbuf.conf.call a function which oveerides the default behaviour

Statusbuf

Summary: Statusline in buffer (floating window) Setup: statusbuf.setup

Tableformat

Summary: format markdown tables
Commands: tablemode.run()

Tabline

Summary: A simple tabline.
Setup: tabline.setup()

Textobj

Summary: Text-objs to get a row/column of the same character.
Commands:

• textobj.wordcolumn get same selected in column (map-expr)
• textobj.charcolumn get same char in column (map-expr)
• textobj.wordrow get same selected in row (map-expr)
• textobj.charrow get same char in row (map-expr) Keymap (example):

vim.keymap.set('x','im',textobj.wordcolumn,{expr=true})
vim.keymap.set('o','im',textobj.charcolumn,{expr=true})
vim.keymap.set('x','ik',textobj.wordrow,{expr=true})
vim.keymap.set('o','ik',textobj.charrow,{expr=true})

Trans

Requires: translate-shell
Summary: Simple translation plugin.
Commands:

• trans.cword() translate the current word

Config:

• trans.conf.from the language to translate from (can be modified whenever)
• trans.conf.to the language to translate to (can be modified whenever)

Tree_lua_block_split_join

Required: treesitter
Summary: Split-join if/for/function_definition blocks
Commands: tree_lua_block_split_join.run()

Treewarn

Required: treesitter
Summary: Warn on some treesitter structures
Setup: treewarn.setup() Config:

• treewarn.conf[lang]: list of queries with the capture @warn; and to add custo messages: (#set! "mes" "...")

Treeselect

Required: treesitter
Summary: Similar to Helix's treesitter selection
Commands:

• treeselect.current(): select current node
• treeselect.line(): select current node linewise
• treeselect.base(): select one below root node
• treeselect.next(): select next node
• treeselect.prev(): select previous node
• treeselect.up(): select parent node
• treeselect.down(): select child node

Ts_paren

Required: treesitter
Summary: parenthesise all nodes (containing multiple nodes)
Command: ts_paren.run()

Typo

Required: typos and or codespell
Summary: show code typos/codespells
Setup: typo.setup()

Unimpaired

Summary: Goto next/previous file OR quickly change options
Commands:

• unimpaired.edit_next_file(): edit next file
• unimpaired.edit_prev_file(): edit prev file
• set_opt: set option (and opens a preview window)

Verttab

Summary: Vertical tabline Setup: verttab.setup()

Whint

Summary: Basically:

function fun(arg|) end
--> :
---@param arg |
function fun(arg) end
--> -
---@param arg
function fun(arg|) end

Commands: whint.run() (map-expr)
Keymap (example):

vim.keymap.set('i',':',whint.run,{expr=true})

Winpick

Inspired by: nvim-window-picker
Summary: pick window by symbol
Commands: winpick.pick()

Configs:

• winpick.conf.color color of winbar (may be #rgb or color-name)
• winpick.conf.symbols symbols to use

Winvis

Summary: Only show visual selection in current window.
Setup: winvis.setup()

Zen

Summary: Simple zen
Commands: zen.run()

Zenall

Summary: Zen in all the windows (not just the current one).
Setup: zenall.setup()

Donate

If you want to donate then you need to find the correct link (hint: chess-bird):

• 0a 0b 0c 0d 0e 0f 0g 0h
• 1a 1b 1c 1d 1e 1f 1g 1h
• 2a 2b 2c 2d 2e 2f 2g 2h
• 3a 3b 3c 3d 3e 3f 3g 3h
• 4a 4b 4c 4d 4e 4f 4g 4h
• 5a 5b 5c 5d 5e 5f 5g 5h
• 6a 6b 6c 6d 6e 6f 6g 6h