Skip to main content

A ncurses Delta Chat client

Project description

Cursed Delta

A 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:

$ sudo pip3 install -U deltachat-cursed

Optionally, if you want notifications install libnotify (Debian example):

$ sudo apt-get install libnotify-bin

Usage

After installation the command curseddelta should be available, or you can use python3 -m deltachat-cursed. The first time you run curseddelta you need to specify an email and password:

$ curseddelta --email me@example.com --password H4rdPassw0rd

Or if you want to use an already existent account:

$ curseddelta --db /path/to/your/account.db

Tips

  • Messages will be displayed in red if someone mentions you.
  • You will get a notification if someone mentions you in a group. (needs libnotify)
  • The message marker > will be gray if the message is encrypted, or red if message is not encrypted.
  • Message will be gray until it is sent.
  • You will see at the end of the message if it was send, ✓✓ when the message was noticed, or if message failed to send.
  • You can tweak the app colors editing ~/.curseddelta/theme.json
  • You can tweak the app keymap editing ~/.curseddelta/keymap.json
  • 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.

Default Shortcuts

  • Press Esc to leave the draft/editing area.
  • Press q to quit the Cursed Delta.
  • Press Ctrl + x to toggle the chat list.
  • Use Meta + Enter to send the message.
  • Use Ctrl + r to reply last message in chat.
  • 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
  • Use /accept n to accept contact request number n (starting from 1)
  • To send a message starting with / use //

Credits

The user interface is based on ncTelegram

License

Licensed GPLv3+, see the LICENSE file for details.

Copyright © 2020 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.2.0.tar.gz (26.4 kB view hashes)

Uploaded Source

Built Distribution

deltachat_cursed-0.2.0-py3-none-any.whl (27.5 kB view hashes)

Uploaded Python 3

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