Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commit1aadec4

Browse files
committed
docs(faq): rewrite the faq
1 parentc7d08c1 commit1aadec4

File tree

1 file changed

+35
-18
lines changed

1 file changed

+35
-18
lines changed

‎.github/wiki/FAQ.md‎

Lines changed: 35 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,39 @@
11
##❓ FAQ
22

3-
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)!
44

55
>###Q: What is the minimum required version of Neovim?
66
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.
88

99
>###Q: Do I need to install Rust to use Cord?
1010
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).
1214

1315
>###Q: How to see the logs?
1416
15-
There are two ways to see logs:
17+
You can check the logs in two ways:
1618

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`.
1820

1921
```lua
2022
require'cord'.setup {
2123
log_level='...'-- one of 'trace', 'debug', 'info', 'warn', 'error'
2224
}
2325
```
2426

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.
2628

2729
>[!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.
2931
3032
>###Q: Can I use a custom name in my Rich Presence?
3133
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:
3436

35-
Example:
3637
```lua
3738
require'cord'.setup {
3839
editor= {
@@ -43,24 +44,40 @@ require 'cord'.setup {
4344

4445
>###Q: Why do I still see Cord's server running in background, even after I've closed Neovim?
4546
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.
4751

4852
>###Q: I'm using a custom Discord client. Will Cord work with it?
4953
5054
See[Special Environments](./Special-Environments.md#-custom-discord-clients).
5155

5256
>###Q: Is X plugin or X language supported?
5357
54-
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.
5967

6068
>###Q: Rich Presence updates take a long time to appear in Discord. Why?
6169
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.
6375

6476
>###Q: Why can't I disable timestamps in my Rich Presence? Why are they misbehaving?
6577
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.

0 commit comments

Comments
 (0)

[8]ページ先頭

©2009-2025 Movatter.jp