@chojs23/concord 2.4.8 → 2.5.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -2,7 +2,88 @@
2
2
 
3
3
  All notable changes to this project will be documented in this file.
4
4
 
5
- ## [2.4.8] - 2026-07-27
5
+ ## [2.5.1] - 2026-08-02
6
+
7
+ ### Bug Fixes
8
+
9
+ - _(stream)_ Fix Windows broadcasts stopping when captured content outgrows the D3D11 frame pool by @chojs23
10
+ - Unify stream toggle command naming by @chojs23
11
+ - _(test)_ Fix no-default-features build by @chojs23
12
+ - _(stream)_ Fix stream freezes caused by backward audio RTP timestamps (#289) in [#289](https://github.com/chojs23/concord/pull/289) by @chojs23
13
+ - _(nix)_ Patch PipeWire bindgen fallbacks for immutable vendor sources (#292) in [#292](https://github.com/chojs23/concord/pull/292) by @chojs23
14
+ - Filter muted channel in inbox (#293) in [#293](https://github.com/chojs23/concord/pull/293) by @chojs23
15
+
16
+ ### Documentation
17
+
18
+ - Update readme by @chojs23
19
+ - Add gentoo installation instructions to README (#286) in [#286](https://github.com/chojs23/concord/pull/286) by @darwincereska
20
+ - Update README by @chojs23
21
+
22
+ ### Features
23
+
24
+ - _(voice)_ Add selectable input and output audio sources (#287) in [#287](https://github.com/chojs23/concord/pull/287) by @chojs23
25
+
26
+ ### Miscellaneous Tasks
27
+
28
+ - Update descriptions and docs by @chojs23
29
+
30
+ ### New Contributors
31
+
32
+ - @darwincereska made their first contribution in [#286](https://github.com/chojs23/concord/pull/286)
33
+
34
+ ## [2.5.0] - 2026-08-01
35
+
36
+ ### Bug Fixes
37
+
38
+ - _(stream)_ Require exact Linux audio monitor by @chojs23
39
+ - _(ci)_ Install Linux capture dependencies by @chojs23
40
+ - _(stream)_ Cancel watch session child tasks by @chojs23
41
+ - _(voice)_ Await runtime cleanup before gateway stop by @chojs23
42
+ - _(stream)_ Rotate active RTC servers by @chojs23
43
+ - _(stream)_ Bound broadcast reconnect attempts by @chojs23
44
+ - _(stream)_ Centralize lifecycle completion events by @chojs23
45
+ - _(stream)_ Redact RTC tokens from debug output by @chojs23
46
+ - _(stream)_ Allow restarting fullscreen broadcasts on Windows by @chojs23
47
+ - Add cross-platform application audio capture for stream broadcasts by @chojs23
48
+ - _(stream)_ Keep stalled capture joins outside Tokio by @chojs23
49
+ - _(stream)_ Back off stream watch reconnects by @chojs23
50
+ - _(broadcast)_ Remove screencapturekit by @chojs23
51
+ - _(broadcast)_ Replace xcap with native cross-platform screen capture backends by @chojs23
52
+ - _(stream)_ Prepare portal capture before creating Discord stream by @chojs23
53
+ - _(broadcast)_ Fix Linux broadcast restart and system audio latency by @chojs23
54
+ - _(broadcast)_ Fix Linux broadcast self-audio exclusion by @chojs23
55
+ - _(broadcast)_ Cancel stale capture preparation by @chojs23
56
+ - _(build)_ Require macOS 13 by @chojs23
57
+ - _(stream)_ Bound H264 assembly memory by @chojs23
58
+ - _(stream)_ Slow preview upload cadence by @chojs23
59
+ - _(broadcast)_ Derive audio clock from samples by @chojs23
60
+ - Fix stream startup and capture lifecycle issues by @chojs23
61
+ - _(voice)_ Reduce Linux PulseAudio voice playback latency by @chojs23
62
+ - Harden stream capture preparation lifecycle by @chojs23
63
+
64
+ ### Documentation
65
+
66
+ - Update readme by @chojs23
67
+
68
+ ### Features
69
+
70
+ - Watch and broadcast streaming by @chojs23
71
+ - Add live stream presence sounds and participant panel by @chojs23
72
+ - _(stream)_ Make stream feature optional by @chojs23
73
+ - _(broadcast)_ Broacasting ui by @chojs23
74
+ - Add broadcast preview by @chojs23
75
+
76
+ ### Miscellaneous Tasks
77
+
78
+ - _(ci)_ Update Linux CI and release runners to Ubuntu 24.04 by @chojs23
79
+
80
+ ### Refactor
81
+
82
+ - _(stream)_ Simplify live presence state by @chojs23
83
+ - _(stream)_ Share voice gateway control handling by @chojs23
84
+ - Refactor stream forwarding and reuse capture frame buffers by @chojs23
85
+
86
+ ## [2.4.8] - 2026-07-28
6
87
 
7
88
  ### Bug Fixes
8
89
 
package/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
  <img width="1613" height="848" alt="concord - a feature-rich TUI client for
4
4
  Discord" src="./docs/example.png" />
5
5
 
6
- Concord is a feature-rich TUI (terminal user interface) client for Discord, written in Rust with ratatui. Full Discord experience, right in your terminal.
6
+ Concord is a feature-rich TUI client for Discord, written in Rust with ratatui.
7
7
 
8
8
  ## Table of contents
9
9
 
@@ -18,125 +18,112 @@ Concord is a feature-rich TUI (terminal user interface) client for Discord, writ
18
18
 
19
19
  ## Installation
20
20
 
21
- ### Homebrew
21
+ Release builds include voice playback and stream broadcasting.
22
+
23
+ ### **Cargo**
22
24
 
23
25
  ```sh
24
- brew install concord
26
+ cargo install concord --locked
25
27
  ```
26
28
 
27
- Or with the tap for the latest version:
29
+ Cargo installations compile Concord locally and require the build dependencies
30
+ listed below.
31
+
32
+ ### **Homebrew**
28
33
 
29
34
  ```sh
35
+ brew install concord
36
+
37
+ # or install the latest release from tap
30
38
  brew install chojs23/tap/concord
31
39
  ```
32
40
 
33
- ### npm
41
+ ### **npm**
34
42
 
35
43
  ```sh
36
44
  npm install -g @chojs23/concord
37
45
  ```
38
46
 
39
- You can also run Concord without a global install:
47
+ ### **Nix**
40
48
 
41
49
  ```sh
42
- npx @chojs23/concord
43
- ```
44
-
45
- The npm package installs a prebuilt binary from the GitHub Release artifacts.
46
-
47
- ### Cargo
48
-
49
- Install native dependencies first.
50
-
51
- On macOS with Homebrew:
50
+ # nixpkgs
51
+ nix profile install nixpkgs#concord-tui
52
52
 
53
- ```sh
54
- brew install opus pkg-config
53
+ # Latest GitHub release
54
+ nix profile install github:chojs23/concord
55
55
  ```
56
56
 
57
- On Fedora:
57
+ ### **Gentoo**
58
58
 
59
- ```sh
60
- sudo dnf install opus-devel alsa-lib-devel pkgconf-pkg-config
61
- ```
59
+ This package is maintained by a community contributor and is not yet available in Gentoo GURU.
62
60
 
63
- On Debian or Ubuntu:
64
-
65
- ```sh
66
- sudo apt install libopus-dev libasound2-dev pkg-config
67
- ```
61
+ Install the `darwincereska` overlay:
68
62
 
69
63
  ```sh
70
- cargo install concord --locked
64
+ eselect repository add darwincereska git https://codeberg.org/darwincereska/gentoo-overlay.git
65
+ emaint sync -r darwincereska
66
+ emerge -av net-im/concord
71
67
  ```
72
68
 
73
- To install without local voice playback and microphone support:
74
-
75
- ```sh
76
- cargo install concord --locked --no-default-features
77
- ```
69
+ ### Prebuilt releases
78
70
 
79
- To install the latest unreleased version directly from the Git repository:
71
+ Download an archive for Linux, macOS, or Windows from the
72
+ [latest GitHub release](https://github.com/chojs23/concord/releases/latest), or
73
+ run the release installer:
80
74
 
81
75
  ```sh
82
- cargo install --locked --git https://github.com/chojs23/concord
76
+ curl --proto '=https' --tlsv1.2 -LsSf https://github.com/chojs23/concord/releases/latest/download/concord-installer.sh | sh
83
77
  ```
84
78
 
85
- ### Nix
86
-
87
- Install the packaged release from nixpkgs:
88
-
89
- ```sh
90
- nix profile install nixpkgs#concord-tui
79
+ ```powershell
80
+ powershell -ExecutionPolicy Bypass -c "irm https://github.com/chojs23/concord/releases/latest/download/concord-installer.ps1 | iex"
91
81
  ```
92
82
 
93
- Run the packaged release without installing:
83
+ The installer places `concord` under `$CARGO_HOME/bin`.
94
84
 
95
- ```sh
96
- nix run nixpkgs#concord-tui
97
- ```
85
+ ### Runtime requirements
98
86
 
99
- Run the latest release without installing (requires flakes enabled):
87
+ macOS 13 or later is required. Linux release builds need these packages:
100
88
 
101
89
  ```sh
102
- nix run github:chojs23/concord
103
- ```
90
+ # Fedora
91
+ sudo dnf install alsa-lib opus pipewire-libs xdg-desktop-portal
104
92
 
105
- Install into your profile:
93
+ # Debian or Ubuntu
94
+ sudo apt install libasound2 libopus0 libpipewire-0.3-0 xdg-desktop-portal
106
95
 
107
- ```sh
108
- nix profile install github:chojs23/concord
96
+ # Arch Linux
97
+ sudo pacman -S alsa-lib opus pipewire xdg-desktop-portal
109
98
  ```
110
99
 
111
- Or add the flake as an input in your own `flake.nix`:
100
+ Screen sharing requires the portal backend for your desktop environment.
112
101
 
113
- ```nix
114
- {
115
- inputs.concord.url = "github:chojs23/concord";
116
- }
117
- ```
102
+ ### Build from source
118
103
 
119
- ### GitHub Release installer
104
+ <details>
105
+ <summary>Build dependencies and commands</summary>
120
106
 
121
- Install the latest release with the cargo-dist shell installer:
107
+ Install the Rust stable toolchain and the native dependencies for your platform:
122
108
 
123
109
  ```sh
124
- curl --proto '=https' --tlsv1.2 -LsSf https://github.com/chojs23/concord/releases/latest/download/concord-installer.sh | sh
125
- ```
126
-
127
- On Windows, use the PowerShell installer instead:
110
+ # macOS
111
+ xcode-select --install
112
+ brew install opus pkg-config
113
+ brew install nasm # Intel only
128
114
 
129
- ```powershell
130
- powershell -ExecutionPolicy Bypass -c "irm https://github.com/chojs23/concord/releases/latest/download/concord-installer.ps1 | iex"
131
- ```
115
+ # Fedora
116
+ sudo dnf install alsa-lib-devel clang-devel gcc gcc-c++ nasm opus-devel pipewire-devel pkgconf-pkg-config
132
117
 
133
- The installer places `concord` under `$CARGO_HOME/bin`, which is usually
134
- `~/.cargo/bin` on Unix and `%USERPROFILE%\.cargo\bin` on Windows.
118
+ # Debian or Ubuntu
119
+ sudo apt install build-essential libasound2-dev libclang-dev libopus-dev libpipewire-0.3-dev nasm pkg-config
135
120
 
136
- ### Build from source
121
+ # Arch Linux
122
+ sudo pacman -S alsa-lib base-devel clang nasm opus pipewire pkgconf
123
+ ```
137
124
 
138
- You need the Rust stable toolchain, Cargo, and the native dependencies listed in
139
- the Cargo install section.
125
+ Windows source builds require the MSVC Rust toolchain, Visual Studio 2022 Build
126
+ Tools with Desktop development with C++, CMake, and NASM.
140
127
 
141
128
  ```sh
142
129
  git clone https://github.com/chojs23/concord.git
@@ -144,27 +131,21 @@ cd concord
144
131
  cargo build --release
145
132
  ```
146
133
 
147
- The release binary is produced at:
134
+ To keep voice support without stream broadcasting:
148
135
 
149
136
  ```sh
150
- target/release/concord
137
+ cargo build --release --no-default-features --features voice-playback
151
138
  ```
152
139
 
153
- To build without local voice playback and microphone support, disable default features:
140
+ To build without local voice playback, microphone, or stream broadcasting:
154
141
 
155
142
  ```sh
156
143
  cargo build --release --no-default-features
157
144
  ```
158
145
 
159
- On WSLg, audio is usually exposed through PulseAudio instead of a real ALSA
160
- sound card. If playback does not start, check that PulseAudio and ALSA routing
161
- work before debugging Discord voice itself:
146
+ The same feature flags can be passed to `cargo install concord --locked`.
162
147
 
163
- ```sh
164
- pactl info
165
- paplay /usr/share/sounds/alsa/Front_Center.wav
166
- aplay -D pulse /usr/share/sounds/alsa/Front_Center.wav
167
- ```
148
+ </details>
168
149
 
169
150
  ## Features
170
151
 
@@ -181,28 +162,21 @@ By default, tokens are saved in the system keychain when available. In the
181
162
  default `auto` mode, Concord falls back to its state directory when keychain
182
163
  storage is unavailable. See the Security section below for details.
183
164
 
184
- To sign out with the default keys, open your profile with `Space`, `p`, then
185
- choose `[o] sign out`.
186
-
187
165
  ### Voice calls
188
166
 
189
- - Full voice support with push-to-talk
190
- - Supports noise suppression
167
+ - Voice calls with push-to-talk
168
+ - Noise suppression
169
+ - Watch and broadcast screen shares
191
170
 
192
171
  ### Guilds & Channels
193
172
 
194
- - Navigate text channels, threads, and forum channels
195
173
  - View, filter, and create forum/media posts (active / archived)
196
174
  - Switch channels, threads, and posts with the fuzzy channel switcher (`Space`, `Space`)
197
- - Track unread messages and mention counts per channel
198
- - Mute and unmute channels and servers
199
175
 
200
176
  ### Messaging
201
177
 
202
- - Send, edit, and delete messages
203
- - Upload / Download attachments
204
- - Search messages with filters with `/`
205
- - @mention autocomplete
178
+ - Search messages with filters using `/`
179
+ - `@mention` autocomplete
206
180
  - Send custom emoji your account cannot use directly as image links when enabled
207
181
  - Rich content display (embeds, attachments, stickers, and mentions)
208
182
  - Detect URLs in message bodies and markdown links, then open them in your default browser
@@ -220,13 +194,7 @@ Concord renders a practical subset of Discord-style Markdown in message bodies:
220
194
  - Fenced code blocks with optional language labels, rendered as compact boxes with syntax highlighting
221
195
  - Raw URLs and markdown link destinations are underlined and can be opened from message actions
222
196
 
223
- ### Reactions & Polls
224
-
225
- - View, add, and remove emoji reactions (Unicode and custom server emoji)
226
- - Use custom emoji from other servers as reactions when your account supports it
227
- - View and vote on polls
228
-
229
- ### Media & Images
197
+ ### Media Support
230
198
 
231
199
  Image rendering is powered by [ratatui-image](https://github.com/benjajaja/ratatui-image). On startup, Concord queries the terminal to detect the best available graphics protocol. Supported protocols:
232
200
 
@@ -235,37 +203,27 @@ Image rendering is powered by [ratatui-image](https://github.com/benjajaja/ratat
235
203
  - **Sixel** - foot, mlterm, xterm (if compiled with Sixel support), etc.
236
204
  - **Halfblocks** (fallback) - works on any terminal, but uses block characters instead of true pixels.
237
205
 
238
- Checkout [compatibility-matrix](https://github.com/ratatui/ratatui-image#compatibility-matrix) for a list of terminals that support each protocol.
206
+ Check the [compatibility matrix](https://github.com/ratatui/ratatui-image#compatibility-matrix) for terminals that support each protocol.
239
207
 
240
- You can toggle image viewing on or off in the configuration file. When image viewing is off, attachments and emojis will be shown as text placeholders.
241
-
242
- Video and audio playback uses [mpv](https://mpv.io/). Make sure `mpv` is installed and in your PATH.
208
+ External media playback is off by default. You can enable it with Display options menu.
209
+ Video and audio playback, including live streams, uses [mpv](https://mpv.io/). Make sure `mpv` is installed and in your PATH.
243
210
  YouTube playback depends on your local `mpv` setup, such as `yt-dlp` support.
244
- External media playback is off by default. You can enable it with
245
- `media_playback = true` under `[display]`, or toggle it from the in-app Display
246
- options menu.
247
-
248
- ### Members & Profiles
249
211
 
250
- - View Member list and search members
251
- - Presence indicators (Online, Idle, DND, Offline)
252
- - Configure user profile and rich presence activity
212
+ To broadcast, join a voice channel, open its channel actions, choose
213
+ `Share screen` or use `<leader>vs` voice shortcut.
214
+ Linux screen capture depends on the active X11 or Wayland support.
253
215
 
254
- #### Rich Presence
216
+ ### Rich Presence
255
217
 
256
218
  - Concord serves the local `discord-ipc` socket, detects connected apps, and
257
219
  lets you pick which one to share from your profile's activity picker
258
220
  - Only apps that speak Discord's Rich Presence (RPC/IPC) protocol are detected.
259
- - Detection needs the official Discord client closed, since only one program can
260
- own the socket and the official client claims it first
261
221
  - Toggle with `share_rich_presence` under `[presence]` in `config.toml`
262
222
 
263
223
  ### Notifications
264
224
 
265
225
  - Notification inbox (`<leader>n`) with Unreads and Mentions tabs.
266
- - You can configure notification sounds with custom WAV files
267
- - Desktop notifications for messages that pass your Discord
268
- notification settings
226
+ - Custom notification sounds using WAV files
269
227
  - Voice join and leave notification sounds while you are connected to voice
270
228
 
271
229
  ### Navigation & Keyboard shortcuts
@@ -273,11 +231,7 @@ options menu.
273
231
  > ⚠️ Keymap action names and default bindings may have breaking changes between releases.
274
232
 
275
233
  All default key settings in this section can be customized. See
276
- [Keymap options](./docs/keymap-options.md) for the config format and supported
277
- actions.
278
-
279
- Concord has a four-pane.
280
- **Guilds (1)**, **Channels (2)**, **Messages (3)**, **Members (4)**
234
+ [Keymap options](./docs/keymap-options.md) for the config and supported actions.
281
235
 
282
236
  With default vim-style navigation:
283
237
 
@@ -315,151 +269,59 @@ Press `Space` to open the leader shortcut window.
315
269
  | `Space`, `p` | Open my profile settings |
316
270
  | `Space`, `o` | Choose concord option category |
317
271
  | `Space`, `n` | Open the notification inbox |
318
- | `Space`, `v` | Voice command prefix |
272
+ | `Space`, `v` | Open voice shortcuts |
319
273
  | `Space`, `Space` | Open the fuzzy channel switcher |
320
274
 
321
- #### Action menus
275
+ #### Message shortcuts
322
276
 
323
- Focus a pane, then press `Space`, `a` to open actions for that pane. Actions
324
- that do not apply to the current selection are shown dimmed and disabled. In
325
- the Messages pane, the selected message also supports these direct shortcuts:
326
-
327
- Message shortcuts:
328
-
329
- | Shortcut | Action | Description |
330
- | -------- | ------------------- | ----------------------------------------------------------- |
331
- | `y` | Copy | Copy the selected message text and show a short toast |
332
- | `r` | Add/remove reaction | Open the reaction picker for the selected message |
333
- | `R` | Reply | Start a reply to the selected message |
334
- | `d` | Delete | Open a delete confirmation before deleting the message |
335
- | `e` | Edit | Start editing the selected message when editing is allowed |
336
- | `o` | Open URL | Open the selected message URL, or choose from multiple URLs |
337
- | `x` | Play media | Play selected video or audio media in an external player |
338
- | `v` | View attachment | Open the selected message's attachment viewer |
339
-
340
- Message action menu shortcuts:
341
-
342
- | Shortcut | Action | Description |
343
- | -------- | --------------------------- | ----------------------------------------------------------- |
344
- | `y` | Copy | Copy the selected message text and show a short toast |
345
- | `r` | Add/remove reaction | Open the reaction picker for the selected message |
346
- | `R` | Reply | Start a reply to the selected message |
347
- | `d` | Delete | Open a delete confirmation before deleting the message |
348
- | `e` | Edit | Start editing the selected message when editing is allowed |
349
- | `o` | Open URL | Open the selected message URL, or choose from multiple URLs |
350
- | `D` | Remove embeds | Remove embeds from the selected message |
351
- | `x` | Play media | Play selected video or audio media in an external player |
352
- | `v` | View attachment | Open the selected message's attachment viewer |
353
- | `g` | Go to referenced message | Go to the replied or forwarded message |
354
- | `p` | show message sender profile | Open the selected message author's profile |
355
- | `P` | Pin / unpin | Open a pin or unpin confirmation for the selected message |
356
- | `t` | Open thread | Open the selected message's thread |
357
- | `u` | Show reacted users | Show users who reacted to the selected message |
358
- | `c` | Choose poll votes | Choose poll votes for the selected message |
359
-
360
- When the attachment viewer is open, press `x` to play the current video or audio attachment
361
- in an external player, or `d` to download the current attachment directly.
362
-
363
- Server actions:
364
-
365
- | Shortcut | Action | Description |
366
- | -------- | ------------------- | ----------------------------------------------------- |
367
- | `m` | Mark server as read | Mark all unread viewable channels in this server read |
368
- | `u` | Mute / unmute | Toggle server notification mute |
369
- | `l` | Leave server | Open a confirmation before leaving this server |
370
- | `r` | Folder settings | Edit the selected server folder name and color |
371
-
372
- Channel actions:
373
-
374
- | Shortcut | Action | Description |
375
- | -------- | -------------------- | -------------------------------------------- |
376
- | `e` | Join voice | Join the selected voice channel or DM call |
377
- | `l` | Leave voice | Leave the current voice channel or DM call |
378
- | `a` | Audio settings | Set participant volume or mute |
379
- | `p` | Show pinned messages | Open the selected channel's pinned messages |
380
- | `t` | Show threads | List threads for the selected channel |
381
- | `m` | Mark as read | Mark the selected channel read |
382
- | `u` | Mute / unmute | Toggle channel or category notification mute |
383
-
384
- Thread / post actions (a focused thread in the Channels pane or a forum post in the post list):
385
-
386
- | Shortcut | Action | Description |
387
- | -------- | --------------------- | ----------------------------------------------------------- |
388
- | `m` | Mark as read | Mark the thread or post read |
389
- | `f` | Follow / unfollow | Follow or unfollow the thread or post |
390
- | `c` | Close / reopen | Close or reopen the thread or post (author or moderator) |
391
- | `l` | Lock / unlock | Lock or unlock the thread or post (moderator) |
392
- | `e` | Edit | Edit title, tags, slow mode, and auto-archive |
393
- | `y` | Copy link | Copy a link to the thread or post |
394
- | `u` | Mute / unmute | Toggle thread or post notification mute (must follow first) |
395
- | `n` | Notification settings | Choose the notification level for the thread or post |
396
- | `P` | Pin / unpin | Pin or unpin the post (forum posts only, moderator) |
397
- | `d` | Delete | Delete the whole thread or post (moderator) |
398
- | `i` | Copy ID | Copy the thread or post ID |
399
-
400
- Voice commands:
401
-
402
- | Sequence | Action | Description |
403
- | ----------------- | ------------ | ----------------------------------------- |
404
- | `Space`, `v`, `d` | Deafen voice | Toggle Concord's Discord voice deaf state |
405
- | `Space`, `v`, `m` | Mute voice | Toggle Concord's Discord voice mute state |
406
- | `Space`, `v`, `l` | Leave voice | Leave the current Concord voice channel |
277
+ These shortcuts act on the selected message when the Messages pane is focused.
407
278
 
408
- #### Composer
409
-
410
- You can paste copied files into the composer to attach them. Pending uploads
411
- are shown above the input before sending.
279
+ | Key | Action |
280
+ | --- | -------------------------- |
281
+ | `y` | Copy message text |
282
+ | `r` | Add or remove a reaction |
283
+ | `R` | Reply |
284
+ | `d` | Delete |
285
+ | `e` | Edit |
286
+ | `o` | Open URL |
287
+ | `x` | Play video or audio |
288
+ | `v` | Open the attachment viewer |
412
289
 
413
- In a forum or media parent channel, the same composer key opens a post composer
414
- overlay.
290
+ #### Action menus
415
291
 
416
- | Shortcut | Action | Description |
417
- | -------------------------------------------- | ----------------- | ---------------------------------------------------------------- |
418
- | `Ctrl+v` | paste clipboard | Attach copied files or images when present, otherwise paste text |
419
- | `Ctrl+e` | open $EDITOR | Open $EDITOR on the current draft for long editing |
420
- | `Ctrl+c` | clear | Clear current draft |
421
- | `Ctrl+Left`/ `Ctrl+Right` | Jump word | Jump the cursor by word |
422
- | `Alt+Backspace`, `Ctrl+Backspace` / `Ctrl+w` | Delete word | Delete the word before the cursor |
423
- | `Ctrl+u` / `Ctrl+k` | Delete line text | Delete from cursor to start/end of the current line |
424
- | `Delete` | Detach attachment | Removes the last pending attachment |
425
- | `Alt+p` | Toggle reply ping | Toggle whether replying pings the original author |
292
+ Press `Space`, `a` to open actions for the focused pane. The menu shows the
293
+ available shortcuts and dims actions that do not apply to the current
294
+ selection.
426
295
 
427
- #### Mention picker
296
+ #### Composer
428
297
 
429
- When the @mention picker is open, use `Up` / `Down`,
430
- `Ctrl+p` / `Ctrl+n`, `Tab`, or `Enter` to choose a mention.
298
+ The composer supports copied file attachments and editing the current draft in
299
+ `$EDITOR`. Pending uploads appear above the input before sending.
431
300
 
432
301
  #### Emoji picker
433
302
 
434
- Type `:` plus at least two letters, such as `:he`, to pick Unicode, server, or
435
- cross-server custom emoji while writing a message.
303
+ Supports searching and selecting emoji with the picker. Press `:` to open the
304
+ picker, then type to filter.
436
305
 
437
306
  When `emojis_as_links` is enabled, custom emoji your account cannot send
438
307
  directly are inserted as Discord image links instead.
439
308
 
440
- To react from the composer, select a message, enter insert mode, then type
441
- `+:`. The reaction picker opens for that message. Press `/` to search, Enter to
442
- lock the filter, then Enter again or use a shown shortcut to react.
443
-
444
309
  #### Bot commands
445
310
 
446
- When the composer input starts with a slash `/`, the command suggestion popup
311
+ When the composer input starts with `/`, Concord shows available application
312
+ commands.
447
313
 
448
314
  ## Configuration
449
315
 
450
- Concord options are stored under Concord's config directory. If
451
- `XDG_CONFIG_HOME` is set, Concord uses `config.toml` for app options, `keymap.toml` for key settings, and `theme.toml` for colors.
452
- Otherwise it uses the platform config directory.
316
+ Concord reads `config.toml`, `keymap.toml`, and `theme.toml` from
317
+ `$XDG_CONFIG_HOME/concord` when `XDG_CONFIG_HOME` is set, or from the platform
318
+ config directory otherwise.
453
319
 
454
- Local UI state and plaintext fallback credentials are stored under Concord's
455
- state directory instead. If `XDG_STATE_HOME` is set, Concord uses
456
- `$XDG_STATE_HOME/concord/state.toml` and
457
- `$XDG_STATE_HOME/concord/credentials.toml`. Otherwise it uses
458
- `~/.local/state/concord/state.toml` and
459
- `~/.local/state/concord/credentials.toml`.
320
+ Machine-local UI state and fallback credentials are stored in
321
+ `$XDG_STATE_HOME/concord`, or in `~/.local/state/concord` when
322
+ `XDG_STATE_HOME` is not set.
460
323
 
461
- You can change some configuration from the in-app Options menu, and Concord saves them back
462
- to `config.toml`. Key settings are read from `keymap.toml`, and colors are read from `theme.toml`.
324
+ ### App options
463
325
 
464
326
  <details>
465
327
  <summary>Default config</summary>
@@ -528,6 +390,11 @@ self_mute = false
528
390
  # Join or update Discord voice with Concord self-deafened.
529
391
  self_deaf = false
530
392
 
393
+ # Optional CPAL device IDs chosen from Voice Options. When omitted or no longer
394
+ # available, Concord uses the current system default input or output device.
395
+ # input_source = "CoreAudio:input-id"
396
+ # output_source = "CoreAudio:output-id"
397
+
531
398
  # Allow microphone transmit while this session is joined and not self-muted.
532
399
  allow_microphone_transmit = false
533
400
 
@@ -558,30 +425,10 @@ application.
558
425
 
559
426
  </details><br>
560
427
 
561
- `image_protocol`:
562
-
563
- - `auto`: use terminal detection. In iTerm, Concord uses the iTerm2 protocol
564
- because terminal capability detection can incorrectly select Kitty there.
565
- - `iterm2`: force the iTerm2 inline image protocol.
566
- - `kitty`: force the Kitty graphics protocol.
567
- - `sixel`: force Sixel rendering.
568
- - `halfblocks`: force Unicode half-block fallback rendering.
569
-
570
- `image_preview_quality` and `attachment_viewer_quality`:
571
-
572
- - `efficient`: smaller preview requests to reduce bandwidth and memory use.
573
- - `balanced`: default quality with bounded resource use.
574
- - `high`: sharper resized previews using lossless quality.
575
- - `original`: request the original source image for previews when possible.
428
+ ### Key bindings
576
429
 
577
- This setting only applies to attachment, embed, and attachment viewer previews.
578
- Avatars and custom emoji keep their separate small-image behavior.
579
-
580
- `credentials.store`:
581
-
582
- - `auto`: try the system keychain first, then fall back to the state-file credential store.
583
- - `keychain`: use only the system keychain. If keychain storage is unavailable, the token is not saved.
584
- - `plain`: use only the plain-text state-file credential store.
430
+ See [Keymap options](./docs/keymap-options.md) for the config format and
431
+ supported actions.
585
432
 
586
433
  <details>
587
434
  <summary>Default keymap config</summary>
@@ -629,6 +476,7 @@ OpenNotificationInbox = "<leader>n"
629
476
  ChannelSwitcher = "<leader><leader>"
630
477
  VoiceDeafen = "<leader>vd"
631
478
  VoiceMute = "<leader>vm"
479
+ ToggleStream = "<leader>vs"
632
480
  VoiceLeave = "<leader>vl"
633
481
 
634
482
  [keymap.groups]
@@ -647,6 +495,8 @@ FolderSettings = "r"
647
495
  [keymap.channel_actions]
648
496
  JoinVoice = "e"
649
497
  LeaveVoice = "l"
498
+ ToggleStream = "s"
499
+ WatchStream = "w"
650
500
  VoiceParticipantAudio = "a"
651
501
  ShowPinnedMessages = "p"
652
502
  ShowThreads = "t"
@@ -711,12 +561,10 @@ ToggleReplyPing = "<A-p>"
711
561
 
712
562
  </details><br>
713
563
 
714
- You can customize key bindings. Check the [Keymap options](./docs/keymap-options.md) for the config format, supported actions.
564
+ ### Theme
715
565
 
716
- You can customize Concord's named UI Highlight Groups and border shapes in
717
- `theme.toml`. A Highlight Group may set foreground, background, bold, italic,
718
- dim, underline, and strikethrough, or link to another group and inherit its
719
- unset fields. Every group and field is optional.
566
+ See [Theme options](./docs/theme-options.md) for available groups, values, and
567
+ border shapes.
720
568
 
721
569
  <details>
722
570
  <summary>Default theme config</summary>
@@ -1139,9 +987,6 @@ foreground = "cyan"
1139
987
 
1140
988
  </details><br>
1141
989
 
1142
- Check [Theme options](./docs/theme-options.md) for the complete group list,
1143
- accepted values, links, exact defaults, and warning behavior.
1144
-
1145
990
  ## Performance
1146
991
 
1147
992
  Concord is designed to stay lightweight in normal terminal use. In observed
@@ -1152,44 +997,24 @@ bytes need to be decoded before they can be rendered in the terminal. When many
1152
997
  images are loaded, memory can briefly rise to around 100-200 MB while decoding
1153
998
  and then drop again as work completes and caches are pruned.
1154
999
 
1155
- To keep resource usage bounded, Concord limits media work in several places:
1156
-
1157
- - Attachment previews are downloaded with an 8 MiB per-preview cap.
1158
- - Up to 4 attachment previews are fetched at once.
1159
- - Up to 2 inline image previews are decoded at once.
1160
- - Inline image previews, avatars, and custom emoji use small LRU caches.
1161
- - Image preview requests prefer resized Discord proxy URLs sized for the
1162
- terminal instead of original full-size media when possible.
1163
- - The preview quality preset can lower preview source dimensions or opt into
1164
- original source images. It does not change avatar or custom emoji sizing.
1165
-
1166
- Message history is also cached with a per-channel limit, so long-running
1167
- sessions do not keep every message in memory forever.
1168
-
1169
1000
  ## FAQ
1170
1001
 
1171
1002
  ### Can my account be blocked?
1172
1003
 
1173
- Honestly, no.
1174
-
1175
- There are some path that did trigger a account block:
1004
+ There are some path that did trigger a temporary block:
1176
1005
 
1006
+ - If your account is new or has a low reputation, some actions may trigger a block.
1177
1007
  - Trying to **create a new DM channel and send a message to an unknown user**(meaning there was no pre-existing DM created through the Discord client) can immediately block your account temporarily.
1178
1008
  - Sending a message in an existing one-to-one DM may also trigger a temporary account block if you only recently started messaging that person or have little conversation history with them.
1179
- - Some features that requires a hCapcha challenge on Discord's side.
1009
+ - Some features that requires a hCapcha challenge.
1180
1010
 
1181
1011
  Other features have not caused blocks in my testing.
1182
1012
 
1183
1013
  That said, Concord is not an official Discord client. Using unofficial clients, automated user accounts, or self-bots can violate Discord's TOS, so there is always some risk. Use it at your own discretion.
1184
1014
 
1185
- ### Does Concord support CAPTCHA?
1186
-
1187
- No. If Discord requires a CAPTCHA during login, use token login instead.
1188
-
1189
1015
  ## Security
1190
1016
 
1191
1017
  - By default, tokens are stored in the system keychain when available.
1192
- - On Linux, keychain storage uses Secret Service when a compatible service is available.
1193
1018
  - The `CONCORD_TOKEN` environment variable lets you provide a token without writing it to disk. This avoids leaving plaintext on disk, but the token is visible in `/proc/<pid>/environ` and in process listings while Concord is running.
1194
1019
  - In `credentials.store = "auto"`, Concord falls back to **plain text** credentials under Concord's state directory when keychain storage is unavailable. In `keychain` mode, Concord does not fall back to plain storage. Keep fallback credential files secure and do not share them. You can use a token from that file to log in to the official Discord client, so treat it like a password.
1195
1020
  - On Unix, the fallback credential's parent directory is created with `0700` and the credential file with `0600` permissions.
@@ -23,7 +23,7 @@
23
23
  "hasInstallScript": true,
24
24
  "license": "GPL-3.0-only",
25
25
  "name": "@chojs23/concord",
26
- "version": "2.4.8"
26
+ "version": "2.5.1"
27
27
  },
28
28
  "node_modules/@isaacs/cliui": {
29
29
  "engines": {
@@ -542,5 +542,5 @@
542
542
  }
543
543
  },
544
544
  "requires": true,
545
- "version": "2.4.8"
545
+ "version": "2.5.1"
546
546
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "artifactDownloadUrls": [
3
- "https://github.com/chojs23/concord/releases/download/v2.4.8"
3
+ "https://github.com/chojs23/concord/releases/download/v2.5.1"
4
4
  ],
5
5
  "bin": {
6
6
  "concord": "run-concord.js"
@@ -22,7 +22,7 @@
22
22
  },
23
23
  "glibcMinimum": {
24
24
  "major": 2,
25
- "series": 35
25
+ "series": 39
26
26
  },
27
27
  "homepage": "https://github.com/chojs23/concord",
28
28
  "keywords": [
@@ -93,7 +93,7 @@
93
93
  "zipExt": ".tar.xz"
94
94
  }
95
95
  },
96
- "version": "2.4.8",
96
+ "version": "2.5.1",
97
97
  "volta": {
98
98
  "node": "18.14.1",
99
99
  "npm": "9.5.0"