The Discord terminal client you never knew you wanted.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Marcel Schramm 54865be813
Improve readme
1 year ago
.circleci Builds now use go 1.13 2 years ago
.github Add snap deprecation to bug issue template 1 year ago
.vscode Add some debugging util 1 year ago
app Improve application startup and restart. Fixes #268 1 year ago
commands Fix #361 1 year ago
config Reaction rendering 1 year ago
discordutil Reaction rendering 1 year ago
femto Update to tcell v2.0.0 (#358) 1 year ago
fileopen Add catch-all handler for not further specified extensions. 1 year ago
logging Add --log option to add a logfile 1 year ago
readstate Readstate now treats temporarily muted correctly 1 year ago
scripting Improve docs for JS engine slightly 1 year ago
shortcuts Order of delete shortcuts in shortcut dialog was messed up. 1 year ago
syntax Fix small bugs, replace deprecated usages and sort imports 2 years ago
times Fix small bugs, replace deprecated usages and sort imports 2 years ago
tools Fix layout demo 1 year ago
tview move autocomplete into separate file and improve event forwarding 1 year ago
ui Reaction rendering 1 year ago
util Fix #335 1 year ago
version Refactor version checking slightly 1 year ago
.gitignore Add some debugging util 1 year ago
.travis.yml Builds now use go 1.13 2 years ago
Dockerfile Add Dockerfile for building a Docker image 1 year ago
LICENSE Initial commit 3 years ago Improve readme 1 year ago
appveyor.yml Make sure app veyor builds use go modules 1 year ago Add some debugging util 1 year ago
cordless.json_template Add windows binaries for x86 for both scoop and github releases. Fixes #216 2 years ago
cordless.rb_template Add additionla step to build, that creates the homebrew file. 3 years ago Add some debugging util 1 year ago
flags_windows.go Attempt 2 at enabling UTF8 by default on new WT 1 year ago
go.mod Downgrade chroma, due to test failure with v8+ 1 year ago
go.sum Downgrade chroma, due to test failure with v8+ 1 year ago
main.go Improve application startup and restart. Fixes #268 1 year ago
main_debug.go Usernames can now be displayed with their respective role colors 2 years ago Improve docs of release scripts 1 year ago
version.go_template Add doc to version number 1 year ago


Hey, so I know this is somewhat of a bummer, but I got banned because of ToS violation today. This seemed to be connected to creating a new PM channel via the /users/@me endpoint. As that's basically a confirmation for what we've believed would never be enforced, I decided to not work on the cordless project anymore. I'll be taking down cordless in package managers in hope that no new users will install it anymore without knowing the risks. I believe that if you manage to build it yourself, you've probably read the README and are aware of the risks. I'll keep the repository up, but might archive it at some point. And yes, you'll still be able to use existing binaries for as long as discord doesn't introduce any more breaking changes. However, be aware that the risk of getting a ban will only get higher with time!



WARNING: Third party clients are discouraged and against the Discord TOS. There have already been cordless users that got banned, including me (Bios-Marcel, the maker and maintainer)

Cordless is a custom Discord client that aims to have a low memory footprint and be aimed at power-users.

The application only uses the official Discord API and doesn't send data to third parties. However, this application is not an official product by Discord Inc.

Demo Screenshot


Using prebuilt binaries

If you don't want to build the application yourself or use some kind of package management system, you can get the latest binaries for the three major systems in the release overview:

Building from source

In order to execute the following commands, you need to install go 1.13 or higher. You can find golang packages at On top of that, you need to have git installed. It can be fund at


Open a command line and execute the following commands:

git clone
cd cordless
go build

This will create an executable file called cordless or cordless.exe depending on whether you are on Windows or not. Move that file anywhere that your terminal can find it. I recommend adding a bin folder to your user home and adding it to your systems PATH variable. Please search the internet, using your favourite search engine, for how to set an environment variable in XXX in order to update your PATH variable correctly.

For updateing you simply have to delete the folder you downloaded last time and repeat the instructions.


  • X11 users need xclip in order to copy and paste.
  • Wayland users need wl-clipboard in order to copy and paste.
  • Mac OS users need pngpaste in order to copy and paste images.



Logging in works via the UI on first startup of the application.

If you are logging in with a bot token, you have to prepend Bot in front of the token.

If you need to find out how to retrieve your token, check the wiki.

Currently captcha-code login isn't supported. Thanks for your SHIT-API, Google

Quick overview - Navigation (switching between boxes / containers)

Shortcut Action
Alt + S Sets the focus on the servers (guilds) container
Alt + C Sets the focus on the channels container
Alt + T Sets the focus on the messages container
Alt + M Sets the focus on the messages input field
Alt + U Sets the focus on the users container
Alt + P Opens the direct messages container
Alt + . Toggles the internal console view

Further shortcuts / key-bindings can be found in the manual on the internal console with the command manual.

If any of the default commands don't work for you, open the keyboard shortcut changer via Ctrl + K.

Extending Cordless via the scripting interface

Check the wiki


If you happen to encounter a crash or a bug, please submit a bug report via the projects GitHub issue tracker. Bugs reported via Discord will probably be forgotten or overseen.

For general problems faced by cordless users, check out the wiki at:

If you need help or have questions that you don't want to create an issue for, just join our Discord server:


In order to find answers to common questions, check out the FAQ in the wiki:

This project isn't for you, if

  • You like fancy GUI
  • You want to see images, videos and whatnot inside of the application itself
  • You need the voice/video calling features
  • You need to manage or moderate servers

Similar projects

Here is a list of similar projects:

Hit me up if you have a similar project, and I'll gladly add it to the list.


Big thanks to JetBrains for providing the cordless project with free licenses!

This project was mainly inspired by Southclaws Cordless, which he sadly didn't develop any further.