Files
voice-cat/clients/windows
Talon 6fe7bf0158
Some checks failed
Build Linux Binaries / linux/amd64 (push) Has been cancelled
Build Linux Binaries / linux/arm64 (push) Has been cancelled
feat: fix voice join/leave, channel edit defaults, channel-update stream restart
Three bugs fixed across the full stack (proto/server/core/ABI/Win/macOS/iOS):

1. Join/Leave Voice now truly subscribes/unsubscribes from the voice plane.
   Previously the button only toggled the local mic — receiving was always on
   (gated by channel membership alone). Added a protocol-level voice subscription
   concept: new SubscribeVoiceRequest/UnsubscribeVoiceRequest/VoiceSubscriptionResult
   proto messages, User.voice_subscribed field, vc_join_voice/vc_leave_voice C ABI
   functions, VC_EVENT_VOICE_STATE event, server-side voice_subscribed flag checked
   by the SFU relay recipient filter, and core-client gating of remote-stream
   decoder setup. All three clients rewired to subscribe+mic on Join / unsubscribe
   on Leave. Text chat works regardless of voice subscription.

2. Channel edit dialog now shows the channel's actual current settings. The read
   struct vc_channel was missing sort_order and audio fields — only the write
   struct vc_channel_info had them. Extended vc_channel with both (additive, no
   ABI break), updated the session model and list_channels marshaling to populate
   them, and updated all three clients' edit callers to use actual channel info
   instead of hardcoded defaults.

3. Channel parameter updates now automatically restart everyone's streams.
   Previously editing a channel's audio config persisted and broadcast a
   ChannelEvent::UPDATED, but no layer restarted streams — encoders/decoders are
   frozen at announce time. handle_channel_event now detects audio-config changes
   on the user's current channel and stop->starts each active local stream. The
   server reads the updated config on re-announce; peers wire up fresh decoders
   at the new ssrc.

All 29 CTest tests pass; Windows DLL + C# client build clean. Apple clients not
yet compile-verified (Windows environment).
2026-06-24 14:29:39 +02:00
..

VoiceCat — Windows client

WinForms (.NET 10 LTS) UI over voicecat.dll (MinGW-built libvoicecat shared library).

Prerequisites

Tool Version Notes
.NET SDK 10.0.x dotnet --version should report 10.0.*
CMake 3.25+ For building the C++ DLL
MinGW-w64 / MSYS2 UCRT64 GCC 13+ C:\tools\msys64\ucrt64 is the expected location
vcpkg any VCPKG_ROOT env var must point to a bootstrapped clone

Build order

1. Build the server (for testing)

cmake --preset dev
cmake --build --preset dev --target voicecat-server

2. Build the DLL

cmake --preset windows-client
cmake --build --preset windows-client

Output: build/windows-client/bin/voicecat.dll

Verify no MinGW runtime dependencies remain:

& "C:\tools\msys64\ucrt64\bin\objdump.exe" -p build/windows-client/bin/voicecat.dll |
    Select-String "DLL Name"

Expected: only Windows system DLLs (KERNEL32.dll, WS2_32.dll, BCRYPT.dll, etc.). If libgcc_s_seh-1.dll, libstdc++-6.dll, or libwinpthread-1.dll appear, the -static-libgcc -static-libstdc++ -static -lwinpthread link flags in core/CMakeLists.txt are not taking effect — check the CMake log for the VOICECAT_BUILD_SHARED+WIN32 branch.

3. Build the C# solution

cd clients/windows
dotnet build VoiceCat.slnx

The app's Directory.Build.props copies voicecat.dll from ../../build/windows-client/bin/ into the output directory automatically on every build.

Running manually

# Terminal 1 — start the server
./build/dev/bin/voicecat-server.exe --name "My Server"

# Terminal 2 — launch the client
dotnet run --project clients/windows/VoiceCat.App/VoiceCat.App.csproj

On first connect to a new server:

  • Enter 127.0.0.1 as the host (not localhost — Windows resolves localhost to ::1 first, and while the server now dual-stacks, 127.0.0.1 is cleaner for local testing).
  • The server identity dialog will appear. The TLS leaf-cert SHA-256 fingerprint is shown; accept to pin it. Subsequent connects to the same server will be silent (MATCHED).

M5 — Moderation & admin UI

The WinForms client now exposes all M5 operations through the main menu and context menus:

  • Admin → Server accounts… — create, reset password, and delete server accounts (requires can_admin_accounts).
  • Channel tree right-click — create, edit, and delete channels. The edit dialog exposes the full per-channel Opus configuration: mono/stereo, sample rate, bitrate, frame size, application mode, FEC, expected packet loss, DTX, and complexity.
  • User list right-click — move, kick, ban, server mute/deafen, and set permissions (items are gated by your own permissions).
  • Activity log shows async GenericResult feedback for every moderation request.
  • User list shows text indicators for self-mute, self-deafen, server-mute, and server-deafen states.

These operations require an admin-provisioned account with the appropriate permissions; the connect dialog already supports username/password auth.

Known limitations

  • PTT is focus-scoped — the push-to-talk key only works while the VoiceCat window has focus. A system-wide WH_KEYBOARD_LL hook is not used in v1 (permissions + AV risk).
  • Receive-side noise reduction checkbox in per-user tuning is wired end-to-end but is a passthrough no-op until a real APM/NS backend is built (no working Windows/MSVC port of webrtc-audio-processing upstream — see docs/tech-stack.md §1).
  • TOFU pins the TLS leaf cert, not the declared Ed25519 identity fingerprint. Both are shown in the identity dialog, but the cert fingerprint is the value that is actually verified on reconnect. See docs/security.md §1.1.