Skip to content
whomperPublic

About

Contacts for the Atari ST, STE, TT and Falcon: a GEM desk accessory that syncs over CardDAV and works with EMail and ECal.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

EContact

EContact icon: an address card with a tab at the top, a blue portrait of a person on the left and lines of text on the right

An address book for the Atari ST, STE, TT and Falcon, written in C for GEM, that syncs with iCloud and other CardDAV servers.

Highlights

  • Like the Mac's Contacts: groups on the left, people under a search field, the chosen card on the right
  • iCloud and CardDAV (Fastmail, Nextcloud, Radicale...), synced both ways
  • Contacts' photos, from the card or iCloud's links, on any screen
  • Groups, as iCloud keeps them and as Nextcloud does
  • The address book of EMail and ECal: pick people to write to and to invite
  • A desk accessory or a program, with right-click menus, drag and drop and iconify
  • Several contacts at once: Shift+click, Control+click, Select all
  • Secure: TLS 1.2 on a Falcon or TT, the curves on the Falcon's DSP
  • Hebrew names and notes right to left, the Israeli keyboard on F10
  • Works offline from its own copy; vCard import and export

EContact on a Falcon: the groups on the left, the people sorted by last name, and Maya Carter's card with her colour photo, phones, emails and address

Getting started

Download the latest release (each file, or all in econtact-x.y.zip).

File What it is
econtact.acc the accessory, for every ST, STE, TT and Falcon
econtact.prg the same, to start from the desktop, with a menu bar
tls.ovl, cacert.pem, roots.dat a Direct connection on a TT or Falcon
tlsfb.ovl the same Direct connection on a FireBee
pic.ovl a Falcon's photos drawn with its DSP
econtact.hyp, econtact.ref the guide, for the Help key
econtact.rsc and the rest the desktop icon
  1. Copy econtact.acc to the root of your boot drive.
  2. Put the other files in a folder of your choice; the first time it opens, EContact asks where it is.
  3. On an ST or STE, set up the AERA Gateway (below).
  4. Reboot, choose EContact in the Desk menu and add your account, with an app password for iCloud or Fastmail.

Needs: TOS 1.04 to 4.x, EmuTOS, MagiC or MiNT; ST high or medium, TT or Falcon resolution; 1 MB of RAM or more; STinG or MiNTnet.

The whole setup (the Gateway's commands, updating, FOLDRxxx and STinG's settings) is in docs/SETUP.md; using it is in the user guide; how it works (photos, memory, EMail and ECal) in docs/DETAILS.md.

How it reaches the servers

Contacts servers want HTTPS. A Falcon or TT does it itself (a Direct connection, tls.ovl); an ST or STE goes through the AERA Gateway, a small service on a Raspberry Pi at home that EContact shares with ECal and EMail: EContact sends it plain HTTP and the Gateway talks HTTPS to the server. On a Falcon or TT the Gateway is optional, and an On My Atari address book needs no server at all.

Building

sudo apt install gcc-m68k-linux-gnu python3 zip
make          # binary/: econtact.acc, econtact.prg, roots.dat, tls.ovl, tlsfb.ovl, pic.ovl (and econtact.hyp with hcp)
make dist     # a release's files and zip in dist/

Releases, the help file and the icons: docs/DEVELOPMENT.md.

Source

src/      the contacts core: vCard, CardDAV, accounts, caches, photos
ui/       the GEM program: window, list, card, editor, dialogs
common/   code shared with the other AERA programs
docs/     the user guide and the longer docs

The full list: docs/DEVELOPMENT.md.

Tests

make test runs the core's tests; the rest (CardDAV, fuzzing, the Hatari rigs) is in docs/DEVELOPMENT.md.

Licence

GPL, version 2 or later: see COPYING. Copyright (C) 2026 AERA | Erez Yaary. It includes BearSSL (MIT), ChaN's TJpgDec and Mozilla's root certificates (MPL 2.0), under their own licences.


Part of AERA for Atari: ECal · EContact · EMail · EFTP · EHypView · ClaudeST · EWeb · EUpdate · EPDF · 8-bit: EDOS · EFTP_XL · Gateway: AERA-Gateway

About

Contacts for the Atari ST, STE, TT and Falcon: a GEM desk accessory that syncs over CardDAV and works with EMail and ECal.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages