DEV Community

Cover image for ICQ turns 30: I rebuilt its interface on top of WhatsApp and Telegram
Felix Helleckes
Felix Helleckes

Posted on Fully Autonomous

ICQ turns 30: I rebuilt its interface on top of WhatsApp and Telegram

ICQ launched on November 15, 1996. It shut down in June 2024. Every revival I found has the same problem: a brand-new network with nobody in it.

So for its 30th birthday I'd like to show the side project that went the other way. ICQ Retrogram doesn't rebuild the servers. It rebuilds the ICQ 5 interface and puts it on top of WhatsApp and Telegram, so you get the contact list and one floating window per chat, and you still talk to the people you already talk to.

It's Electron and React, MIT licensed, for Windows, macOS and Linux. Here are the parts that cost me real time.

No headless browser for WhatsApp

The WhatsApp side used to drive a headless browser. I moved it to Baileys, which speaks the multi-device protocol directly over a WebSocket. Telegram goes through GramJS over MTProto. The download shrank by roughly half and cold starts got much faster.

Baileys is ESM, Electron's Node can't require() it

It needs a lazy await import() plus asarUnpack in the electron-builder config. Without that it breaks only in the packaged build, not in dev, which is the worst place to find out.

WhatsApp sends the history sync exactly once

You get it when you pair, and never again. If you don't persist the store to disk, the contact list comes up empty on the second launch and you'll be convinced your code is broken.

Never retry a send

sendMessage can throw after the message already went out. A retry delivers it twice, and you can't take that back. A send failure also must not trigger a reconnect, or everything after it fails with "not ready".

Getting a messenger client through Mac App Store review

One submission came back with two findings: no demo account (2.1a), and a downloads entitlement the app didn't use (2.4.5). The second is one line. The first is harder, because WhatsApp has no test accounts and pairing needs a real phone.

The fix was a dedicated demo mode with made-up chats in both networks, so a reviewer can see the whole app without a real account. In the store the app is simply called Retrogram.

The catch

The WhatsApp side uses an unofficial interface, like every third-party client. That can violate WhatsApp's terms, so use it at your own risk. This is an independent hobby project, not affiliated with ICQ, AOL, Meta or Telegram.

Code: https://github.com/Felix-Helleckes/ICQ
Site: https://icq-retrogram.pages.dev/?ref=devto

What did you use back then, and do you still remember your UIN?

Top comments (0)