A CLI-based client for Discord inspired by SDF's commode.
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.
 
Cynthia Foxwell 95fca1c026
minor fixes
1 month ago
src minor fixes 1 month ago
.eslintrc.js refactor everything out of one file, add channel rememberance 5 months ago
.gitignore initial commit 5 months ago
.prettierrc add help command 5 months ago
LICENSE Add LICENSE 5 months ago
README.md config support, user account support, private message support 4 months ago
package.json move from eris to oceanic 4 months ago
pnpm-lock.yaml move from eris to oceanic 4 months ago

README.md

comcord

A CLI-based client for Discord inspired by SDF's commode.

Why?

  1. All CLI/TUI Discord clients are outdated/unmaintained or have flaws.
  2. I've been spending more time in commode on SDF and have been accustomed to the experience.

Usage

  1. pnpm i
  2. node src/index.js <token> Your token will be then stored in .comcordrc after the first launch.

User Accounts

User accounts are partially supported via allowUserAccounts=true in your .comcordrc. This is use at your own risk, despite spoofing the official client. I am not responsible for any banned accounts.

Guild members not populating

This is due to Oceanic not implementing Lazy Guilds as they are user account specific. DO NOT bother Oceanic to implement it! They are purely a bot-focused library.

If you are willing to implement Lazy Guilds based off of unofficial documentation and my already existing horrible hacks to make user accounts work in the first place, feel free to send a PR (on GitLab, GitHub repo is a read only mirror).

Bot Accounts (prefered)

You MUST grant your bot all Privileged Gateway Intents.

Design Decisions

  • Node.js was chosen currently due to familiarity.
  • Oceanic was chosen due to familiarity and the nature of everything not being abstracted out to 200 different classes unlike discord.js.
  • "Jank" by design. While I don't expect anyone to actually use comcord on serial terminals or teletypes other than for meme factor, the option is still there.

TODO

  • Commands
    • Quit (q)
    • Switch guilds (G)
    • Switch channels (g)
    • List online users in guild (w)
    • Emote (e)
      • Just sends message surrounded in *'s
    • Finger (f)
      • Shows presence data if available
      • Creation date, join date, ID, etc
    • Room history (r)
    • Extended room history (R)
    • List channels (l)
    • List guilds (L)
    • Clear (c)
    • Surf channels forwards (>)
    • Surf channels backwards (<)
    • AFK toggle (A)
    • Send DM (s)
    • Answer DM (a)
  • Message Receiving
    • Markdown styling
      • Common markdown (bold, italic, etc)
      • Figure out how spoilers would work
      • Emotes?????
      • Timestamp parsing
      • Mentions parsing
    • Embeds in the style of commode's posted links
    • Messages wrapped in *'s or _'s parsed as emotes
    • Inline DMs to replicate commode's private messages
    • Replies
  • Message sending
    • Puts incoming messages into queue whilst in send mode
    • Mentions
    • Replies
  • Configuration
    • Default guild/channel
      • No way to set in client (yet?), defaultChannel= and defaultGuild= in your .comcordrc.
  • Threads
  • Not have the token just be in argv
  • Not have everything in one file