Skip to main content

A terminal-based encrypted chat system for MemerDevs

Project description

ChaTerminal

ChaTerminal is the official terminal chat client for MemerDevs. It lets you send end-to-end encrypted direct messages to other MemerDevs users from your terminal.

Python License Platform Version


Features

  • End-to-end encrypted direct messages
  • Real-time messages when both users are online
  • Offline message sync when a linked recipient comes back online
  • Recent chat history on startup
  • Online user list for users who choose to show terminal presence
  • One active terminal session per MemerDevs account
  • Web settings for privacy, linking, and session revocation

Installation

ChaTerminal requires Python 3.10 or later.

Install it with pip:

pip install ChaTerminal

To update an existing install:

pip install --upgrade ChaTerminal

Quick Start

1. Run ChaTerminal

Open your terminal and run:

ChaTerminal

If this is your first time using ChaTerminal, or if your session was revoked, the app will show an activation code.

Example:

ChaTerminal - Link Account

1. Open MemerDevs in your browser
2. Go to Settings -> ChaTerminal
3. Enter the activation code

Activation code: A1B2C3D4

Waiting for authorisation 04:59

Activation codes expire after a few minutes. If the timer runs out, restart ChaTerminal to get a new code.

2. Link Your MemerDevs Account

  1. Go to memerdevs.com/settings.
  2. Scroll to the ChaTerminal section.
  3. Enter the activation code shown in your terminal.
  4. Click Link Terminal.

Keep ChaTerminal open while you do this. Once linking succeeds, the terminal will continue automatically.

3. Start Chatting

After linking, ChaTerminal shows your recent message history and opens a prompt:

>

Type a command and press Enter.


Commands

Command What it does
/dm <username> <message> Send a private message
/list Show currently online ChaTerminal users
/help Show available commands
/exit Disconnect and close ChaTerminal

Examples:

> /dm gofaone315 Hey, are you online?
> /list

Usernames

Use the MemerDevs username slug from a profile URL.

For example, if the profile URL is:

https://memerdevs.com/u/johndoe

Send a message with:

> /dm johndoe Hello from ChaTerminal

Privacy And Sessions

You can manage ChaTerminal from MemerDevs Settings.

In the ChaTerminal section, you can:

  • Link a terminal session
  • Revoke your active terminal session
  • Choose who can message you
  • Show or hide your terminal online status

If you hide your online status, you will not appear in other users' /list results.

ChaTerminal allows one active terminal session per account. If you link or start ChaTerminal on another device, the previous terminal session will be signed out.


Message Delivery

Messages are encrypted before they leave your machine.

When both users are online, messages are delivered in real time. If the recipient has a linked ChaTerminal session but is offline, the message is delivered when they reconnect.

If a user has not linked ChaTerminal, or their terminal session was revoked, you may see a message saying that they do not have an active terminal session.


Troubleshooting

The activation code expired

Restart ChaTerminal and enter the new code in MemerDevs Settings.

The activation code is not accepted

Make sure you entered all 8 characters exactly as shown. If it still fails, restart ChaTerminal and use the new code.

I was signed out

This can happen if:

  • You revoked the session from MemerDevs Settings
  • You linked ChaTerminal on another device
  • Your MemerDevs session expired

Run ChaTerminal again and link your account if prompted.

I cannot message someone

The other user may not have linked ChaTerminal, may have revoked their terminal session, or may only allow messages from followers.

/list does not show someone

They may be offline, or they may have disabled terminal online status in MemerDevs Settings.


License

This project is proprietary. See LICENSE for more info.

Author

Gofaone Tlalang
GitHub: @Gofaone315


ChaTerminal - real-time end-to-end encrypted chat from your terminal.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chaterminal-2.0.2.tar.gz (18.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chaterminal-2.0.2-py3-none-any.whl (24.8 kB view details)

Uploaded Python 3

File details

Details for the file chaterminal-2.0.2.tar.gz.

File metadata

  • Download URL: chaterminal-2.0.2.tar.gz
  • Upload date:
  • Size: 18.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for chaterminal-2.0.2.tar.gz
Algorithm Hash digest
SHA256 92c8b2035f50781ebe477eae1ee6037dc818a0bfc53f99056ba705997b508f51
MD5 5782330c21c2159721f75ae2941d6fd3
BLAKE2b-256 c3cb4ca8e50dc02dd5a81cb0f722554c6a327d266021dcacc33550848c50d358

See more details on using hashes here.

File details

Details for the file chaterminal-2.0.2-py3-none-any.whl.

File metadata

  • Download URL: chaterminal-2.0.2-py3-none-any.whl
  • Upload date:
  • Size: 24.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for chaterminal-2.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 eb85059d2c056cf1801225837772e077abc77cd32e8f3fc2463a05ab0aa14a64
MD5 7569fde930ebfeb653b387a8891fe404
BLAKE2b-256 9ea6aa6081076dec7582118f78ffbab5c7102e1ac26a2f26d5d38abbb1bcc941

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page