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 go4one315 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 or friends.

/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: @Go4one315


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.4.tar.gz (18.6 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.4-py3-none-any.whl (25.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: chaterminal-2.0.4.tar.gz
  • Upload date:
  • Size: 18.6 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.4.tar.gz
Algorithm Hash digest
SHA256 e0fd3ebf5dddefa2e9ff382ed5bde71bb7df808888a6b7ed61ae6d5225e03cf6
MD5 49e84d7efb2c3defea0d1334cca6951f
BLAKE2b-256 6f90953412e01cc9388d8d200a160c87a43c8ec9428f9c5ed216835daf641253

See more details on using hashes here.

File details

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

File metadata

  • Download URL: chaterminal-2.0.4-py3-none-any.whl
  • Upload date:
  • Size: 25.1 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.4-py3-none-any.whl
Algorithm Hash digest
SHA256 aebc64eda8470b4d8ece8ef839a61a1c8c71884c7e531d4ddf00c3fdc59d111f
MD5 ccd50e028a882c226bbd0932f7434e79
BLAKE2b-256 1f0ac5b853c129e6399076ce298beb6134c84741cc62dbebbc5886b4715f77e0

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