🧩 Cord – Tailor Your Presence Like Never Before

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

[!IMPORTANT] Cord no longer requires Rust to be installed. Rust component will be automatically downloaded from GitHub Releases.

💎 Features

• 🌐 Client-Server Design — Handles multiple Neovim instances with a single connection to Discord.

• ⚡ Performance in Mind — Lightweight, dependency-free, with blazingly-fast startup.

• 🚀 Event-Driven Architecture — Instant presence updates with zero delays.

• 🎨 Customizable Templates — Dynamic string templates with custom variables.

• 🔧 Unmatched Configurability — Function-based configuration for infinite customization possibilities.

• 🧠 Automated State Handling — Automatically manages activities across all instances.

• 💤 Smart Idle Detection — Identifies idle sessions and switches to the most recent non-idle session.

• 🛠️ Built-in Git Integration — Detects repositories and workspaces based on VCS files without relying on command-line tools.

• 🗃️ Custom Assets — Extendable with fully customizable assets for any file/buffer type.

• ⚙️ Robust User Commands - Quickly manage Cord and its features through user commands and easily create your own keybindings.

• 🔌 Plugin System — Extendable with custom plugins, with a plethora of built-in ones out of the box.

• 📦 Wide Compatibility - Compatible with various Discord installations (Snap, Flatpak) and able to work inside WSL and Discord in browser.

• 🌍 Cross-Platform — Supports Windows, Linux, macOS, and FreeBSD.

• 🌸 Rich Icon Collection — Features 120+ uniquely designed themed icons for 200+ file types and plugins.

• 🔁 Automatic Reconnection — Able to reconnect to Discord if the connection is lost.

📦 Quick Start

For most users, the quickest way to get started is by using lazy.nvim:

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

Considerations

Installation

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

:Rocks install cord.nvim

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

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

🎨 Themes

Cord boasts over 120 meticulously crafted icons for languages and tools, available in distinct themes to match your style.

👉 Explore the Icon Showcase: vyfor/icons

Cord currently offers three themes:

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

Each theme includes multiple flavors, typically dark, light, and accent. Choose your theme in the display configuration option. More themes are coming soon!

📖 Documentation

Full documentation is available in the Wiki:

• 📘 Configuration Guide
• 💡 Examples
• ❓ FAQ
• 🚑 Troubleshooting Guide

📜 Versioning

• PATCH: Non-breaking changes.
• MINOR: Breaking changes.
• MAJOR: Significant rewrites or fundamental shifts, bumped manually.

All breaking changes will be announced in GitHub Discussions.

🤝 Contributing

We welcome contributions to make Cord even better!

• Check out our Contribution Guidelines.

❤️ 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 or sponsoring me on GitHub. Every bit of support helps me continue to improve and maintain Cord for everyone. Thank you!

🛠️ Build From Source

[!NOTE] Make sure you have Rust >= 1.85.0 (nightly) installed.

To build Cord from source, you can run :Cord update build (async) which will install the server binary from crates.io by running the following command:

cargo install --path . --root path/to/nvim-data-dir/cord --force

Alternatively, you can use cargo b --release to build the binary, then place it under nvim-data-dir/cord/bin.

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