2021-07-03 09:22:37 +03:00
|
|
|
# iamb
|
|
|
|
|
|
2023-01-07 03:56:28 +03:00
|
|
|
[](https://github.com/ulyssa/iamb/actions?query=workflow%3ACI+)
|
|
|
|
|
[](https://crates.io/crates/iamb)
|
|
|
|
|
[](https://crates.io/crates/iamb)
|
|
|
|
|
|
2021-07-03 09:22:37 +03:00
|
|
|
## About
|
|
|
|
|
|
2022-12-30 05:00:59 +03:00
|
|
|
`iamb` is a Matrix client for the terminal that uses Vim keybindings.
|
2021-07-03 09:22:37 +03:00
|
|
|
|
2022-12-30 05:00:59 +03:00
|
|
|
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.
|
2021-07-03 09:22:37 +03:00
|
|
|
|
2023-01-06 05:37:58 +03:00
|
|
|
## Documentation
|
|
|
|
|
|
|
|
|
|
You can find documentation for installing, configuring, and using iamb on its
|
|
|
|
|
website, [iamb.chat].
|
|
|
|
|
|
2021-07-03 09:22:37 +03:00
|
|
|
## Installation
|
|
|
|
|
|
|
|
|
|
Install Rust and Cargo, and then run:
|
|
|
|
|
|
|
|
|
|
```
|
2023-01-24 04:08:11 +03:00
|
|
|
cargo install --locked iamb
|
2021-07-03 09:22:37 +03:00
|
|
|
```
|
|
|
|
|
|
2022-12-30 05:00:59 +03:00
|
|
|
## Configuration
|
|
|
|
|
|
|
|
|
|
You can create a basic configuration in `$CONFIG_DIR/iamb/config.json` that looks like:
|
|
|
|
|
|
|
|
|
|
```json
|
|
|
|
|
{
|
|
|
|
|
"profiles": {
|
|
|
|
|
"example.com": {
|
|
|
|
|
"url": "https://example.com",
|
2023-01-04 00:57:28 +03:00
|
|
|
"user_id": "@user:example.com"
|
2022-12-30 05:00:59 +03:00
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
2022-12-30 07:25:38 +03:00
|
|
|
## 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][client-comparison-matrix], showing
|
|
|
|
|
two other TUI clients and Element Web:
|
|
|
|
|
|
2023-01-14 05:02:58 +03:00
|
|
|
| | iamb | [gomuks] | [weechat-matrix] | Element Web/Desktop |
|
|
|
|
|
| --------------------------------------- | :---------- | :------: | :--------------: | :-----------------: |
|
|
|
|
|
| Room directory | ❌ ([#14]) | ❌ | ✔️ | ✔️ |
|
2023-01-29 01:24:08 +03:00
|
|
|
| Room tag showing | ✔️ | ✔️ | ❌ | ✔️ |
|
2023-01-26 04:54:16 +03:00
|
|
|
| Room tag editing | ✔️ | ✔️ | ❌ | ✔️ |
|
2023-01-14 05:02:58 +03:00
|
|
|
| Search joined rooms | ❌ ([#16]) | ✔️ | ❌ | ✔️ |
|
|
|
|
|
| Room user list | ✔️ | ✔️ | ✔️ | ✔️ |
|
|
|
|
|
| Display Room Description | ✔️ | ✔️ | ✔️ | ✔️ |
|
|
|
|
|
| Edit Room Description | ✔️ | ❌ | ✔️ | ✔️ |
|
|
|
|
|
| Highlights | ❌ ([#8]) | ✔️ | ✔️ | ✔️ |
|
|
|
|
|
| Pushrules | ❌ | ✔️ | ❌ | ✔️ |
|
2023-01-29 01:24:08 +03:00
|
|
|
| Send read markers | ✔️ | ✔️ | ✔️ | ✔️ |
|
|
|
|
|
| Display read markers | ✔️ | ❌ | ❌ | ✔️ |
|
2023-01-14 05:02:58 +03:00
|
|
|
| Sending Invites | ✔️ | ✔️ | ✔️ | ✔️ |
|
|
|
|
|
| Accepting Invites | ✔️ | ✔️ | ✔️ | ✔️ |
|
|
|
|
|
| Typing Notification | ✔️ | ✔️ | ✔️ | ✔️ |
|
|
|
|
|
| E2E | ✔️ | ✔️ | ✔️ | ✔️ |
|
|
|
|
|
| Replies | ✔️ | ✔️ | ❌ | ✔️ |
|
|
|
|
|
| Attachment uploading | ✔️ | ❌ | ✔️ | ✔️ |
|
|
|
|
|
| Attachment downloading | ✔️ | ✔️ | ✔️ | ✔️ |
|
|
|
|
|
| Send stickers | ❌ | ❌ | ❌ | ✔️ |
|
2023-01-24 04:08:11 +03:00
|
|
|
| Send formatted messages (markdown) | ✔️ | ✔️ | ✔️ | ✔️ |
|
2023-01-14 05:02:58 +03:00
|
|
|
| Rich Text Editor for formatted messages | ❌ | ❌ | ❌ | ✔️ |
|
2023-01-24 04:08:11 +03:00
|
|
|
| Display formatted messages | ✔️ | ✔️ | ✔️ | ✔️ |
|
2023-01-14 05:02:58 +03:00
|
|
|
| Redacting | ✔️ | ✔️ | ✔️ | ✔️ |
|
|
|
|
|
| Multiple Matrix Accounts | ✔️ | ❌ | ✔️ | ❌ |
|
|
|
|
|
| New user registration | ❌ | ❌ | ❌ | ✔️ |
|
|
|
|
|
| VOIP | ❌ | ❌ | ❌ | ✔️ |
|
|
|
|
|
| Reactions | ❌ ([#2]) | ✔️ | ❌ | ✔️ |
|
2023-01-20 03:05:02 +03:00
|
|
|
| Message editing | ✔️ | ✔️ | ❌ | ✔️ |
|
2023-01-14 05:02:58 +03:00
|
|
|
| Room upgrades | ❌ | ✔️ | ❌ | ✔️ |
|
|
|
|
|
| Localisations | ❌ | 1 | ❌ | 44 |
|
|
|
|
|
| SSO Support | ❌ | ✔️ | ✔️ | ✔️ |
|
2022-12-30 07:25:38 +03:00
|
|
|
|
2021-07-03 09:22:37 +03:00
|
|
|
## License
|
|
|
|
|
|
|
|
|
|
iamb is released under the [Apache License, Version 2.0].
|
|
|
|
|
|
|
|
|
|
[Apache License, Version 2.0]: https://github.com/ulyssa/iamb/blob/master/LICENSE
|
2022-12-30 07:25:38 +03:00
|
|
|
[client-comparison-matrix]: https://matrix.org/clients-matrix/
|
2023-01-06 05:37:58 +03:00
|
|
|
[iamb.chat]: https://iamb.chat
|
2022-12-30 07:25:38 +03:00
|
|
|
[gomuks]: https://github.com/tulir/gomuks
|
|
|
|
|
[weechat-matrix]: https://github.com/poljar/weechat-matrix
|
|
|
|
|
[#2]: https://github.com/ulyssa/iamb/issues/2
|
|
|
|
|
[#3]: https://github.com/ulyssa/iamb/issues/3
|
|
|
|
|
[#4]: https://github.com/ulyssa/iamb/issues/4
|
|
|
|
|
[#5]: https://github.com/ulyssa/iamb/issues/5
|
|
|
|
|
[#6]: https://github.com/ulyssa/iamb/issues/6
|
|
|
|
|
[#7]: https://github.com/ulyssa/iamb/issues/7
|
|
|
|
|
[#8]: https://github.com/ulyssa/iamb/issues/8
|
|
|
|
|
[#9]: https://github.com/ulyssa/iamb/issues/9
|
|
|
|
|
[#10]: https://github.com/ulyssa/iamb/issues/10
|
|
|
|
|
[#11]: https://github.com/ulyssa/iamb/issues/11
|
|
|
|
|
[#12]: https://github.com/ulyssa/iamb/issues/12
|
|
|
|
|
[#13]: https://github.com/ulyssa/iamb/issues/13
|
|
|
|
|
[#14]: https://github.com/ulyssa/iamb/issues/14
|
|
|
|
|
[#15]: https://github.com/ulyssa/iamb/issues/15
|
|
|
|
|
[#16]: https://github.com/ulyssa/iamb/issues/16
|
