You signed in with another tab or window.Reload to refresh your session.You signed out in another tab or window.Reload to refresh your session.You switched accounts on another tab or window.Reload to refresh your session.Dismiss alert
Here are some common questions about cord.nvim that nobody asked, yet we answered anyway. If you don't find your answer here or in the[Troubleshooting Guide](./Troubleshooting.md), don't hesitate to ask in our[Discord community](https://discord.gg/q9rC4bjCHv) or[GitHub Discussions](https://github.com/vyfor/cord.nvim/discussions)!
3
+
Some common questions about cord.nvim that nobody asked, yet we answered anyway. If you don't find your answer here or in the[Troubleshooting Guide](./Troubleshooting.md), don't hesitate to ask in our[Discord community](https://discord.gg/q9rC4bjCHv) or[GitHub Discussions](https://github.com/vyfor/cord.nvim/discussions)!
4
4
5
5
>###Q: What is the minimum required version of Neovim?
6
6
7
-
Cord istested with Neovim**0.6.0** orlater. Although, we encourage you to use the latest stable version of Neovim, as it provides the best experience and performance. However, if you're running an older version, and find that Cord is not working as expected, please open an issue and we'll try to help you out.
7
+
Cord iscompatible with Neovim**0.6.0** ornewer.
8
8
9
9
>###Q: Do I need to install Rust to use Cord?
10
10
11
-
Nope, you don't need Rust anymore! Cord will automatically download the necessary server binary from GitHub. If you want to build the binary from source, refer to[this](./Build.md) page.
11
+
No, you don't need Rust anymore.
12
+
Cord will download the server binary for you.
13
+
If you'd rather build it yourself, check the[Build guide](./Build.md).
12
14
13
15
>###Q: How to see the logs?
14
16
15
-
There are two ways to see logs:
17
+
You can check the logs in two ways:
16
18
17
-
1.Pass in the desiredlog levelto the`log_level` fieldin yourconfiguration. Logs at that level andabove willbe output to`:messages`.
19
+
1.Set alog level in yourconfig. Messages at that level(andhigher) willshow up in`:messages`.
18
20
19
21
```lua
20
22
require'cord'.setup {
21
23
log_level='...'-- one of 'trace', 'debug', 'info', 'warn', 'error'
22
24
}
23
25
```
24
26
25
-
2. Set the`CORD_LOG_FILE` environment variable to a file path. Thiswill redirect alllogs tothat file. This is useful for debugging as trace and debug logs can be very verbose and overwhelming in the editor.
27
+
2. Set the`CORD_LOG_FILE` environment variable to a file path. Thissaveslogs toa file instead of spamming your editor, which is especially useful when using`trace` or`debug` levels.
26
28
27
29
>[!NOTE]
28
-
>If you were asked to provide logs as part of an issue, you should enable verbose logging via`log_level = 'trace'` and set`CORD_LOG_FILE`env var. Use of relative paths is allowed, e.g.`export CORD_LOG_FILE="./cord.log"`. The log file gets cleared at plugin startup, so keep that in mind.
30
+
>If you were asked to provide logs as part of an issue, you should enable verbose logging via`log_level = 'trace'` and set`CORD_LOG_FILE`environment variable. Use of relative paths is allowed, e.g.`export CORD_LOG_FILE="./cord.log"`. The log file gets cleared at plugin startup, so keep that in mind.
29
31
30
32
>###Q: Can I use a custom name in my Rich Presence?
31
33
32
-
Yes, you will have to create an application with the desired name in the[Discord Developer Portal](https://discord.com/developers/applications).
33
-
Then, copythe application ID and put it in the`editor.client` field in your`cord.nvim` configuration.
34
+
To do this, you will have to create an application with the desired name in the[Discord Developer Portal](https://discord.com/developers/applications).
35
+
Then, copyits application ID and put it in the`editor.client` field:
34
36
35
-
Example:
36
37
```lua
37
38
require'cord'.setup {
38
39
editor= {
@@ -43,24 +44,40 @@ require 'cord'.setup {
43
44
44
45
>###Q: Why do I still see Cord's server running in background, even after I've closed Neovim?
45
46
46
-
Cord's server keeps running intentionally. In fact, this is one of the key design features that sets it apart from similar plugins. It remains active in the background to maintain a continuous connection to Discord, which helps avoid hitting Discord's rate limits on reconnections, especially useful if you often restart Neovim rather than maintaining a single long session. If you prefer not to have it running, you can adjust the`advanced.server.timeout` setting.
47
+
That's intentional.
48
+
Cord's server keeps running to maintain a single continuous connection to Discord and avoid hitting rate limits from reconnecting too often.
49
+
This is especially useful if you restart Neovim a lot.
50
+
If you'd rather shut it down sooner, there's the`advanced.server.timeout` option.
47
51
48
52
>###Q: I'm using a custom Discord client. Will Cord work with it?
Cord detects different buffers based on their filetype, and occasionally their filename. See the list of supported filetypes[here](https://github.com/vyfor/cord.nvim/blob/master/lua/cord/plugin/activity/mappings.lua). If it's not listed, it usually means one of two things:
55
-
- It has not been added yet — feel free to[open an issue](https://github.com/vyfor/cord.nvim/issues/new/choose) and we'll add it.
56
-
- It cannot be detected:
57
-
-*Languages* that cannot be detected by filetype or filename alone, have to be configured to be detectable, as explained in[here](https://github.com/vyfor/cord.nvim/wiki/Assets#-tip).
58
-
-*Plugins* are required to override current buffer's`filetype`, or otherwise Cord will not be able to detect it.
58
+
Cord detects buffers mostly by filetype (and sometimes by filename).
59
+
Check the list of supported filetypes[here](https://github.com/vyfor/cord.nvim/blob/master/lua/cord/plugin/activity/mappings.lua).
60
+
61
+
62
+
If the language or plugin you use isn't found on the list, please[open an issue](https://github.com/vyfor/cord.nvim/issues/new/choose).
63
+
64
+
Just keep in mind:
65
+
-**Languages** that don't expose a clear filetype or filename need extra setup (see[this page](https://github.com/vyfor/cord.nvim/wiki/Assets#-tip)).
66
+
-**Plugins** need to override the buffer's`filetype`, otherwise Cord won't be able to recognize them.
59
67
60
68
>###Q: Rich Presence updates take a long time to appear in Discord. Why?
61
69
62
-
Rich Presence updates now take longer to appear because Discord enforces a rate limit on how frequently these updates can be sent. Originally, Discord's documentation allowed one update every 15 seconds—a limit that mostly affected mobile and web clients while desktop users saw instantaneous changes. However, after a recent overhaul of Discord's rich presence interface, this, or a similar rate limit appears to be strictly applied across all platforms, causing the delays you're noticing. From my point of view, this rate limit is ridiculously high, and should be drastically reduced. Perhaps a collaborative effort from the community could make them reconsider their decision, but there's nothing I can do on my end, I'm afraid. See the relevant[discussion](https://github.com/vyfor/cord.nvim/discussions/196).
70
+
After the recent update, Discord started to*properly* rate-limit how often your Rich Presence can update. The exact numbers aren't known yet.
71
+
72
+
73
+
Not caused by Cord.
74
+
See the[discussion](https://github.com/vyfor/cord.nvim/discussions/196) for details.
63
75
64
76
>###Q: Why can't I disable timestamps in my Rich Presence? Why are they misbehaving?
65
77
66
-
It used to work as expected, but I suspect that Discord introduced a bug in recent updates. When you omit timestamps in your activity payload, the absence of a timer is expected at first. However, within seconds the timer reappears and resets to zero on every new activity update. In my testing, this reappearance has been inconsistent—sometimes happening immediately, and other times after a couple of seconds. Interestingly, during the brief period without the timer, updates go through instantly without any apparent rate limiting on the client side. This behavior appears to be due to changes in how Discord handles rich presence updates internally, rather than an issue with the plugin itself. See the relevant[discussion](https://github.com/vyfor/cord.nvim/discussions/196#discussioncomment-12221577).
78
+
Disabling timestamps was previously possible but Discord appears to have introduced a bug.
79
+
If you omit the timestamp now, it starts to misbehave, with the timer initially briefly disappearing but then reappearing and resetting to zero whenever the activity updates. No can do on our end.
80
+
81
+
82
+
Not caused by Cord.
83
+
See the[discussion](https://github.com/vyfor/cord.nvim/discussions/196#discussioncomment-12221577) for details.