ulyssa/iamb
1
1
Fork 0
mirror of https://github.com/ulyssa/iamb.git synced 2024-09-19 07:38:12 +03:00
Code Issues Packages Projects Releases Wiki Activity
A Matrix client for Vim addicts
103 Commits 3 Branches 10 Tags 2.2 MiB
Rust 99.8%
Nix 0.2%
221faa828d
Go to file
Benjamin Grosse 221faa828d
Add support for previewing images in room scrollback (#108)
2023-11-16 08:36:22 -08:00
.github Add support for previewing images in room scrollback (#108) 2023-11-16 08:36:22 -08:00
docs Add support for previewing images in room scrollback (#108) 2023-11-16 08:36:22 -08:00
src Add support for previewing images in room scrollback (#108) 2023-11-16 08:36:22 -08:00
.gitattributes Want a Matrix client that uses Vim keybindings (#1) 2022-12-29 18:00:59 -08:00
.gitignore Fix Nix flake build on Darwin (#117) 2023-06-22 23:05:50 -07:00
.rustfmt.toml Want a Matrix client that uses Vim keybindings (#1) 2022-12-29 18:00:59 -08:00
build.rs Release v0.0.8 (fix cargo publish issues) (#134) 2023-07-07 23:21:47 -07:00
Cargo.lock Add support for previewing images in room scrollback (#108) 2023-11-16 08:36:22 -08:00
Cargo.toml Add support for previewing images in room scrollback (#108) 2023-11-16 08:36:22 -08:00
CONTRIBUTING.md Support sending and displaying typing notifications (#9) 2023-01-03 13:57:28 -08:00
flake.lock Add Nix flake (#73) 2023-03-31 11:43:22 -07:00
flake.nix Add support for previewing images in room scrollback (#108) 2023-11-16 08:36:22 -08:00
iamb.desktop feat: desktop file for GUI environment launchers (#178) 2023-11-14 12:19:54 -08:00
LICENSE Initial commit 2021-07-02 23:22:37 -07:00
README.md Add support for previewing images in room scrollback (#108) 2023-11-16 08:36:22 -08:00

README.md

iamb

Build Status License: Apache 2.0 #iamb:0x.badd.cafe Latest Version

About

iamb is a Matrix client for the terminal that uses Vim keybindings.

This project is a work-in-progress, and there's still a lot to be implemented, but much of the basic client functionality is already present.

Example Usage

Documentation

You can find documentation for installing, configuring, and using iamb on its website, iamb.chat.

Installation

Install Rust (1.67.0 or above) and Cargo, and then run:

cargo install --locked iamb

NetBSD

On NetBSD a package is available from the official repositories. To install it simply run:

pkgin install iamb

Arch Linux

On Arch Linux a package is available in the Arch User Repositories (AUR). To install it simply run with your favorite AUR helper:

paru iamb-git

Nix / NixOS (flake)

nix profile install "github:ulyssa/iamb"

Configuration

You can create a basic configuration in $CONFIG_DIR/iamb/config.json that looks like:

{
    "profiles": {
        "example.com": {
            "url": "https://example.com",
            "user_id": "@user:example.com"
        }
    }
}

Comparison With Other Clients

To get an idea of what is and isn't yet implemented, here is a subset of the Matrix website's features comparison table, showing two other TUI clients and Element Web:

iamb gomuks weechat-matrix Element Web/Desktop
Room directory ❌ (#14) ❌ ✔️ ✔️
Room tag showing ✔️ ✔️ ❌ ✔️
Room tag editing ✔️ ✔️ ❌ ✔️
Search joined rooms ❌ (#16) ✔️ ❌ ✔️
Room user list ✔️ ✔️ ✔️ ✔️
Display Room Description ✔️ ✔️ ✔️ ✔️
Edit Room Description ✔️ ❌ ✔️ ✔️
Highlights ❌ (#8) ✔️ ✔️ ✔️
Pushrules ❌ ✔️ ❌ ✔️
Send read markers ✔️ ✔️ ✔️ ✔️
Display read markers ✔️ ❌ ❌ ✔️
Sending Invites ✔️ ✔️ ✔️ ✔️
Accepting Invites ✔️ ✔️ ✔️ ✔️
Typing Notification ✔️ ✔️ ✔️ ✔️
E2E ✔️ ✔️ ✔️ ✔️
Replies ✔️ ✔️ ❌ ✔️
Attachment uploading ✔️ ❌ ✔️ ✔️
Attachment downloading ✔️ ✔️ ✔️ ✔️
Send stickers ❌ ❌ ❌ ✔️
Send formatted messages (markdown) ✔️ ✔️ ✔️ ✔️
Rich Text Editor for formatted messages ❌ ❌ ❌ ✔️
Display formatted messages ✔️ ✔️ ✔️ ✔️
Redacting ✔️ ✔️ ✔️ ✔️
Multiple Matrix Accounts ✔️ ❌ ✔️ ❌
New user registration ❌ ❌ ❌ ✔️
VOIP ❌ ❌ ❌ ✔️
Reactions ✔️ ✔️ ❌ ✔️
Message editing ✔️ ✔️ ❌ ✔️
Room upgrades ❌ (#41) ✔️ ❌ ✔️
Localisations ❌ 1 ❌ 44
SSO Support ✔️ ✔️ ✔️ ✔️
Image preview ✔️ ❌ ❌ ✔️

License

iamb is released under the Apache License, Version 2.0.