Skip to main content

Delta Chat client for the command line

Project description

Cursed Delta

ncurses Delta Chat client developed in Python with the urwid library.

screenshot of Cursed Delta

Latest Release Supported Versions Downloads License CI Code style: black

Installation

Install Cursed Delta with pip:

$ pip install -U deltachat-cursed

Usage

After installation the command delta should be available, or you can use python3 -m deltachat-cursed. The first time you use Cursed Delta you need to configure your account:

$ delta init me@example.com YourStrongPassword  # omit password to use OAuth2

Then run delta command to start the application with your configured account.

If you want to use an already existent account, for example to open an account created with the official Delta Chat client:

$ delta --db ~/.config/DeltaChat/accounts/XXXXXXXXX/dc.db

Tips

  • Messages will be displayed in red if someone mentions you.
  • You will get a notification if someone mentions you in a group.
  • The message timestamp will be gray if the message is encrypted, or red if message is not encrypted.
  • You will see in your message if it is not sent yet, if it was send, ✓✓ when the message was read, or if the message was not delivered to some of the recipients.
  • You can send emojis sending typing their string representation, for example: :thumbs_up:
  • You can have emoji, contact names and commands autocompletion typing :, @ or / and pressing Tab
  • You can tweak the app colors editing ~/.curseddelta/theme.json
  • You can tweak the app keymap editing ~/.curseddelta/keymap.json
  • You can tweak the app settings editing ~/.curseddelta/curseddelta.conf
  • Put global theme, keymap, and config files in /etc/curseddelta/
  • You can have per-folder config files, the application search for this files in the current working directory: ./curseddelta-theme.json, ./curseddelta-keymap.json, ./curseddelta.conf
  • If you like to use the mouse, you can use the mouse to select chats in the chat list, select the draft area or scroll in the message history.

Configuration File Options

Inside your curseddelta.conf file, create a [global] section and there you can set:

  • account_path: the path to the default accouunt database to be open when the program is launched without --db option
  • notification: set to yes/no to enable/disable notifications (default: yes)
  • date_format: format of the date marker in chats (default: %x)
  • display_emoji: set to yes/no to enable/disable emoji rendering (default: no)

Default Shortcuts

  • Press Esc to leave the draft/editing area.
  • Press q to quit Cursed Delta.
  • Press Ctrl + x to toggle the chat list.
  • Use Meta + Enter to send the message.
  • Use Ctrl + o to open attachemnt in the last message in chat.
  • You can navigate the chat list with Meta + and Meta + .
  • Vim-like key bindings are also available, use h j k l to navigate between lists, use i to select the draft area and Esc to leave it.
  • For shortcuts in the draft/editing area see: urwid_readline

Commands

This are some temporal commands to do things that are not implemented yet using a menu:

  • Send /query user@example.com to start a chat with user@example.com
  • Send /add user@example.com to add user@example.com to the group where the command is sent.
  • Send /kick user@example.com to remove user@example.com from the group where the command is sent.
  • Send /part in a group to leave it.
  • Send /names in a group to get the member list in the buffer, use Ctrl + l to clear.
  • Use /join GroupName to create a group named GroupName
  • Send /id in a chat to get the chat's ID
  • Use /send /path/to/file.txt to send a file attachment
  • To send a message starting with / use //

Credits

The user interface is based on ncTelegram

Some code and ideas were taken from scli

License

Licensed GPLv3+, see the LICENSE file for details.

Copyright © 2020-2022 Cursed Delta contributors.

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

deltachat_cursed-0.5.0.tar.gz (274.9 kB view details)

Uploaded Source

Built Distribution

deltachat_cursed-0.5.0-py3-none-any.whl (36.1 kB view details)

Uploaded Python 3

File details

Details for the file deltachat_cursed-0.5.0.tar.gz.

File metadata

  • Download URL: deltachat_cursed-0.5.0.tar.gz
  • Upload date:
  • Size: 274.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.0 CPython/3.10.4

File hashes

Hashes for deltachat_cursed-0.5.0.tar.gz
Algorithm Hash digest
SHA256 c6fa79f776d13772667bae3c79cf4a6097a66185c7a33061706c15ea248fedae
MD5 f553bcf18df1a24dcc3b4f6cc08529c8
BLAKE2b-256 7dc714c23ba4be82db464f05feff4d7c5e04ef94817d5247237f69b7d28c23b0

See more details on using hashes here.

Provenance

File details

Details for the file deltachat_cursed-0.5.0-py3-none-any.whl.

File metadata

File hashes

Hashes for deltachat_cursed-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3c4b2e22d4da2073cb4496fa0abcdaf4c32715e78113035bafb716762d077472
MD5 1167b2337d304c98186887302b194bee
BLAKE2b-256 23c7bd9492f08a4abd1e1e3d14112c70b6eaeca22d65830dec310282303f7654

See more details on using hashes here.

Provenance

Supported by

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