gitwtfhub

wtf is whatsapplegacy?

wojkaltech/whatsapplegacy — explained in plain English

Analysis updated 2026-05-18

9Audience · developerComplexity · 3/5Setup · moderate

TL;DR

A self-hosted Node.js server plus webview client that lets very old Android phones (2.3 and up) connect to and use WhatsApp.

Mindmap

mindmap
  root((WhatsAppLegacy))
    What it does
      WhatsApp webview client
      Self-hosted server bridge
      Works on Android 2.3+
    Tech stack
      Node.js
      Express
      whatsapp-web.js
    Use cases
      Revive old Android phones
      Emoji to emoticon conversion
      Group chat support
    Setup
      Requires own server
      npm install dependencies
      Manual server.js setup

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Give an old Android phone running 2.3 or later a working WhatsApp client through a webview.

REASON 2

Run a self-hosted bridge server that translates modern WhatsApp emojis into text emoticons for legacy devices.

REASON 3

View chat history, group chats, and media placeholders on hardware too old for the official app.

What's in the stack?

Node.jsExpresswhatsapp-web.jsJavaScript

How it stacks up

wojkaltech/whatsapplegacyaaklon/akinatorabhinavshrivastava950/montara
Stars999
LanguageGoPython
Setup difficultymoderatemoderatemoderate
Complexity3/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 1h+

Requires installing and continuously running your own Node.js server.

No license information is stated in the README.

Wtf does this do

WhatsAppLegacy is a project that lets very old Android phones, going back to Android 2.3, connect to WhatsApp through a simple webview interface. Modern WhatsApp apps no longer work on such old devices, so this project works around that by running a small self hosted server that does the heavy lifting on your behalf. The server, written in Node.js, uses the whatsapp-web.js library to log into a real WhatsApp account and expose that connection through a set of simple web addresses. The old phone's webview then talks to this server to fetch chats, load message history, and send or receive messages, rather than connecting to WhatsApp directly. One of the more detailed parts of the README covers how the project handles emojis. Old Android versions before 4.1 cannot render modern emoji characters, so the server automatically converts common emojis like a laughing face or a heart into classic text emoticons such as :-D or less than three, and does the reverse when you type an emoticon on the old device. Devices running Android 4.1 or later skip this conversion entirely and receive native emoji characters instead. Photos, voice notes, and unsupported characters are shown as plain text labels like photo or recording so the interface does not break on devices that cannot display that content. Group chats are supported, including showing which group member sent each message. Setting up the server involves installing Node.js and a few npm packages, then creating and running a server.js file with the code provided in the README. This project requires you to run your own server continuously and does not work as a standalone app, so it is best suited to someone comfortable setting up and maintaining a small Node.js service.

Yoink these prompts

Prompt 1
Walk me through setting up the WhatsAppLegacy Node.js server on my own machine step by step.
Prompt 2
Explain how this project converts modern emojis into text emoticons for old Android versions.
Prompt 3
How does the webview client talk to the WhatsAppLegacy server to load chats and messages?
Prompt 4
What would I need to change to support a new media type like documents in this server?

Frequently asked questions

wtf is whatsapplegacy?

A self-hosted Node.js server plus webview client that lets very old Android phones (2.3 and up) connect to and use WhatsApp.

What license does whatsapplegacy use?

No license information is stated in the README.

How hard is whatsapplegacy to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is whatsapplegacy for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.