AminetAminet
Search:
85852 packages online
• About
• Recent
• Browse
• Search
• Upload
• Setup
• Services

comm/misc/Amatrix.lha

Mirror:Random
Showing: m68k-amigaos icongeneric icon
No screenshot available
Short:Matrix chat client, E2E encrypted (MUI)
Author:Oliver Urbann
Uploader:oliver urbann gmail com (Oliver Urbann)
Type:comm/misc
Version:0.2
Architecture:m68k-amigaos >= 3.0.0
Date:2026-11-16
Requires:MUI 5 (NList, BetterString), AmiSSL 5, TCP/IP stack, 68020+
Distribution:Aminet
Download:comm/misc/Amatrix.lha - View contents
Readme:comm/misc/Amatrix.readme
Downloads:27

=== English ===

Amatrix is a native Matrix client for classic AmigaOS, written in C for
the 68020 and better.  It talks to a Matrix server directly: no bridge,
no proxy.  Matrix is an open protocol for chat (matrix.org); Amatrix
connects to the Matrix network and chats with Element, FluffyChat and the
other clients.  The user interface is MUI: a list of chats and rooms with
pictures on the left, one chat window per room.

Features

- End-to-end encryption (Olm/Megolm) in both directions, key backup and
  security key, so that encrypted history is readable (libolm, ported)
- Direct chats, rooms, spaces, invitations, room settings, members with
  roles, remove/ban, knocking, room upgrades
- Replies, edits, deletes, threads, reactions, pinned messages, polls,
  formatted messages (bold, italic, lists, code), Markdown while typing
- Pictures, files, voice messages: previews in the chat, send with the file
  requester or by dropping Workbench icons into the window
- Link previews, locations, emojis as small pictures, typing notices and
  read receipts ("read by ...")
- Search in all rooms, export a chat as text or HTML, drafts, history kept
  locally and shown at once at start
- Notifications through Herald, AppIcon with unread marker when iconified
- Password for the stored data (AES-256), several sessions, own profile
- Full ARexx port (AMATRIX.1)
- Languages (locale.library catalogs): English (built in), Deutsch,
  Francais, Espanol, Italiano, Nederlands, Svenska.  Amatrix follows the
  Locale preferences; the tool type or argument LANGUAGE=english (or
  deutsch, ...) forces one.  The translations other than German and
  English are machine-assisted and not yet reviewed by native speakers.
  A new language needs only a translation file (see the source).

Requirements
- 68020 or better
- MUI 5 (muimaster.library V20) with NList.mcc and BetterString.mcc
  (both are in the MUI 5 "contrib" package)
- AmiSSL 5 and a running TCP/IP stack (Roadshow, AmiTCP, ...)
- Optional: Herald (Aminet util/cdity/Herald) for notifications,
  openurl.library to open links, opusdec for voice messages

An account to log in with
You need a Matrix account with a user name and a PASSWORD on a server that
allows password logins (matrix.org does).  Accounts that only work
through single sign-on ("Continue with Google/GitHub/...") or the newer
browser login cannot log in.  If your account has no password yet, set
one in Element first (Settings > Account > Change password).

Installation
Copy the drawer "Amatrix" wherever you like and double click "Amatrix".
Program, icon and language catalogs are all inside the drawer.

Documentation
Amatrix.guide (AmigaGuide, open it with MultiView) is the manual: first
start (login, password for the stored data, verifying the device with the
security key), every menu and button, all functions and the complete ARexx
reference.  It is in the drawer; Amatrix.de.guide is the German version.

Known bugs
- Thin horizontal lines sometimes appear in picture previews, mostly
  while scrolling (NList does not draw the bottom row of a strip now and
  then).
- MorphOS (reported, possibly MorphOS-specific, since Amatrix has been
  tested only with MUI 5 on OS 3 so far): the room list in the main
  window shows its entries without any text; the space choice above it
  shows the last space twice and leaves out another one.

Credits and licences
Amatrix uses libolm (Apache-2.0), cJSON (MIT), stb_image (public domain),
the AmiSSL SDK (Apache-2.0) and the MUI SDK (not included).  Their texts
are in the source tree (third_party/).  Matrix is an open standard of the
Matrix.org Foundation; Element is a trademark of Element.  The drawer,
readme and guide icons are based on MagicWB icons by Martin Huttenloher
and Mario Cattaneo.

Source code, bug reports, how to add a language:
https://github.com/OliverUrbann/Amatrix

Bug reports and ideas are welcome - please open an issue on GitHub (the
version, what you did and what you expected help a lot).

Security: Amatrix handles your login and your encryption keys, so you
should not have to take its safety on trust.  The complete source code is
public at the address above; this archive is built from it.  If you want
to convince yourself, read the code or let an AI of your choice review it,
and ask it what Amatrix stores, what it sends where, and how it handles
keys and passwords.  Findings are very welcome as an issue.

Licence: MIT, Copyright (c) 2026 Oliver Urbann.  Free to use, copy, modify
and distribute; provided as is, without warranty.  The full text is in the
source repository (LICENSE).

Changelog

0.2 (15.11.2026)
- Fixed: login failed with "HTTP 400 M_NOT_JSON Body is not a valid JSON
  document" (or "Content not JSON") when the password contains an umlaut
  or another non-ASCII character (German umlauts, sharp s, ...).
  Amatrix sent the password in the Amiga character set instead of
  UTF-8.  The same for signing out other sessions in the sessions window.
- Fixed: a reply showed "(an older message)" instead of the quote when
  it was loaded before the message it answers.  Replies from clients
  that put the relation outside the encryption are now recognised.
- Fixed: picture lines in the chat read "[_Picture ...: name]".
- New drawer, program, readme and guide icons.

0.1 (14.11.2026)
- First release.

=== Deutsch ===

Amatrix ist ein nativer Matrix-Client fuer das klassische AmigaOS, in C
fuer 68020 und besser geschrieben.  Er spricht direkt mit dem Matrix-
Server: keine Bruecke, kein Proxy.  Matrix ist ein offenes Chat-Protokoll
(matrix.org); Amatrix verbindet sich mit dem Matrix-Netzwerk und chattet
mit Element, FluffyChat und den anderen Clients.  Die Oberflaeche ist MUI:
links die Liste der Chats und Raeume mit Bildern, pro Raum ein Chatfenster.

Merkmale

- Ende-zu-Ende-Verschluesselung (Olm/Megolm) in beide Richtungen,
  Schluessel-Backup und Sicherheitsschluessel, damit verschluesselter Verlauf
  lesbar ist (libolm, portiert)
- Direktchats, Raeume, Spaces, Einladungen, Raum-Einstellungen, Mitglieder
  mit Rollen, Entfernen/Sperren, Anklopfen, Raum-Upgrades
- Antworten, Bearbeiten, Loeschen, Threads, Reaktionen, angeheftete
  Nachrichten, Umfragen, formatierte Nachrichten (fett, kursiv, Listen,
  Code), Markdown beim Tippen
- Bilder, Dateien, Sprachnachrichten: Vorschau im Chat, Senden mit dem
  Dateirequester oder per Drag-and-drop von Workbench-Icons ins Fenster
- Link-Vorschauen, Standorte, Emojis als kleine Bilder, Tippanzeige und
  Lesebestaetigungen ("gelesen von ...")
- Suche in allen Raeumen, Chat als Text oder HTML exportieren, Entwuerfe,
  Verlauf lokal gespeichert und beim Start sofort sichtbar
- Benachrichtigungen ueber Herald, AppIcon mit Ungelesen-Markierung beim
  Ikonifizieren
- Passwort fuer die gespeicherten Daten (AES-256), mehrere Sitzungen,
  eigenes Profil
- Vollstaendiger ARexx-Port (AMATRIX.1)
- Sprachen (locale.library-Kataloge): Englisch (eingebaut), Deutsch,
  Francais, Espanol, Italiano, Nederlands, Svenska.  Amatrix folgt den
  Locale-Einstellungen; der Tooltype bzw. das Argument LANGUAGE=english
  (oder deutsch, ...) erzwingt eine.  Die Uebersetzungen ausser Deutsch und
  Englisch sind maschinell unterstuetzt und noch nicht von Muttersprachlern
  geprueft.  Eine neue Sprache braucht nur eine Uebersetzungsdatei (siehe
  Quellcode).

Voraussetzungen
- 68020 oder besser
- MUI 5 (muimaster.library V20) mit NList.mcc und BetterString.mcc
  (beide im MUI-5-Paket "contrib" enthalten)
- AmiSSL 5 und ein laufender TCP/IP-Stack (Roadshow, AmiTCP, ...)
- Optional: Herald (Aminet util/cdity/Herald) fuer Benachrichtigungen,
  openurl.library zum Oeffnen von Links, opusdec fuer Sprachnachrichten

Ein Konto zum Anmelden
Noetig ist ein Matrix-Konto mit Benutzername und PASSWORT auf einem Server,
der Passwort-Anmeldung erlaubt (matrix.org tut das).  Konten, die nur ueber
Single Sign-on ("Weiter mit Google/GitHub/...") oder die neuere Browser-
Anmeldung funktionieren, koennen sich nicht anmelden.  Hat dein Konto noch
kein Passwort, vergib zuerst in Element eines (Einstellungen > Konto >
Passwort aendern).

Installation
Die Schublade "Amatrix" an einen beliebigen Ort kopieren und "Amatrix"
doppelklicken.  Programm, Icon und Sprachkataloge liegen alle darin.

Dokumentation
Amatrix.de.guide (AmigaGuide, mit MultiView oeffnen) ist das Handbuch:
erster Start (Anmeldung, Passwort fuer die gespeicherten Daten, Geraet mit
dem Sicherheitsschluessel verifizieren), jedes Menue und jeder Knopf, alle
Funktionen und die vollstaendige ARexx-Referenz (englisch).  Es liegt in
der Schublade; Amatrix.guide ist die englische Fassung.

Bekannte Fehler
- In Bildvorschauen erscheinen manchmal duenne waagerechte Linien, meist
  beim Scrollen (NList zeichnet die unterste Zeile eines Streifens hin und
  wieder nicht).
- MorphOS (gemeldet, moeglicherweise MorphOS-spezifisch, da Amatrix
  bisher nur mit MUI 5 unter OS 3 getestet ist): Die Raumliste im
  Hauptfenster zeigt ihre Eintraege ohne Text; die Space-Auswahl darueber
  zeigt den letzten Space doppelt und laesst einen anderen weg.

Credits und Lizenzen
Amatrix benutzt libolm (Apache-2.0), cJSON (MIT), stb_image (Public
Domain), das AmiSSL-SDK (Apache-2.0) und das MUI-SDK (nicht enthalten).
Die Texte liegen im Quellbaum (third_party/).  Matrix ist ein offener
Standard der Matrix.org Foundation; Element ist eine Marke von Element.
Die Icons fuer Schublade, Readme und Guide beruhen auf MagicWB-Icons von
Martin Huttenloher und Mario Cattaneo.

Quellcode, Fehlermeldungen, Sprache hinzufuegen:
https://github.com/OliverUrbann/Amatrix

Fehlermeldungen und Ideen sind willkommen - bitte ein Issue auf GitHub
eroeffnen (Version, was du getan hast und was du erwartet hast, helfen sehr).

Sicherheit: Amatrix verarbeitet deine Anmeldung und deine Schluessel, du
sollst seine Sicherheit also nicht auf Treu und Glauben annehmen muessen.
Der komplette Quellcode ist unter der obigen Adresse oeffentlich; dieses
Archiv wird daraus gebaut.  Wenn du dich selbst ueberzeugen willst, lies den
Code oder lass ihn von einer KI deiner Wahl pruefen und frag sie, was
Amatrix speichert, was es wohin sendet und wie es mit Schluesseln und
Passwoertern umgeht.  Ergebnisse sind als Issue sehr willkommen.

Lizenz: MIT, Copyright (c) 2026 Oliver Urbann.  Frei nutz-, kopier-, aender-
und weitergebbar; ohne Gewaehrleistung.  Der volle Text liegt im
Quellcode-Repository (LICENSE).

Aenderungen

0.2 (15.11.2026)
- Behoben: Die Anmeldung scheiterte mit "HTTP 400 M_NOT_JSON Body is not
  a valid JSON document" (bzw. "Content not JSON"), wenn das Passwort
  einen Umlaut oder ein anderes Nicht-ASCII-Zeichen enthaelt (Umlaute,
  Eszett, Paragraphzeichen ...).  Amatrix schickte das Passwort im
  Amiga-Zeichensatz statt in UTF-8.  Ebenso beim Abmelden anderer
  Sitzungen im Sitzungsfenster.
- Behoben: Eine Antwort zeigte "(eine aeltere Nachricht)" statt des
  Zitats, wenn sie vor der beantworteten Nachricht geladen wurde.
  Antworten von Clients, die die Beziehung ausserhalb der Verschluesselung
  senden, werden jetzt erkannt.
- Behoben: Bildzeilen im Chat lauteten "[_Bild ...: name]".
- Neue Icons fuer Schublade, Programm, Readme und Guide.

0.1 (14.11.2026)
- Erste Version.


Contents of comm/misc/Amatrix.lha
 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
drwxr-xr-x     0/0           0       0 ****** -lhd- 0000 Nov 15 20:23 Amatrix/
-rwxr-xr-x     0/0      327559  603164  54.3% -lh5- 074e Nov 15 20:23 Amatrix/Amatrix
-rw-r--r--     0/0       19121   60554  31.6% -lh5- 943b Nov 15 20:23 Amatrix/Amatrix.de.guide
-rw-r--r--     0/0        1137    5037  22.6% -lh5- 5e5a Nov 15 20:23 Amatrix/Amatrix.de.guide.info
-rw-r--r--     0/0       18056   58445  30.9% -lh5- 527f Nov 15 20:23 Amatrix/Amatrix.guide
-rw-r--r--     0/0        1137    5037  22.6% -lh5- 5e5a Nov 15 20:23 Amatrix/Amatrix.guide.info
-rw-r--r--     0/0         960    5013  19.2% -lh5- 8082 Nov 15 20:23 Amatrix/Amatrix.info
-rw-r--r--     0/0        5260   11536  45.6% -lh5- 49b3 Nov 15 20:23 Amatrix/Amatrix.readme
-rw-r--r--     0/0        1075    5041  21.3% -lh5- 5995 Nov 15 20:23 Amatrix/Amatrix.readme.info
drwxr-xr-x     0/0           0       0 ****** -lhd- 0000 Nov 15 20:23 Amatrix/Catalogs/
drwxr-xr-x     0/0           0       0 ****** -lhd- 0000 Nov 15 20:23 Amatrix/Catalogs/deutsch/
-rw-r--r--     0/0        7201   16968  42.4% -lh5- 1323 Nov 15 20:23 Amatrix/Catalogs/deutsch/amatrix.catalog
drwxr-xr-x     0/0           0       0 ****** -lhd- 0000 Nov 15 20:23 Amatrix/Catalogs/espa?ol/
-rw-r--r--     0/0        7127   16772  42.5% -lh5- 0bf9 Nov 15 20:23 Amatrix/Catalogs/espa?ol/amatrix.catalog
drwxr-xr-x     0/0           0       0 ****** -lhd- 0000 Nov 15 20:23 Amatrix/Catalogs/fran?ais/
-rw-r--r--     0/0        7316   17346  42.2% -lh5- 2636 Nov 15 20:23 Amatrix/Catalogs/fran?ais/amatrix.catalog
drwxr-xr-x     0/0           0       0 ****** -lhd- 0000 Nov 15 20:23 Amatrix/Catalogs/italiano/
-rw-r--r--     0/0        7034   16902  41.6% -lh5- 3256 Nov 15 20:23 Amatrix/Catalogs/italiano/amatrix.catalog
drwxr-xr-x     0/0           0       0 ****** -lhd- 0000 Nov 15 20:23 Amatrix/Catalogs/nederlands/
-rw-r--r--     0/0        7049   16844  41.8% -lh5- 1ca2 Nov 15 20:23 Amatrix/Catalogs/nederlands/amatrix.catalog
drwxr-xr-x     0/0           0       0 ****** -lhd- 0000 Nov 15 20:23 Amatrix/Catalogs/svenska/
-rw-r--r--     0/0        6896   15964  43.2% -lh5- e72c Nov 15 20:23 Amatrix/Catalogs/svenska/amatrix.catalog
drwxr-xr-x     0/0           0       0 ****** -lhd- 0000 Nov 15 20:23 Amatrix/Icons/
-rw-r--r--     0/0        1011    5013  20.2% -lh5- 45c0 Nov 15 20:23 Amatrix/Icons/Amatrix-neu.info
-rw-r--r--     0/0        1050    3739  28.1% -lh5- 3513 Nov 15 20:23 Amatrix.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        25 files  418989  863375  48.5%            Nov 16 01:37
Page generated in 0.01 seconds
Aminet © 1992-2024 Urban Müller and the Aminet team. Aminet contact address: <aminetaminet net>