Skip to content

ulyssa/iamb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

e66a8c6 · Feb 18, 2025
Feb 18, 2025
Sep 17, 2024
Feb 18, 2025
Dec 19, 2023
Mar 28, 2024
Mar 26, 2024
Dec 30, 2022
Jan 3, 2023
Feb 18, 2025
Feb 18, 2025
Apr 24, 2024
Aug 15, 2024
Feb 18, 2025
Mar 26, 2024
Apr 12, 2024
Feb 18, 2025
May 25, 2024
Mar 28, 2024

Repository files navigation

About

iamb is a Matrix client for the terminal that uses Vim keybindings. It includes support for:

  • Threads, spaces, E2EE, and read receipts
  • Image previews in terminals that support it (sixels, Kitty, and iTerm2), or using pixelated blocks for those that don't
  • Notifications via terminal bell or desktop environment
  • Send Markdown, HTML or plaintext messages
  • Creating, joining, and leaving rooms
  • Sending and accepting room invitations
  • Editing, redacting, and reacting to messages
  • Custom keybindings
  • Multiple profiles

You may want to see this page as it was when the latest version was published.

Documentation

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

Configuration

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

[profiles."example.com"]
user_id = "@user:example.com"

If you homeserver is located on a different domain than the server part of the user_id and you don't have a /.well-known entry, then you can explicitly specify the homeserver URL to use:

[profiles."example.com"]
url = "https://example.com"
user_id = "@user:example.com"

Installation (via crates.io)

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

cargo install --locked iamb

See Configuration for getting a profile set up.

Installation (via package managers)

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

FreeBSD

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

pkg install iamb

macOS

On macOS a package is availabe in Homebrew's repository. To install it simply run:

brew install iamb

NetBSD

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

pkgin install iamb

Nix / NixOS (flake)

nix profile install "github:ulyssa/iamb"

openSUSE Tumbleweed

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

zypper install iamb

Snap

A snap for Linux distributions which support the packaging system.

snap install iamb

License

iamb is released under the Apache License, Version 2.0.