{"id":15112391,"url":"https://github.com/bios-marcel/cordless","last_synced_at":"2026-01-14T12:33:36.311Z","repository":{"id":41356414,"uuid":"165042306","full_name":"Bios-Marcel/cordless","owner":"Bios-Marcel","description":"The Discord terminal client you never knew you wanted.","archived":true,"fork":false,"pushed_at":"2021-12-16T11:27:51.000Z","size":5595,"stargazers_count":1640,"open_issues_count":60,"forks_count":140,"subscribers_count":23,"default_branch":"master","last_synced_at":"2024-05-28T15:28:44.852Z","etag":null,"topics":["alternative","cli","client","commandline","discord","discordgo","terminal","tui","tview"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Bios-Marcel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-01-10T10:47:02.000Z","updated_at":"2024-05-22T02:14:36.000Z","dependencies_parsed_at":"2022-08-30T03:40:45.883Z","dependency_job_id":null,"html_url":"https://github.com/Bios-Marcel/cordless","commit_stats":null,"previous_names":[],"tags_count":26,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bios-Marcel%2Fcordless","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bios-Marcel%2Fcordless/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bios-Marcel%2Fcordless/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Bios-Marcel%2Fcordless/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Bios-Marcel","download_url":"https://codeload.github.com/Bios-Marcel/cordless/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219872008,"owners_count":16554482,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["alternative","cli","client","commandline","discord","discordgo","terminal","tui","tview"],"created_at":"2024-09-26T00:44:31.399Z","updated_at":"2025-09-27T15:30:32.947Z","avatar_url":"https://github.com/Bios-Marcel.png","language":"Go","readme":"# I AM CLOSING DOWN THE CORDLESS PROJECT\n\nHey, 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.\nI'll keep the repository up, but it'll be archived (read-only) and I have vendored the dependencies, meaning that you'll probably always be able to build the project from source as long as you have a compatible go compiler. **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!**\n\n\u003ch1 align=\"center\"\u003eCordless\u003c/h1\u003e\n\nThe discord server still exists and there's still some people talking, so feel free to check it out if you want to:\n\nhttps://discord.gg/fxFqszu\n\n## Overview\n\n- [How to install it](#installation)\n  - [Using prebuilt binaries](#using-prebuilt-binaries)\n  - [Building from source](#building-from-source)\n- [Login](#login)\n- [Quick overview - Navigation (switching between boxes / containers)](#quick-overview---navigation-switching-between-boxes--containers)\n- [Extending Cordless via the scripting interface](#extending-cordless-via-the-scripting-interface)\n- [Troubleshooting](#troubleshooting)\n- [FAQ](#faq)\n- [This project isn't for you, if](#this-project-isnt-for-you-if)\n- [Similar projects](#similar-projects)\n- [Credits](#credits)\n\n**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)**\n\nCordless is a custom [Discord](https://discord.com/app) client that aims to\nhave a low memory footprint and be aimed at power-users.\n\nThe application only uses the official Discord API and doesn't send data to\nthird parties. However, this application is not an official product by\nDiscord Inc.\n\n![Demo Screenshot](.github/images/chat-demo.png)\n\n## Installation\n\n### Using prebuilt binaries\n\nIf you don't want to build the application yourself or use some kind of\npackage management system, you can get the latest binaries for the three\nmajor systems in the release overview:\n\nhttps://github.com/Bios-Marcel/cordless/releases/latest\n\n### Building from source\n\nIn order to execute the following commands, you need to install **go 1.13 or**\nhigher. You can find golang packages at https://golang.org/doc/install.\nOn top of that, you need to have **git** installed. It can be fund at\nhttps://git-scm.com/downloads.\n\n**UPDATES HAVE TO BE INSTALLED MANUALLY**\n\nOpen a command line and execute the following commands:\n\n```shell\ngit clone https://github.com/Bios-Marcel/cordless.git\ncd cordless\ngo build\n```\n\nThis will create an executable file called `cordless` or `cordless.exe`\ndepending on whether you are on Windows or not. Move that file anywhere\n that your terminal can find it. I recommend adding a `bin` folder to your\nuser home and adding it to your systems `PATH` variable. Please search the\ninternet, using your favourite search engine, for\n`how to set an environment variable in XXX` in order to update your `PATH`\nvariable correctly.\n\nFor updateing you simply have to delete the folder you downloaded last\ntime and repeat the instructions.\n\nNote:\n\n* X11 users need `xclip` in order to copy and paste.\n* Wayland users need `wl-clipboard` in order to copy and paste.\n* Mac OS users need `pngpaste` in order to copy and paste images.\n\n### Login\n\n**YOUR PASSWORD IS NEVER SAVED LOCALLY.**\n\nLogging in works via the UI on first startup of the application.\n\nIf you are logging in with a bot token, you have to prepend `Bot` in front of\nthe token.\n\nIf you need to find out how to retrieve your token, check [the wiki](https://github.com/Bios-Marcel/cordless/wiki/Retrieving-your-token).\n\n**Currently captcha-code login isn't supported. Thanks for your SHIT-API, Google**\n\n## Quick overview - Navigation (switching between boxes / containers)\n\n| Shortcut | Action |\n| - |:- |\n| \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eS\u003c/kbd\u003e | Sets the focus on the servers (guilds) container |\n| \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eC\u003c/kbd\u003e | Sets the focus on the channels container |\n| \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eT\u003c/kbd\u003e | Sets the focus on the messages container |\n| \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eM\u003c/kbd\u003e | Sets the focus on the messages input field |\n| \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eU\u003c/kbd\u003e | Sets the focus on the users container |\n| \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003eP\u003c/kbd\u003e | Opens the direct messages container |\n| \u003ckbd\u003eAlt\u003c/kbd\u003e + \u003ckbd\u003e.\u003c/kbd\u003e | Toggles the internal console view |\n\nFurther shortcuts / key-bindings can be found in the manual on the internal\nconsole with the command `manual`.\n\nIf any of the default commands don't work for you, open the keyboard shortcut\nchanger via \u003ckbd\u003eCtrl\u003c/kbd\u003e + \u003ckbd\u003eK\u003c/kbd\u003e.\n\n## Extending Cordless via the scripting interface\n\n[Check the wiki](https://github.com/Bios-Marcel/cordless/wiki/Extending-Cordless-via-the-scripting-interface)\n\n## Troubleshooting\n\nIf you happen to encounter a crash or a bug, please submit a bug report via\nthe projects GitHub issue tracker. Bugs reported via Discord will probably\nbe forgotten or overseen.\n\nFor general problems faced by cordless users, check out the wiki at:\nhttps://github.com/Bios-Marcel/cordless/wiki/Troubleshooting\n\nIf you need help or have questions that you don't want to create an issue\nfor, just join our Discord server: https://discord.gg/fxFqszu\n\n# FAQ\n\nIn order to find answers to common questions, check out the FAQ in the wiki:\n\nhttps://github.com/Bios-Marcel/cordless/wiki/FAQ\n\n## This project isn't for you, if\n\n- You like fancy GUI\n- You want to see images, videos and whatnot inside of the application itself\n- You need the voice/video calling features\n- You need to manage or moderate servers\n\n## Similar projects\n\nHere is a list of similar projects:\n\n- [terminal-discord](https://github.com/xynxynxyn/terminal-discord)\n- [Discurses](https://github.com/topisani/Discurses)\n- [Discline](https://github.com/MitchWeaver/Discline)\n- [discord-term](https://github.com/cloudrex/discord-term)\n- [6cord](https://gitlab.com/diamondburned/6cord)\n\nHit me up if you have a similar project, and I'll gladly add it to the list.\n\n## Credits\n\nBig thanks to [JetBrains](https://www.jetbrains.com/?from=cordless) for providing the\ncordless project with free licenses!\n\nThis project was mainly inspired by [Southclaws](https://github.com/Southclaws)\n[Cordless](https://github.com/Southclaws/cordless-old), which he sadly didn't\ndevelop any further.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbios-marcel%2Fcordless","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbios-marcel%2Fcordless","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbios-marcel%2Fcordless/lists"}