Sharkord

Troubleshooting

Voice, screen share audio, rate limits, uploads, disconnects, startup and plugins.

Press F9 in a voice channel for connection diagnostics. Set debug=true in config.ini for verbose server logs. The desktop app keeps its own log file.

  • You are on HTTPS or http://localhost. See Why HTTPS.
  • Port 40000 is open on both UDP and TCP, in the firewall and the router.
  • Behind NAT, Docker or a cloud provider, webRtc.announcedAddress is set to the public IP or domain, and that domain is not behind a CDN proxy.
  • Server and clients on the same machine or LAN, webRtc.announcedAddress is set to 127.0.0.1 (same machine) or the server's LAN IP (other devices). Most routers do not loop the public IP back to your own network.
  • Remote users connect but LAN users do not (or the other way around), webRtc.announcedAddress is the public address and webRtc.internalAnnouncedAddress is the server's LAN IP. See WebRTC.
  • IPv6 only clients cannot connect, webRtc.announcedAddressV6 is set and the port is open for IPv6 too.

Users are being counted as your proxy's IP. The server logs the address to trust. Usually a CDN like Cloudflare in front of your proxy. See Behind a Proxy.

Failing instantly with 413: your proxy caps body size. Nginx needs client_max_body_size 0. Error about size or quota: Sharkord's own storage limits.

The WebSocket was cut, almost always by a proxy read timeout or an idle timeout in the network. Known cases: #46, #289, #259.

  • Windows: install the Visual C++ Redistributable (x64).
  • Port in use: change server.port or stop the other process.
  • Permissions: the data directory must be writable. In Docker, set PUID and PGID.

It is only read at startup. A file that fails validation is replaced by the defaults, with the reason in the log.

The reason is in the plugin's Logs tab. Usual causes:

  • Plugins are off in the server settings.
  • The folder name does not match the manifest id.
  • manifest.json, server/index.js or client/index.js is missing.
  • No onLoad export.
  • sdkVersion does not match the server.
  • onLoad or onUpgrade threw or took over 30 seconds.

Screen Share Audio

What gets shared depends on where you stream from:

Streaming fromAudio shared
FirefoxNone
Chromium based browsersA tab's audio. Whole system audio only on some systems, and never for a single window
Desktop appEverything playing on the computer except Sharkord itself

Stream from the desktop app for games and other apps. On Linux it needs PipeWire.

  • Share system audio is on in the screen share options.
  • In a browser, share a tab or the entire screen, not a window. See the table above.
  • Linux with EasyEffects or another virtual output: turn on Desktop Settings → Screen share → Capture audio from all outputs. Apps that play through a virtual output are skipped otherwise.
  • Restrict Own Audio is on, in the screen share options or under User Settings → Devices.
  • The streamer wears headphones or mutes their mic. A mic picking up the speakers sends viewers back through the voice channel, not the stream.
  • Windows: audio software that replays every app's sound from its own process (SteelSeries Sonar, Voicemeeter, Nahimic and similar) defeats Restrict Own Audio. Close it while streaming.
  • Linux with EasyEffects: turn on Capture audio from all outputs, as above. Otherwise the stream records EasyEffects' output, which carries the call's voices too.

EasyEffects with Process all input/output streams used to reroute the stream's audio capture. Update the desktop app.

Expected. The desktop app shares everything except Sharkord, since there is no reliable way to tell which sound belongs to which window. Mute what viewers should not hear.

Start the AppImage from a terminal with logging on, start a share, then stop it:

VENMIC_ENABLE_LOG=1 ./Sharkord*.AppImage

Attach the app's main.log, ~/.local/state/venmic/venmic.log and the output of wpctl status and pw-link -l, captured while the audio is playing, to the issue.

Still stuck? Search the issues or ask in discussions.

On this page