Cyclone

Cyclone is a work in progress third-party Discord client for Macs.

Goals, in order of descending priority:

1. Be a good macOS citizen. Follow Apple's Human Interface Guidelines. Pursue utilitarianism, embrace unorthodox features, and cater to power users.
2. Present as a first-party client to Discord's servers. Enabling spam, automation, and abuse are not goals of Cyclone, but extra care is taken to avoid automated account bans.
3. Consume less CPU, memory, and energy than Discord's official client.
4. Facilitate easy debugging and inspection of network traffic to and from Discord's gateway and HTTP API.

Requirements

Swift 5.9 (Xcode 15.0) or later is required to build. Cyclone targets macOS 12.4 (Monterey) or newer, and will not launch on older versions.

Usage

Important

Disclaimer: In its current state, Cyclone lacks many essential features necessary for basic use. It is not intended for end-users at this time, and resembles something more akin to an experiment than a fully fledged client. Consider exploring alternatives such as Accord or Swiftcord.

1. After building and running, when the app activates, press Command-Comma to open the Settings window. (At the moment, Cyclone doesn't create any windows upon startup by default.)
2. Navigate to the Accounts tab and create a new account, inputting a Discord user token.
   • To enable compression, append &compress=zlib-stream to the gateway URL. Cyclone will automatically detect the presence of this parameter and decompress packets.
3. Back in Xcode, press Command-Shift-Comma to open the scheme editor.
4. In the Run scheme, under the Arguments tab, add an entry under "Arguments Passed on Launch".
5. Input -BSLKAutomaticallyAuthorizeWithFirstAccount YES and ensure that the argument is enabled by ticking the checkbox.
6. Stop the app and relaunch. The app will automatically attempt to connect to Discord with the first account present in the Settings window.