Skip to main content

Command line instant messenger inspired by centericq/centerim

Project description

nuqql

nuqql is a command line instant messenger inspired by centericq and centerim written in Python and using ncurses.

nuqql uses so-called backends for connecting to chat networks. Currently, nuqql supports the following backends:

  • nuqql-slixmppd: nuqql-slixmppd uses slixmpp and allows nuqql to connect to XMPP chat networks.
  • nuqql-matrixd-nio: nuqql-matrixd-nio uses matrix-nio and allows nuqql to connect to Matrix chat networks.
  • nuqql-matrixd: nuqql-matrixd uses the Matrix Python SDK and allows nuqql to connect to Matrix chat networks. Note: the Matrix Python SDK project strongly recommends using matrix-nio, so prefer using nuqql-matrixd-nio.
  • nuqql-mattermostd: nuqql-mattermostd uses the Mattermost Golang Driver and allows nuqql to connect to Mattermost servers
  • purpled: purpled uses libpurple and allows nuqql to connect to multiple chat networks. Note: purpled is less tested than other backends, so you might want to prefer other backends.

Quick Start

You can install nuqql, for example, with pip for your user only with the following command:

$ pip install --user nuqql

The basic nuqql setup consist of installing one or more backends and adding your instant messaging accounts to them. See setup for more information about how to setup nuqql.

Run

After the installation, you can run nuqql with the nuqql command:

$ nuqql

Overview

The layout of nuqql is as follows:

+--------------+----------------+
|              |                |
|              |                |
|              |                |
|              |   Log Window   |
|              |                |
| List Window  |                |
|              |                |
|              +----------------+
|              |                |
|              |  Input Window  |
|              |                |
+--------------+----------------+
  • List Window: shows the Conversation List
  • Log Window: shows the Log of the current Conversation
  • Input Window: shows the user's input of the current Conversation

The Conversation List shows your buddies and special conversations for your backend commands and nuqql commands. Buddies are shown with their status (on, afk, off) and their name, e.g., [on] buddy@jabber.org. Group chats and invites to group chats are shown with [grp] and [grp_invite] as a special status. The nuqql and backend command conversations are shown as {nuqql} and with {backend} in front of their name, e.g., {backend} slixmppd.

Controls

Basic controls of nuqql are:

  • Navigate the Conversation List with the arrow keys UP and DOWN
  • Press ENTER on a conversation to open it
  • Press h on a conversation to open it and switch to its chat log
  • In a conversation:
    • Enter your message/command
    • Send message/command with CTRL-x
    • Switch to chat log window with CTRL-o or F9
      • Search chat log with /
    • Leave conversation with the ESC key
  • Exit nuqql with the q key when you are in no conversation

See controls for more information about nuqql's controls.

Development

Most of the development happens in the devel branch. When a new version of nuqql is released, the devel code is merged into the master branch. So, if you want to try the latest code, check out the devel branch, otherwise just use master.

Changes

See changelog for changes in each version.

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

nuqql-0.12.0.tar.gz (43.3 kB view details)

Uploaded Source

Built Distribution

nuqql-0.12.0-py3-none-any.whl (55.3 kB view details)

Uploaded Python 3

File details

Details for the file nuqql-0.12.0.tar.gz.

File metadata

  • Download URL: nuqql-0.12.0.tar.gz
  • Upload date:
  • Size: 43.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.63.0 importlib-metadata/4.11.2 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.10.2

File hashes

Hashes for nuqql-0.12.0.tar.gz
Algorithm Hash digest
SHA256 7532d072fb2ec34b713581c31cd037bf843daa08b853179d78dee727040bbcc6
MD5 4c4025fc245ecba1b9875ddd870a4f8c
BLAKE2b-256 1dd36b68d033c5709754e716fc3e579d57b1e2a42f6542a85768eba3b427fadd

See more details on using hashes here.

File details

Details for the file nuqql-0.12.0-py3-none-any.whl.

File metadata

  • Download URL: nuqql-0.12.0-py3-none-any.whl
  • Upload date:
  • Size: 55.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.8.2 readme-renderer/34.0 requests/2.27.1 requests-toolbelt/0.9.1 urllib3/1.26.8 tqdm/4.63.0 importlib-metadata/4.11.2 keyring/23.5.0 rfc3986/2.0.0 colorama/0.4.4 CPython/3.10.2

File hashes

Hashes for nuqql-0.12.0-py3-none-any.whl
Algorithm Hash digest
SHA256 daa0e661763a0ca1e2563a48354d490bce60a5291aa132436431ae81a6d51c89
MD5 07608313ff2ea57df92db6d0743bfa62
BLAKE2b-256 731aa09192c4689de96b1f8bd63ae9f7df70bd2f0ae94b63620b27fd0dbef83b

See more details on using hashes here.

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