SphereCord

SphereCord is the desktop Discord client for Project Colony — a fork of Equibop (itself based on Vesktop). It ships Equicord preinstalled, plus the full set of Colony color themes.

Main features:

• Equicord preinstalled (auto-updating)
• 52 Colony color themes bundled — Catppuccin, Gruvbox, Nord, Dracula, Tokyonight, Rosé Pine, Kanagawa and more, auto-installed and synced from the Colony palette set
• Much more lightweight and faster than the official Discord app
• Linux Screenshare with sound & wayland
• Much better privacy, since Discord has no access to your system

Extra included changes

• Tray Customization with voice detection and notification badges
• Command-line flags to toggle microphone and deafen status (Linux)
• Custom Arguments from this PR
• arRPC-bun with debug logging support https://github.com/Creationsss/arrpc-bun

Not fully Supported:

• Global Keybinds (Windows/macOS - use command-line flags on Linux instead)

SphereCord Arguments

Note

These flags are inherited from Equibop/Vesktop. See the persistent-flags section below to apply them.

Quick reference

Flag	Description
--ozone-platform=wayland	Force native Wayland
--ozone-platform=x11	Force XWayland
--no-sandbox	Disable Chromium sandbox (use with caution)
--force_high_performance_gpu	Prefer discrete GPU
--start-minimized	Launch minimized to tray
--toggle-mic	Toggle mic (bind to shortcuts)
--toggle-deafen	Toggle deafen (bind to shortcuts)
--toggle-vad	Toggle Voice Activity Detection (Voice Activity <-> Push To Talk)

Persistent flags

Add flags to ${XDG_CONFIG_HOME}/spherecord-flags.conf — one per line, lines starting with # are comments.

Installing

If a build is available on the Releases page, grab it there. Otherwise build from source (see below) — the artifacts land in dist/, and the AppImage is the easiest way to just try it (portable, no install, any Linux distro):

# after building (see "Building from Source"):

# AppImage — portable, works on any distro, no install needed
chmod +x dist/SphereCord-*.AppImage
./dist/SphereCord-*.AppImage

# or install natively — Arch Linux
sudo pacman -U dist/spherecord-*.pacman

.deb and .rpm packages are produced too (for Debian/Ubuntu and Fedora).

Building from Source

You need to have the following dependencies installed:

• Git
• Bun

Packaging will create builds in the dist/ folder

git clone https://github.com/Project-Colony/SphereCord
cd SphereCord

# Install Dependencies
bun install

# Either run it without packaging
bun start

# Or package (will build packages for your OS)
bun package

# Or only the portable AppImage (easiest to just run, any distro)
bun package --linux AppImage

# Or only build the Linux Pacman package (Arch)
bun package --linux pacman

# Or package to a directory only
bun package:dir

Building LibVesktop from Source

This is a small C++ helper library SphereCord uses on Linux to emit D-Bus events. By default, prebuilt binaries for x64 and arm64 are used.

If you want to build it from source:

1. Install build dependencies:
   • Debian/Ubuntu: apt install build-essential python3 curl pkg-config libglib2.0-dev
   • Fedora: dnf install @c-development @development-tools python3 curl pkgconf-pkg-config glib2-devel
2. Run bun buildLibVesktop
3. From now on, building SphereCord will use your own build