About

Server side code that routes traffic between WhatsApp website and my Nokia WhatsApp client written in J2ME

This application uses the whatsapp-web.js NodeJS library to launch a headless (invisible) Chromium browser on the server to login the user using WhatsApp Web login method and then intercepts all messages and stores them in local SQLite database where they can be fetched by my Nokia WhatsApp client thru REST APIs using HTTP requests. You can download my Nokia WhatsApp J2ME client version 1.5+ from my website.

Important

You need to have a public IP address or you can get a public endpoint from one of the services listed below to receive the HTTP requests from the Nokia WhatsApp client.

Links

• My Website
• My reddit page
• My YouTube channel

Installation

This application requires NodeJS to run. If you want to upload audio and video, it also requires the open source FFMPEG library to be installed on the server. If you want to use Chrome to create your server side web session, then you need to have Chrome installed on the server as well and its executable path configured in WhatsappClient.js file depending on your OS.

Install NodeJS

Just get the latest LTS from the official node website.

Note

Node v18+ is required.

Install the NodeJS dependencies

After installing NodeJS, open a terminal or command prompt, go into the project folder and run the below command to install the dependencies. Note that "sudo" keyword is only required for MacOS and Linux, not for Windows.

sudo npm install

If you want to run using Chrome browser instead of the Chromium browser, use the below install command instead of the above one:

sudo PUPPETEER_SKIP_DOWNLOAD=true npm install

Setup the whatsapp script

Open WhatsappClient.js in any editor and set the executable path to point to the folder containing the Chrome executable file inside the "startClient" function. I have already provided the default installation paths of Chrom on Ubuntu, Mac OS and Windows, just uncomment one of them.

Modify the login page to connect to your server

Open the login.html page in an editor and search for "nokia4ever.com" and replace it with your own domain name or IP address where your server script is running. You can put "localhost" if you are running in locally on your PC or Laptop.

Running the server

Open a terminal or command prompt, Go into the project folder and run the below command to launch the server on port 80 by default. Note that "sudo" keyword is only required for MacOS and Linux, not for Windows. If you are hosting this server on a public VPS (Virtual Private Server) then I recommend running the script using PM2 process manager for NodeJS

sudo node server.js

If you have PM2 process manager installed on your server, you can use the below command instead of the above one. Here I have given a maxmum memory limit of 56 Gb (or 56494M), if used memory reaches this value, PM2 will restart the application to free memory.

sudo pm2 start server.js --max-memory-restart 56494M

Wait for the server started and DB connected message to appear in the terminal, then open a browser and open the login page "http://localhost/login" to scan the QR code from your iPhone or Android where you are already logged in to WhatsApp.

Connecting the client with the server

When you launch my J2ME Nokia WhatsApp client version 1.5+, you can replace my server URL "nokia4ever.com" with your public IP address, e.g "92.113.151.149" inside the J2ME WhatsApp client and also inside the login.html page on the server.

If you don't have a public IP address, you can get a public endpoint from an API gateway service provider to receive traffic on your local server. It has to be accessible thru HTTP, not HTTPS, since old Nokia phones don't support TLS 1.2

Get a public endpoint from API gateway

I recommend getting a public endpoint from NGROK, they are the most reliable, most feature rich and oldest provider of such a service and this is the one I use for my projects. Go to their official website NGROK API Gateway and register for an account. Then you need to go to the "Universal Gateway > TCP Addresses" menu option on the left side and create a TCP address endpoint. Download their NGROK command line tool (on windows you need to disable the Windows Defender as it thinks this tool is a virus).

Suppoose the TCP address you created is "5.tcp.ngrok.io:25805". Then you will need to open a terminal windows, go to the folder where you downloaded the NGROK command line tool and run the below commands and keep it running:

Forward traffic on port 80 for HTTP Rest API calls

Run the below command from terminal. When you launch the J2ME Nokia WhatsApp client, the server URL will be "http://5.tcp.ngrok.io:25805". Replace the address with your address.

ngrok tcp --region=us --remote-addr=5.tcp.ngrok.io:25805 80  

Note

Creating TCP Address on NGROK requires upgrading the free account to Pay-as-you-go account which costs minimum 8 dollars per month.

Other public API gateway providers

Below is a list of other providers who offer similar service.

localtunnel.me

pinggy.io

onionpipe

tunnelmole

Using a VPS Cloud Hosting solution

If you want to host the server side code on the cloud instead of your local PC + API gateway, then I recommend getting a VPS running Ubuntu Desktop from Webdock.io, I am using their Enterprise Xeon VPS plan (64 Gb Memory, 30 Threads CPU, 500 Gb storage) with Ubuntu Desktop for 68.20 Euro per month, I found that this is the best value deal comparing it with other VPS providers. You need a full "Desktop" version of Ubuntu running on the server, if you get a normal AWS EC2 Ubuntu instance, it won't have the GUI libraries and the server won't be able to run a full Chromium browser due to missing dependences, manually installing all the Chromium dependencies requires a lot of trial and error and troubleshooting with the version conflicts of the dependencies.

Supported features

Feature	Status
Multiple Users	✅
Send messages	✅
Receive messages	✅
Send images	✅
Receive images	✅
Send media (audio)	❌ (codec not supported by Chromium)
Receive media (audio)	✅
Send media (video)	❌ (codec not supported by Chromium)
Receive media (video)	✅
Send stickers	❌ (not yet)
Send contact cards	❌ (not yet)
Send location	❌ (not yet)
Receive location	❌ (not yet)
Join groups by invite	❌ (not yet)
Get invite for group	❌ (not yet)
Modify group info (subject, description)	❌ (not yet)
Modify group settings (send messages, edit info)	❌ (not yet)
Add group participants	❌ (not yet)
Kick group participants	❌ (not yet)
Promote/demote group participants	❌ (not yet)
Mention users	❌ (not yet)
Mention groups	❌ (not yet)
Mute/unmute chats	❌ (not yet)
Block/unblock contacts	❌ (not yet)
Get contact info	❌ (not yet)
Get profile pictures	❌ (not yet)
Set user status message	❌ (not yet)
React to messages	❌ (not yet)

Contact Me

I don't have time for live chat, if you want to ask something or provide your feedback then Reply to my post on Reddit or send me an email on novelprofessor@gmail.com

Disclaimer

This project is not affiliated, associated, authorized, endorsed by, or in any way officially connected with WhatsApp or any of its subsidiaries or its affiliates. The official WhatsApp website can be found at whatsapp.com. "WhatsApp" as well as related names, marks, emblems and images are registered trademarks of their respective owners.

License

Copyright 2026 Novel Professor

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this project except in compliance with the License.
You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0.

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.