LumiGram

LumiGram is a Telegram client for AmigaOS 4 with a MUI interface.
It talks to the Telegram servers itself, over MTProto 2.0, with no
gateway or helper computer in between. You log in with your phone
number as on any other device, and your chats, groups and channels
appear on the Amiga as they do on the phone.

The window follows the look of Telegram Desktop: folders on the
left, the chat list next to them, the conversation in the middle
and the info column on the right, in a light or a dark theme. It
is part of the Lumi suite and shares its menu and its settings
file with the other tools.

LumiGram is an unofficial client. It is not made or endorsed by
Telegram.


FEATURES
--------

  - Native MTProto 2.0, no gateway; login with phone number, code
    and, if set, the two-step verification password
  - Chat list with pinned chats, archive, saved messages, chat
    folders, unread and mention counters, drafts, typing and online
    status; pin, archive, mute, mark as read or unread, delete
  - Messages with formatting (bold, italic, code, quotes, spoilers),
    clickable links, mentions and hashtags, replies, forwards,
    reactions, edited mark, service messages, view counters
  - Photos, albums, stickers, link previews, video and GIF
    previews, locations, contacts, dice, polls and quizzes
  - Files: download with progress ring, open, show in drawer;
    voice messages play back (AHI)
  - Write, reply, edit, delete, forward, copy, pin; send several
    messages at once from a selection
  - Send photos and files with a caption, several photos as an
    album; drop files from the Workbench onto the window
  - Emoji panel (Twemoji), ()-completion of members, polls and
    quizzes, send silently or at a scheduled time
  - Search in the chat and across all chats, jump to a date with a
    calendar, list of pinned messages, media overview
  - Groups and channels: members, admins and their rights,
    restrictions, common groups, mute bar for channels; change name,
    description and picture
  - Your own profile: name, bio, username, personal channel,
    birthday and profile picture (with cropping)
  - Notifications through Herald or Ringhio, with sound
  - Settings for weak machines: profile pictures, photos and link
    previews can be switched off, the picture cache has a size limit
  - Main menu and Telegram settings laid out as in Telegram
    Desktop; active sessions: rename the device, end sessions, log
    out
  - Light and dark theme, chat background
  - AmigaGuide documentation
  - Localisation: English, German


CRYPTOGRAPHY
------------

LumiGram encrypts its connection with MTProto 2.0, the protocol of
the official Telegram apps: a key exchange with the server
(Diffie-Hellman, RSA), AES-256 in IGE mode and SHA-256. The
two-step verification password is checked with SRP and never leaves
the Amiga. Large numbers and RSA come from AmiSSL. Secret chats
(end-to-end encryption between two devices) are not supported.


REQUIREMENTS
------------

  - AmigaOS 4.1 Final Edition on a PowerPC Amiga
  - Several MB of free memory: the program about 2.4 MB, the emoji
    pictures about 3.5 MB
  - MUI (as shipped with AmigaOS 4.1)
  - AmiSSL 5.x (mandatory; part of AmigaOS 4.1)
  - The TCP/IP stack of AmigaOS 4 (Roadshow)
  - Picture datatypes for JPEG and PNG; for stickers a WebP
    datatype (e.g. WarpWebP). Without it a sticker shows its emoji.
  - A Telegram account and a phone or other device that receives
    the login code
  - codesets.library 6.x (optional - better replacements for
    characters outside Latin-1)
  - AHI (optional - voice messages; the decoder is built in)
  - Herald or Ringhio (optional - notifications)


INSTALLATION
------------

Recommended: open the archive, double-click the "Install" icon
in the LumiGram/ drawer and follow the AmigaOS Installer (English
or German). It copies the binary, the localisation catalogs and
the AmigaGuide help files to the location you choose.

Manual install: copy the LumiGram binary and its .info icon
wherever you like, e.g. SYS:Tools/, place the catalogs in
LOCALE:Catalogs/<language>/ and the guides in HELP:<language>/.

LumiGram needs the file emoji.dat and the drawer Backgrounds next
to the program; the installer copies both.

The login is kept in session.bin next to the program, together with
the pictures and files LumiGram has loaded. Whoever has session.bin
can read your chats: do not pass the drawer on, and log out (main
menu, Settings) before you give the Amiga away.

Settings live in ENVARC:LumiGram/LumiGram.prefs. The guides belong
next to the binary, in Help/<language>/ - that is where the Help
menu looks.


TOOLTYPES
---------

  LANGUAGE=<code>       Force catalog (deutsch/english)
  PUBSCREEN=<name>      Open on this public screen
  ICONIFY=YES           Start iconified (AppIcon only, no window)

  All of these ship with the program icon in parentheses (visible but
  inactive) - remove the parentheses in the icon's Information window
  to switch one on.


DOCUMENTATION
-------------

  Help/English/LumiGram.guide          AmigaGuide (English)
  Help/Deutsch/LumiGram.guide          AmigaGuide (German)


CHANGELOG
---------

  0.2 (Build 3, 5 November 2026)
    - First published version.


BUILD INFORMATION
-----------------

  Version:        0.2 (Build 3)
  Binary size:    ~2425 KB (stripped)
  Source code:    ~90,644 lines (C + H)
  Compiler:       ppc-amigaos-gcc 11.5.0
  Target CPU:     m68020+


LICENSE
-------

LumiGram is freeware. You may use, copy and redistribute
unmodified binaries freely. Redistribution on Aminet and other
archives is explicitly permitted.

Telegram is a trademark of Telegram FZ-LLC. LumiGram is an
independent client that uses the public Telegram API; it is not
affiliated with or endorsed by Telegram. Use of Telegram is subject
to the Telegram Terms of Service.

The emoji pictures are Twemoji by Twitter, Inc. and other
contributors, licensed under CC-BY 4.0. The libraries named below
keep their own licenses.

The software is provided "as is", without warranty of any kind.
The author is not liable for any damage or data loss resulting
from the use of this software.


REGISTRATION
------------

Registration is optional and does not affect functionality. All
features are available without limits, with or without a key. A
registration is a friendly gesture towards the author and helps
plan further development.

Two ways to register:

  1. With the LumiReg tool (available separately on Aminet) -
     enter name and email, click "Register".

  2. Manually by e-mail to register()amigaworld.de. Please include:

       Name      Name the registration should be issued to
       Email     Address the licence key will be sent to
       Program   Name of the program to register (LumiGram)


CONTACT
-------

  E-mail:  lumigram()amigaworld.de
  Web:     https://www.amigaworld.de/


CREDITS
-------

  Author
    Matthias Münch              Concept, implementation, testing

  Built with help from
    Claude Code (Anthropic)     AI assistant for pair programming

  Third-party components
    Stefan Stuntz               MUI
    Olaf Barthel &
    Oliver Roberts              AmiSSL
    Xiph.Org Foundation         opusfile, Opus, Ogg (built in)
    Mark Adler                  puff (inflate)
    Twitter, Inc. &
    contributors                Twemoji (CC-BY 4.0)
    Alfonso Ranieri &
    Jens Maus                   codesets.library (optional)

  Greetings
    Eisman, lokiist, Fossi, yelworC, cappin,
    Cego, McFly, LoneRaider, evil4dmin, jdb78

  In Memoriam
    Psyria


================================================================
                DEUTSCHE VERSION / GERMAN VERSION
================================================================

LumiGram ist ein Telegram-Client für AmigaOS 4 mit MUI-Oberfläche.
Er spricht selbst mit den Telegram-Servern, über MTProto 2.0, ohne
Gateway oder Hilfsrechner dazwischen. Sie melden sich wie auf jedem
anderen Gerät mit Ihrer Telefonnummer an, und Ihre Chats, Gruppen
und Kanäle erscheinen auf dem Amiga so wie auf dem Handy.

Das Fenster folgt dem Aussehen von Telegram Desktop: links die
Ordner, daneben die Chatliste, in der Mitte das Gespräch und rechts
die Info-Spalte, in einem hellen oder dunklen Design. LumiGram
gehört zur Lumi-Suite und teilt Menü und Einstellungsdatei mit den
anderen Werkzeugen.

LumiGram ist ein inoffizieller Client. Er stammt nicht von Telegram
und wird von Telegram nicht unterstützt.


FUNKTIONEN
----------

  - Eigenes MTProto 2.0, kein Gateway; Anmeldung mit Telefonnummer,
    Code und, falls gesetzt, dem Passwort der zweistufigen
    Bestätigung
  - Chatliste mit angehefteten Chats, Archiv, Gespeicherten
    Nachrichten, Chat-Ordnern, Zählern für Ungelesenes und
    Erwähnungen, Entwürfen, Tipp- und Online-Anzeige; anheften,
    archivieren, stummschalten, als gelesen oder ungelesen
    markieren, löschen
  - Nachrichten mit Formatierung (fett, kursiv, Code, Zitate,
    Spoiler), anklickbaren Links, Erwähnungen und Hashtags,
    Antworten, Weiterleitungen, Reaktionen, Vermerk "bearbeitet",
    Dienstnachrichten, Aufrufzählern
  - Fotos, Alben, Sticker, Link-Vorschauen, Video- und
    GIF-Vorschauen, Standorte, Kontakte, Würfel, Umfragen und Quiz
  - Dateien: herunterladen mit Fortschrittsring, öffnen, im Ordner
    zeigen; Sprachnachrichten abspielen (AHI)
  - Schreiben, antworten, bearbeiten, löschen, weiterleiten,
    kopieren, anheften; mehrere Nachrichten auf einmal aus einer
    Auswahl
  - Fotos und Dateien mit Bildunterschrift senden, mehrere Fotos
    als Album; Dateien von der Workbench auf das Fenster ziehen
  - Emoji-Fenster (Twemoji), ()-Vervollständigung der Mitglieder,
    Umfragen und Quiz, lautlos oder zu einem geplanten Zeitpunkt
    senden
  - Suche im Chat und über alle Chats, Sprung zu einem Datum über
    einen Kalender, Liste der angehefteten Nachrichten,
    Medienübersicht
  - Gruppen und Kanäle: Mitglieder, Admins und ihre Rechte,
    Einschränkungen, gemeinsame Gruppen, Stumm-Leiste in Kanälen;
    Name, Beschreibung und Bild ändern
  - Eigenes Profil: Name, Bio, Benutzername, eigener Kanal,
    Geburtstag und Profilbild (mit Zuschnitt)
  - Benachrichtigungen über Herald oder Ringhio, mit Ton
  - Einstellungen für schwache Rechner: Profilbilder, Fotos und
    Link-Vorschauen abschaltbar, Bilder-Cache mit Größengrenze
  - Hauptmenü und Telegram-Einstellungen wie in Telegram Desktop;
    aktive Sitzungen: Gerät umbenennen, Sitzungen beenden, abmelden
  - Helles und dunkles Design, Chat-Hintergrund
  - AmigaGuide-Dokumentation
  - Lokalisierung: Deutsch und Englisch


KRYPTOGRAPHIE
-------------

LumiGram verschlüsselt seine Verbindung mit MTProto 2.0, dem
Protokoll der offiziellen Telegram-Apps: Schlüsseltausch mit dem
Server (Diffie-Hellman, RSA), AES-256 im IGE-Modus und SHA-256. Das
Passwort der zweistufigen Bestätigung wird per SRP geprüft und
verlässt den Amiga nicht. Große Zahlen und RSA liefert AmiSSL.
Geheime Chats (Ende-zu-Ende zwischen zwei Geräten) werden nicht
unterstützt.


SYSTEMVORAUSSETZUNGEN
---------------------

  - AmigaOS 4.1 Final Edition auf einem PowerPC-Amiga
  - Einige MB freier Speicher: das Programm etwa 2,4 MB, die
    Emoji-Bilder etwa 3,5 MB
  - MUI (wie mit AmigaOS 4.1 ausgeliefert)
  - AmiSSL 5.x (zwingend erforderlich; Teil von AmigaOS 4.1)
  - Der TCP/IP-Stack von AmigaOS 4 (Roadshow)
  - Bild-Datatypes für JPEG und PNG; für Sticker ein
    WebP-Datatype (z. B. WarpWebP). Ohne ihn zeigt ein Sticker
    sein Emoji.
  - Ein Telegram-Konto und ein Handy oder anderes Gerät, das den
    Anmeldecode empfängt
  - codesets.library 6.x (optional - bessere Ersatzzeichen für
    Zeichen außerhalb von Latin-1)
  - AHI (optional - Sprachnachrichten; der Decoder ist eingebaut)
  - Herald oder Ringhio (optional - Benachrichtigungen)


INSTALLATION
------------

Empfohlen: Archiv öffnen, im Verzeichnis LumiGram/ auf "Install"
doppelklicken und dem AmigaOS-Installer folgen (deutsche oder
englische Sprache). Er kopiert das Binary, die Sprachkataloge und
die AmigaGuide-Dokumentation an den gewählten Ort.

Manuelle Installation: das LumiGram-Binary und das zugehörige
Piktogramm an einen beliebigen Ort kopieren (z.B. SYS:Tools/),
die Kataloge nach LOCALE:Catalogs/<Sprache>/ und die Guides nach
HELP:<Sprache>/.

LumiGram braucht die Datei emoji.dat und die Schublade Backgrounds
neben dem Programm; der Installer kopiert beides.

Die Anmeldung liegt in session.bin neben dem Programm, zusammen mit
den Bildern und Dateien, die LumiGram geladen hat. Wer session.bin
hat, kann Ihre Chats lesen: Geben Sie die Schublade nicht weiter,
und melden Sie sich ab (Hauptmenü, Einstellungen), bevor Sie den
Amiga weitergeben.

Die Einstellungen liegen in ENVARC:LumiGram/LumiGram.prefs. Die
Guides gehören neben das Programm, nach Help/<Sprache>/ - dort
sucht das Menü Hilfe.


TOOLTYPES
---------

  LANGUAGE=<Kürzel>     Katalog erzwingen (deutsch/english)
  PUBSCREEN=<Name>      Auf diesem öffentlichen Bildschirm öffnen
  ICONIFY=YES           Direkt ikonifiziert starten (nur AppIcon, kein
                        Fenster)

  Alle stehen im Programm-Icon in Klammern (sichtbar, aber wirkungslos)
  - zum Aktivieren im Informationsfenster des Icons die Klammern
  entfernen.


DOKUMENTATION
-------------

  Help/Deutsch/LumiGram.guide          AmigaGuide (Deutsch)
  Help/English/LumiGram.guide          AmigaGuide (Englisch)


VERSIONSHISTORIE
----------------

  0.2 (Build 3, 5. November 2026)
    - Erste veröffentlichte Version.


BUILD-INFORMATIONEN
-------------------

  Version:        0.2 (Build 3)
  Binary-Größe:   ~2425 KB (gestrippt)
  Quelltext:      ~90.644 Zeilen (C + H)
  Compiler:       ppc-amigaos-gcc 11.5.0
  Ziel-CPU:       m68020+


LIZENZ
------

LumiGram ist Freeware. Die unveränderten Binaries dürfen frei
genutzt, kopiert und weitergegeben werden. Eine Weitergabe über
Aminet und andere Archive ist ausdrücklich erlaubt.

Telegram ist eine Marke der Telegram FZ-LLC. LumiGram ist ein
unabhängiger Client, der die öffentliche Telegram-API nutzt; er
steht in keiner Verbindung zu Telegram und wird von Telegram nicht
unterstützt. Für die Nutzung von Telegram gelten dessen
Nutzungsbedingungen.

Die Emoji-Bilder sind Twemoji von Twitter, Inc. und weiteren
Mitwirkenden, lizenziert unter CC-BY 4.0. Die unten genannten
Bibliotheken behalten ihre eigenen Lizenzen.

Die Software wird "wie sie ist" bereitgestellt, ohne jegliche
Gewährleistung. Der Autor haftet nicht für Schäden oder Daten-
verluste, die aus der Nutzung dieser Software entstehen.


REGISTRIERUNG
-------------

Die Registrierung ist optional und beeinflusst die Funktionalität
nicht. Alle Funktionen stehen ohne Einschränkung zur Verfügung,
mit oder ohne Lizenzschlüssel. Eine Registrierung ist eine
freundliche Geste an den Autor und hilft bei der Planung
weiterer Entwicklung.

Zwei Wege zur Registrierung:

  1. Mit dem Tool LumiReg (separat auf Aminet verfügbar) -
     Namen und E-Mail eingeben, "Registrieren" klicken.

  2. Manuell per E-Mail an register()amigaworld.de mit:

       Name       Name, auf den die Registrierung lauten soll
       Email      Adresse, an die der Lizenzschlüssel geht
       Programm   Name des Programms (LumiGram)


KONTAKT
-------

  E-Mail:  lumigram()amigaworld.de
  Web:     https://www.amigaworld.de/


MITWIRKENDE
-----------

  Autor
    Matthias Münch              Konzept, Umsetzung, Tests

  Unterstützt durch
    Claude Code (Anthropic)     KI-Assistent für Pair-Programming

  Fremdkomponenten
    Stefan Stuntz               MUI
    Olaf Barthel &
    Oliver Roberts              AmiSSL
    Xiph.Org Foundation         opusfile, Opus, Ogg (eingebaut)
    Mark Adler                  puff (inflate)
    Twitter, Inc. &
    Mitwirkende                 Twemoji (CC-BY 4.0)
    Alfonso Ranieri &
    Jens Maus                   codesets.library (optional)

  Grüße
    Eisman, lokiist, Fossi, yelworC, cappin,
    Cego, McFly, LoneRaider, evil4dmin, jdb78

  In Erinnerung
    Psyria