Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 1,194 Commits
.github		.github
autoload/health		autoload/health
doc		doc
lua		lua
plugin		plugin
src		src
.envrc		.envrc
.gitattributes		.gitattributes
.gitignore		.gitignore
.luacheckrc		.luacheckrc
.releaserc.js		.releaserc.js
.stylua.toml		.stylua.toml
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
LICENSE		LICENSE
README.md		README.md
flake.lock		flake.lock
flake.nix		flake.nix
rustfmt.toml		rustfmt.toml

Repository files navigation

🧩Cord – Tailor Your Presence Like Never Before

🚀 The most extensible Discord Rich Presence plugin for Neovim, powered by Rust.

Installation •Documentation •Discord

Important

Cord no longer requires Rust to be installed. Server component will be automatically downloaded from GitHub Releases.

💎 Features

⚡ Fast, lightweight, and batteries included.
🚀 Event-driven architecture with instant presence updates.
🎨 Dynamic string templates with custom variables.
🗃️ Customizable assets for any file/buffer type.
🔧 Flexible configuration with rich API, function-based fields, hooks, user commands and custom IPC paths.
🔌 Plugin system of its own, with many plugins out-of-the-box.
🛠️ Finds repositories and workspaces based on VCS files without relying on command-line tools.
🧠 Manages activities across all instances with a single connection to Discord.
💤 Detects when you're idle and switches to the most recent active instance.
📦 Works with different Discord setups (Snap, Flatpak,WSL, and even the~~browser~~).
🌍 Runs on Windows, Linux, macOS, and FreeBSD.
🌸 Includes 120+ unique icons for over 200 file types and plugins.
🔁 Reconnects automatically if connection to Discord is lost.

📦 Installation

lazy.nvim

{'vyfor/cord.nvim',build=':Cord update',-- opts = {}}

packer.nvim

use {'vyfor/cord.nvim',run=':Cord update',-- config = function()--   require('cord').setup {}-- end}

rocks.nvim

Cord is available onLuaRocks.

:Rocks install cord.nvim

Invoke:Cord update whenever the plugin is updated.

vim.pack (v0.12+)

vim.pack.add {'https://github.com/vyfor/cord.nvim'}vim.api.nvim_create_autocmd('PackChanged', {callback=function(opts)ifopts.data.spec.name=='cord.nvim'andopts.data.kind=='update'thenvim.cmd'Cord update'endend})

Vim packages

Unix:

git clone https://github.com/vyfor/cord.nvim~/.local/share/nvim/site/pack/plugins/start/cord.nvim

Windows (PowerShell):

git clone https://github.com/vyfor/cord.nvim$LOCALAPPDATA/nvim-data/site/pack/plugins/start/cord.nvim

Invoke:Cord update whenever the plugin is updated.

Considerations

Cord requires theserver executable to be present. By default, the plugin automatically fetches it from GitHub, which requires a dependency oncurl.

Alternatively, you can provide the executable manually:

Download from GitHub:
Get the latest release fromhttps://github.com/vyfor/cord.nvim/releases/latest, rename it tocord (orcord.exe on Windows), and place it undernvim-data-dir/cord/bin. This is essentially what:Cord update fetch does.
Build from source:
Run:Cord update install to install from crates.io or:Cord update build to build from source locally.

🎨 Themes

Cord features over 120 meticulously crafted icons available in distinct themes:

Default: A stylish theme inspired by Nerd Fonts icons.
Atom: A sleek theme inspired by Atom Material Icons.
Catppuccin: A soothing pastel theme inspired by Catppuccin.
Classic: A clean theme featuring widely recognized icons.

See theshowcase for a visual comparison.

Tip

Each theme includes multiple flavors, typicallydark,light, andaccent, representing the background color of the icons.Choose your theme in thedisplay configuration option. More themes are coming soon!

❤️ Support the Project

I'm the sole maintainer of cord.nvim and dedicate much of my free time to this project. If you find Cord helpful, you can show your support by giving the repo a star orsponsoring me on GitHub. Every bit of support helps me continue to improve and maintain Cord for everyone. Thank you!

💬 Questions? Post inDiscussions or reach me out on Discord:vyfor