__ ___ _ _ _
\ \ / / |__ __ _| |_ ___ / \ _ __ ___ (_)
\ \ /\ / /| '_ \ / _` | __/ __| / _ \ | '_ ` _ \| |
\ V V / | | | | (_| | |_\__ \/ ___ \| | | | | | |
\_/\_/ |_| |_|\__,_|\__|___/_/ \_\_| |_| |_|_|
A WhatsApp client for classic Amigas that looks and works like
WhatsApp for Windows. It talks to the WhatsApp servers BY ITSELF -
no PC, no Raspberry Pi, no bridge, no proxy. Your Amiga becomes a
"linked device" of your WhatsApp account, just like WhatsApp Web.
The whole WhatsApp protocol is written from scratch in C and runs on
the 68k: TLS (AmiSSL), WebSocket, Noise handshake, Signal end-to-end
encryption (X3DH, double ratchet, group sender keys), protobuf, media
encryption, history sync, a progressive JPEG decoder, a JPEG encoder,
PNG/GIF/IFF decoders and an Opus decoder for voice messages.
No FPU needed.
THIS IS A BETA VERSION - it is improved and updated all the time.
WhatsAmi checks for new versions at start (can be turned off) and
updates itself with one click.
FEATURES
--------
* Pairing with a QR code shown on the Amiga screen
* Chat list like WhatsApp for Windows: avatars, last message, time,
unread counters, pinned, muted, archive, filters (All / Unread /
Groups), search in chat names and message text
* New chat: contact list with search, or any phone number
* Conversations: bubbles, day separators, "N unread messages",
coloured names in groups, older history loads while scrolling,
scroll bar you can drag
* Sending: text (multi-line), replies with quote, editing, emoticons
to emoji, photos and any files. The paperclip asks "Photo..." or
"File (document)...": PNG, GIF and IFF ILBM pictures (also HAM6,
HAM8, EHB, 24-bit) are converted to JPEG on the Amiga and arrive
as a real WhatsApp photo with a preview
* Receiving: photos (thumbnails and full-screen view, normal and
progressive JPEG), stickers, videos (thumbnail, save to disk),
documents, locations, contacts, polls
* Voice messages played through Paula (Opus decoder on the Amiga)
* Ticks (sent / delivered / read), "typing...", online / last seen
* Reactions, right-click menus for messages and chats
* Avatars and photos load in the background and are cached on disk,
progress bars for connecting, history sync and pictures
* Light and dark theme, English and Polish, Latin-1 / Latin-2 /
AmigaPL fonts, clipboard, resizable window, new message sound
* Runs on a 68020, much faster on 060, PiStorm and emulators
REQUIREMENTS
------------
* 68020 or better, AmigaOS 3.1 or newer (3.2 recommended)
* TCP/IP stack: Roadshow, AmiTCP, Miami (or Emu68/PiStorm)
* AmiSSL 4 or 5, with the AmiSSL: assign (its installer makes it)
* About 4 MB of free RAM
* 256-colour screen or RTG recommended, helvetica.font 11/13/18
* WhatsApp on your phone (WhatsAmi is a linked device)
INSTALLATION
------------
Unpack the archive - it contains the WhatsAmi drawer. Copy the
drawer anywhere on your hard disk (FFS, SFS, PFS - all fine). There are three
programs inside - keep the one for your CPU (or all of them):
WhatsAmi ........ 68020/68030, with or without FPU (any Amiga)
WhatsAmi.040 .... 68040
WhatsAmi.060 .... 68060, PiStorm / Emu68
Double-click it. On the phone open WhatsApp > Settings (or Menu) >
Linked devices > Link a device and scan the QR code on the Amiga
screen. Your chats and history load by themselves.
The interface is English by default and Polish when your system
language is Polish (change it in Settings). For Polish letters choose
ISO-8859-2 or AmigaPL in Settings, depending on your fonts.
From the Shell:
WhatsAmi normal start
WhatsAmi PUBSCREEN=name open on a public screen
WhatsAmi FONT=xen.font SIZE=11
WhatsAmi ENGLISH English interface
WhatsAmi DARK dark theme
KEYS
----
Enter / Shift + Enter .. send / new line
Esc .................... cancel reply, close window, close chat
Up (empty field) ....... edit your last message
Alt/Ctrl + Up/Down ..... previous / next chat
Shift + Up/Down, PgUp/PgDn, mouse wheel ... scroll
Amiga + N .............. new chat
Amiga + F .............. search
Amiga + E .............. archive chat
Amiga + W .............. close chat
Amiga + P .............. settings
Amiga + Q .............. quit
Amiga + C / V .......... copy / paste
Help ................... about
FILES
-----
PROGDIR:WhatsAmi-Data/ keys of this linked device, messages,
avatars and photo cache.
DO NOT SHARE THIS DRAWER - it is your
device identity!
PROGDIR:WhatsAmi-Data/log.txt log (log.old - the previous start)
PROGDIR:Downloads/ saved files and photos
ENVARC:WhatsAmi.prefs settings
PRIVACY
-------
Messages are end-to-end encrypted (Signal protocol) all the way to
your Amiga; the connection to WhatsApp uses TLS and Noise. Each Amiga
needs its own pairing - do not copy WhatsAmi-Data between computers.
You can remove the device on the phone (Linked devices) or with
"Log out" in Settings.
KNOWN LIMITS
------------
* Pairing with a QR code only (no phone-number code yet)
* No recording of voice messages yet
* Videos: thumbnail and saving only, no playback on the Amiga yet
* Animated GIFs are sent as a still photo (first frame)
PROBLEMS?
---------
Send the author a screenshot and the files
PROGDIR:WhatsAmi-Data/log.txt and log.old
(never the dev_* files - those are your keys).
SUPPORT
-------
Like WhatsAmi? Click the heart icon above the settings gear for
buycoffee.to and PayPal QR codes. Thank you!
AUTHOR
------
Rafal "Terror" Fajfrowski <solargrim@gmail.com>
Updates: https://eterror.pl/whatsami/
The Opus decoder is libopus 1.4 (BSD licence, Xiph.Org Foundation,
see src/opus/COPYING in the sources).
WhatsAmi is an independent project and is not affiliated with Meta.
"WhatsApp" is a trademark of Meta Platforms, Inc.
|