nerdy.nvim

Find Nerd Glyphs Easily 🤓🔭

nerdy.nvim in action

Do you like Nerd fonts? but don't like going over to their site to fetch a glyph for your pretty terminal? Well, me too!

Introducing nerdy.nvim, a super handy plugin that lets you search, preview and insert all nerd font glyphs straight from Neovim!

✨ Features

• Fuzzy search and insert nerd glyphs, by name and unicode
• Find and insert icons you use frequently
• Programmatic access to nerd glyphs by name for use in your configs
• Auto fetch latest icons list from official sources

Setup

⚡ Requirements

• You have installed the latest version of neovim
• snacks.nvim picker — for prettier select UI

🚀 Installation

-- Lazy
{
    '2kabhishek/nerdy.nvim',
    dependencies = {
        'folke/snacks.nvim',
    },
    cmd = 'Nerdy',
    opts = {
        max_recents = 30, -- Configure recent icons limit
        add_default_keybindings = true, -- Add default keybindings
        use_new_command = true, -- Enable new command system
    }
},

💻 Usage

🚀 Commands

Available Commands:

• :Nerdy - Browse all nerd font icons (default behavior)
• :Nerdy list - Browse all nerd font icons (explicit)
• :Nerdy recents - Browse recently used icons
• :Nerdy get <icon_name> - Insert specific icon by name

Deprecated Commands

⚠️ DEPRECATION NOTICE: The following commands are deprecated and will be removed in a future version. Please migrate to the new Nerdy commands above. More information: #14

If you haven't updated your config yet, these commands still work but show deprecation warnings:

• Nerdy -> Nerdy or Nerdy list
• NerdyRecents -> Nerdy recents

Migration: Add use_new_command = true to your config to switch to the new unified interface:

⌨️ Keybindings

By default, these are the configured keybindings.

Keybinding	Command	Description
<leader>in	:Nerdy list<CR> or :Nerdy<CR>	Browser nerd icons
<leader>iN	:Nerdy recents<CR>	Browser recent nerd icons

I recommend customizing these keybindings based on your preferences.

Use :help nerdy for more details.

🔭 Telescope Extension

Nerdy also comes with a Telescope extension, to use it add the following to your telescope configs.

require('telescope').load_extension('nerdy')

And then call

:Telescope nerdy
:Telescope nerdy_recents
" or
:lua require('telescope').extensions.nerdy.nerdy()
:lua require('telescope').extensions.nerdy.nerdy_recents()

📝 Get Icons by Name Programmatically

You can also get nerd font icons programmatically using the nerdy.get() function:

local nerdy = require('nerdy')

-- Get a specific icon by name
local lua = nerdy.get('seti-lua')              -- Returns ''

-- Handle cases where icon doesn't exist
local unknown_icon = nerdy.get('non-existent') -- Returns '' and shows warning

-- Use in your own functions
local function get_language_icon(language)
    local icon_name = 'md-language_' .. language
    return nerdy.get(icon_name)
end

Recent icons are not tracked when fetching icons programmatically.

💡 This is useful when configuring Neovim status lines, file trees, or any plugin that needs consistent nerd font icons without hard coding unicode characters.

🔄 Fetch New Icons

Running the python scripts/generator.py command will automatically fetch new icons from source and update the icons.

Behind The Code

🌈 Inspiration

I love nerd font glyphs, and I use them anywhere I can! but I was wasting a lot of time going back and forth between nerd font site and neovim, also the copy feature was super buggy for me on the site, so I made nerdy!

💡 Challenges/Learnings

• Making the generated icon table with vim.ui.select was a bit tricky.

🧰 Tooling

• dots2k — Dev Environment
• nvim2k — Personalized Editor

🔍 More Info

• nerdicons.nvim — thanks to the original authors for the groundwork.
• co-author.nvim — Another one of my plugin that lets you add co authors.

---

⭐ hit the star button if you found this useful ⭐

Source | Blog | Twitter | LinkedIn | More Links | Other Projects