💾 Archived View for altesq.net › ~masqq › wiki › gomuks.gmi captured on 2022-06-03 at 23:01:29. Gemini links have been rewritten to link to archived content
-=-=-=-=-=-=-
gomuks is a matrix client for those who prefer cli programs. it's very lightweight and has a plethora of features, for example image preview support, replies & more.
depending on your distribution, download gomuks. as of writing this, gomuks has packages for the aur, nixos, opensuse, alpine and macos. if you cannot find your os in this list, head to the releases page and grab a binary for your architecture.
open gomuks from the terminal with "gomuks", then login with your username and password for your homeserver. once it syncs, you might be surprised that you cannot see any of your past messages! see below on how to fix this.
in order for gomuks to be able to decrypt past messages in all of your rooms, it needs your encryption keys, as it doesn't get them automatically. in this example i'll use element, but you can use any client that has support for exporting room keys.
first, click your profile picture > security & privacy. once you're there look in the "cryptography" section, and click "export e2e room keys", you'll get prompted for your secure passphrase you set or element has generated for you (not your password!). you'll end up with a file called element-keys.txt, keep it since we'll need it later.
now go back to gomuks, and type /import /home/<user>/downloads/element-keys.txt, keep in mind the path must be an absolute path (e.g. no ~/) and substitute the downloads folder for where you saved the keys.\
after importing, you'll see it's exactly the same! don't panic, as gomuks must clear it's cache. do /clearcache and open gomuks again, you'll see all of your messages loading.
you'll see that your session is unverified and verified rooms don't trust it. gomuks doesn't support incoming emoji verification, only outgoing, but it's quite broken as i'm writing this. we'll use the cross-signing keys to verify the new session.
type /cross-signing fetch in order to get the cross-signing keys from your other sessions. once you have them, write /cross-signing self-sign, which should verify the current device. you can check if this has been successful with /cross-signing status.
et voila! you should have your session verified and all of your encrypted rooms trusting it (including your other devices).
if you want to get a more irc-styled messaging box, you can easily type /toggle baremessages and you have it.
to download messages just select the message and type /download and it'll get downloaded to your device.
you can react with /react and edit messages with /edit.
gomuks has many commands, for a complete list check the link below to the official doccumentation.
---