An IRC-style chat room built for Reticulum NomadNet, optimized for MeshChat v2.1+. Made By F.

Screenshot from MeshChat index.mu page interface:

Experience the chatroom in action via the official NomadNet page:

NomadNet Page Link (MeshChat v2.1+ Optimized): d251bfd8e30540b5bd219bbbfcc3afc5:/page/index.mu

Welcome to THE CHATROOM – v2.00 by F.
The first Reticulum/Nomadnet IRC-style chatroom, optimized for Nomadnet and Meshchat v2.x+.

Born on v1 (beta) the 10 of August 2025. Enjoy!

Stable v2.00 update: 01/10/2025

1. 💬 The Chat Room! v2.00

   • 🖼️ The Chat Room UI
   • 🚀 Live Demo

2. 📘 Informations

   • Project Overview

3. 🆘 Help Page

   • 🧰 Requirements
     • ✅ Built-in Modules
     • 🌐 Third-Party Libraries

4. ⚙️ Installation

   • 📁 1. Download the Files
   • 📂 2. Copy Files to NomadNet Pages Directory
   • 🔓 3. Make Files Executable
   • 🚀 4. Launch NomadNet

5. ⚙️ Technical Notes

6. 💬 Commands Reference

   • 📘 General Info & Utility Commands
   • 🧠 Interactive Chat Commands
   • 🎭 Social Interaction Commands
   • 👤 User Status Commands
   • 🔒 Admin Commands

7. Other Features

   • AntiSpam
   • Fixed UI Windows
   • NickName Color System
   • Nickname & LXMF Fingerprint Binding
   • Long Messages Split Function
   • Statistics and Users Commands

8. Next Work In Progress Features

   • Personalized User Settings
   • Administration Commands

9. Screenshots

   • Screenshot from v1.45a
   • Screenshots from v2.0

This is a Python-based Nomadnet page script that creates a ready-to-run IRC-style chatroom.
Just copy all files from this GitHub release into your ./nomadnetwork/storage/pages/ folder,
make nomadnet.mu and meshchat.muexecutable with chmod +x, and launch your Nomadnet node.

Detailed installation info below.

• 🌍 Decentralized mesh-based communication based on NomadNetwork
• 🧑‍💻 No registration required—just choose a nickname and start chatting
• 🎨 Nicknames are randomly colorized and persist across sessions (user settings personalization is coming soon!)
• 🔒 Nickname to LXMF address binding, using the Fingerprint in Meshchat v2+ to save and recover the nickname across sessions (THANKS TO: THOMAS)
• 🛠️ Built with Python and Micron components, JSON and SQL DBs for chat, topic and nickname persistency
• 🌐 Official chat script is Hosted on a VPS for stable uptime

Live Demo: d251bfd8e30540b5bd219bbbfcc3afc5:/page/index.mu

Official GitHub: https://github.com/fr33n0w/thechatroom

Welcome to the Help section! This guide outlines all the modules required to run this project,

along with setup instructions to get you started smoothly.

This project uses a combination of Python’s built-in modules and third-party libraries.

These come bundled with Python and require no additional setup:

These must be installed manually:

To install them, run:

pip install pytz requests geopy sqlite3

and of course, you need to install and configure NomadNet to host the page:

pip install nomadnet

Tested and 100% working also with rns_server_pages by SebastianObi: https://github.com/SebastianObi/RNS-Tools/tree/main/rns_server_page

Ready to deploy THE CHATROOM on your NomadNet node? Follow these steps to get it running in minutes:

Clone the repository or download the ZIP:

git clone https://github.com/fr33n0w/thechatroom.git

cp -r thechatroom/* ~/.nomadnetwork/storage/pages/

chmod +x ~/.nomadnetwork/storage/pages/nomadnet.mu
chmod +x ~/.nomadnetwork/storage/pages/meshchat.mu
chmod +x ~/.nomadnetwork/storage/pages/fullchat.mu
chmod +x ~/.nomadnetwork/storage/pages/last100.mu

Also make sure your user has read and write permission for the json and db files to be correctly written and saved!

Install and configure Nomadnet (or other nomadnet hosting page servers), after configuration:

nomadnet

Note: TheChatRoom has been created and run on root user machines, probably you need to be root to run it, let me know if you encounter some difficulties!

Here are some important details about how THE CHATROOM works and what to expect:

• 🔄 The chatroom does not auto-refresh due to Micron limitations
  → Use the Reload buttons that you find in the bottom menubar to view new messages
• 🧠 Nicknames can be stored using MeshChat’s Fingerprint binding
  • Usage: press fingerprint button, set a nickname and reload the page. Nick is saved. → This allows nickname persistence across sessions (thanks to Thomas!)
  • To recover the nickname on lost session cache, press fingerprint again and it will reappear automatically
• 📜 The main chat view shows the last 30 messages to fit MeshChat browser windows, you cn adjust the limit in the script → Full logs are available via the View Logs button on the bottom menù
• 🧪 The /meteo command uses external APIs
  → Requires requests and geopy to be installed
• 🧱 Built with Python and Micron components
  → Compatible with MeshChat v2.1+ and pure NomadNet client!
• 🧪 More Features will come soon! Stay Tuned!

Here’s the full list of available commands in THE CHATROOM, grouped by category for easy reference:

Only available to system administrators via /admincmd

⚠️ Some commands require internet access or third-party libraries (requests, geopy).
🔐 Admin commands are protected and only executable by authorized users. (Edit SYSADMIN nickname in the script!!)

The ChatRoom! includes already a good list of antispam filters, based on single words or combined phrases. Add your own or remove the unwanted blocked words to make it less strict in spam_patterns lines section of the script.

The UI is fixed in place with DISPLAY_LIMIT var, limited to ~28 messages to fit the MeshChat 2.0+ Browser window. Same for the Nomadnet page with simpler approach to limit lines to ~36 Note: Long user messages are split into multiple lines and it can vary the size of the final rendered UI.

Automatically color the user nickname for better readability, keeps it persistant for any message or command, same nick, same color, you can edit the default colors in the script.

Pressing the Fingerprint button on meshchat v2.1+ , you send your lxmf to the chat and the script will automatically bind the nickname and the lxmf address like a sort of autologin. on rejoining the chat, nickname will be automatically recovered. if the meshchat os variables are missing (in case of reboot for example), just press fingerprint again and based on your lxmf, your nickname will reappear again automatically. Nickname and corresponding LXMF address is saved in a sql db to be recovered.

On longer messages, they will automatically be split in multiple lines to keep persistant ui layout and format.

Show chat statistics, top chatters, total sent message per user, total users in chat (commands: /stats or /users)

(eg. set your nickname color preferences, possibility to click nickname to share your lxmf address for private chat, remove your nick and lxmf binding, chat theme selection, ecc.)

(eg. Add or Remove multiple Administrators)

Index.mu Intro page for interface selection:

Meshchat >v2.0+ UI Interface:

NomadNet UI Interface: