Apps

Desktop (Linux and Windows)

The desktop client is a Wails app with native audio integration for voice channels.

Requirements:

• Linux (X11 or Wayland)
• Windows 10/11
• PulseAudio or PipeWire (with PulseAudio compatibility)

Tested platforms:

• Omarchy (Arch Linux + Hyprland)
• Windows 11

We currently test the desktop app only on Omarchy and Windows 11.

Install from source:

git clone https://github.com/crnobog69/zlikord.git
cd zlikord/desktop
bun install
bun run dev

To build a production binary:

wails build -platform linux/amd64 -clean

Linux Dependencies (Arch / Omarchy)

Install these packages if you are running/building the desktop app on Arch-based systems:

sudo pacman -S --needed \
  gtk3 webkit2gtk \
  gstreamer gst-plugins-base gst-plugins-good gst-plugins-bad gst-libav gst-plugin-pipewire \
  alsa-lib pipewire wireplumber \
  libx11 libxkbcommon \
  go gcc make pkgconf \
  opus opusfile

• Runtime-only users need the GTK/WebKit/GStreamer/audio libs.
• Developers building from source additionally need go gcc make pkgconf opus opusfile.

Mobile (Android)

The mobile client is built with Expo and React Native, featuring Material Design 3 with a dark theme.

Tested platform:

• Android 16

Install from source:

git clone https://github.com/crnobog69/zlikord.git
cd zlikord/mobile
npx expo run:android

Build a release APK:

npx eas build -p android --profile production

Mobile Connection via Tailscale Serve

To connect the mobile app, expose your local services through Tailscale Serve:

tailscale serve reset
tailscale serve --bg --set-path / http://127.0.0.1:5173
tailscale serve --bg --set-path /api http://127.0.0.1:8787/api
tailscale serve status

For access outside your Tailnet, use Tailscale Funnel.

Connecting to Your Server

Both clients support connecting to any Zlikord server instance. Enter your server’s Tailscale address (e.g. http://100.x.y.z:8787) when prompted.