Cursed Delta

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

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 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 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
• 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

License

Licensed GPLv3+, see the LICENSE file for details.

Copyright © 2020-2022 Cursed Delta contributors.