=== 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).
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).
=== Deutsch ===
Amatrix ist ein nativer Matrix-Client für das klassische AmigaOS, in C
für 68020 und besser geschrieben. Er spricht direkt mit dem Matrix-
Server: keine Brücke, 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 Oberfläche ist MUI:
links die Liste der Chats und Räume mit Bildern, pro Raum ein Chatfenster.
Merkmale
- Ende-zu-Ende-Verschlüsselung (Olm/Megolm) in beide Richtungen,
Schlüssel-Backup und Sicherheitsschlüssel, damit verschlüsselter Verlauf
lesbar ist (libolm, portiert)
- Direktchats, Räume, Spaces, Einladungen, Raum-Einstellungen, Mitglieder
mit Rollen, Entfernen/Sperren, Anklopfen, Raum-Upgrades
- Antworten, Bearbeiten, Löschen, 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
Lesebestätigungen ("gelesen von ...")
- Suche in allen Räumen, Chat als Text oder HTML exportieren, Entwürfe,
Verlauf lokal gespeichert und beim Start sofort sichtbar
- Benachrichtigungen über Herald, AppIcon mit Ungelesen-Markierung beim
Ikonifizieren
- Passwort für die gespeicherten Daten (AES-256), mehrere Sitzungen,
eigenes Profil
- Vollständiger 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 Übersetzungen außer Deutsch und
Englisch sind maschinell unterstützt und noch nicht von Muttersprachlern
geprüft. Eine neue Sprache braucht nur eine Übersetzungsdatei (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) für Benachrichtigungen,
openurl.library zum Öffnen von Links, opusdec für Sprachnachrichten
Ein Konto zum Anmelden
Nötig ist ein Matrix-Konto mit Benutzername und PASSWORT auf einem Server,
der Passwort-Anmeldung erlaubt (matrix.org tut das). Konten, die nur über
Single Sign-on ("Weiter mit Google/GitHub/...") oder die neuere Browser-
Anmeldung funktionieren, können sich nicht anmelden. Hat dein Konto noch
kein Passwort, vergib zuerst in Element eines (Einstellungen > Konto >
Passwort ändern).
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 öffnen) ist das Handbuch:
erster Start (Anmeldung, Passwort für die gespeicherten Daten, Gerät mit
dem Sicherheitsschlüssel verifizieren), jedes Menü und jeder Knopf, alle
Funktionen und die vollständige ARexx-Referenz (englisch). Es liegt in
der Schublade; Amatrix.guide ist die englische Fassung.
Bekannte Fehler
In Bildvorschauen erscheinen manchmal dünne waagerechte Linien, meist beim
Scrollen (NList zeichnet die unterste Zeile eines Streifens hin und
wieder nicht).
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 für Schublade, Readme und Guide beruhen auf MagicWB-Icons von
Martin Huttenloher und Mario Cattaneo.
Quellcode, Fehlermeldungen, Sprache hinzufügen:
https://github.com/OliverUrbann/Amatrix
Fehlermeldungen und Ideen sind willkommen - bitte ein Issue auf GitHub
eröffnen (Version, was du getan hast und was du erwartet hast, helfen sehr).
Sicherheit: Amatrix verarbeitet deine Anmeldung und deine Schlüssel, du
sollst seine Sicherheit also nicht auf Treu und Glauben annehmen müssen.
Der komplette Quellcode ist unter der obigen Adresse öffentlich; dieses
Archiv wird daraus gebaut. Wenn du dich selbst überzeugen willst, lies den
Code oder lass ihn von einer KI deiner Wahl prüfen und frag sie, was
Amatrix speichert, was es wohin sendet und wie es mit Schlüsseln und
Passwörtern umgeht. Ergebnisse sind als Issue sehr willkommen.
Lizenz: MIT, Copyright (c) 2026 Oliver Urbann. Frei nutz-, kopier-, änder-
und weitergebbar; ohne Gewährleistung. Der volle Text liegt im
Quellcode-Repository (LICENSE).
History / Verlauf
0.1 First release / Erste Version.
|