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 MongoDB 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.4+ 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.
This application requires MongoDB and NodeJS to run.
Just follow the installation instructions for your operating system on the official Mongo website
MongoDB is no longer required as I switched to SQLite3 database which is installed as a dependency and you don't have to install it separately.
Just get the latest LTS from the official node website.
Note
Node v18+ is required.
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 installOpen 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.jsWait 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.
When you launch my J2ME Nokia WhatsApp client version 1.4+, 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
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 2 TCP address endpoints. 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 2 TCP addresses you created are "5.tcp.ngrok.io:25805" and "7.tcp.ngrok.io:21149". Then you will need to open 2 separate terminal windows, go to the folder where you downloaded the NGROK command line tool and run the below commands and keep them running:
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 Run the below command from another terminal. Replace the address with your address.
ngrok tcp --region=us --remote-addr=7.tcp.ngrok.io:21149 443Open the login.html page in an editor and update the below line with your web socket address which you configured above to receive the QR code from the server.
const webSocket = new WebSocket('ws://7.tcp.ngrok.io:21149/');
Note
Creating TCP Address on NGROK requires upgrading the free account to Pay-as-you-go account which costs minimum 8 dollars per month.
Below is a list of other providers who offer similar service.
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.
| 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 | ✅ |
| 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 | ✅ |
| Set user status message | ❌ (not yet) |
| React to messages | ❌ (not yet) |
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
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.
Copyright 2025 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.