Privacy: what Namjai touches
What Namjai reads, what it writes, and what stays on your Mac.
- It reads, and it sends only when you ask. Namjai opens the file where WhatsApp keeps your chats on this Mac (a database named
ChatStorage.sqlite, "the store") read-only, so it never changes that file itself. It sends a message only when you runnj wp send: then Apple's Shortcuts hands the number and the text to WhatsApp, which sends the message as if you had typed it, and the message appears in your chats on your phone and Mac like any other. It does not reply, edit or delete any message. One exact caveat: the database keeps a small shared index file beside it,ChatStorage.sqlite-shm, that any program reading the database updates, so that file's time changes when Namjai runs; the chats, calls and labels files are not touched. Reading a chat withnj wp readdoes not mark it as read and sends no read receipts: Namjai only reads files on this Mac and tells WhatsApp nothing. - Your chats stay on your Mac. Every answer is printed in your Terminal window. In the setup on this guide it uploads nothing.
- The record of sends. Every
nj wp sendadds lines tosends.jsonlin Namjai's state folder: the time, the number, the chat, the outcome, and the length and SHA-256 of the text. The text itself is not in it. The file is readable by your Mac user account only. - What a Namjai server is. A separate program a company can run to keep its client conversations on one timeline. Uploading happens only when someone runs
nj wp syncwith three things: a server address, the owner's own number and a list of chats marked client. Each can be saved in the settings file or given in the environment, and the server address can also be typed with the command (--server).nj setupsaves none of them, and the installer contains no settings at all. The health check line-- sending chats to Namjai: not set upis an indicator that the upload is off, not proof. - One small settings file. Setup saves five settings in
~/Library/Application Support/Namjai/settings.env(theNamjaifolder insideLibrary/Application Supportin your home folder). Only your Mac user account can read it. It holds no messages. The five, by the names the check below prints:NAMJAI_WHATSAPP_STORE: where WhatsApp keeps your chats on this Mac.NAMJAI_TIME_ZONE: your time zone, for every date and time Namjai prints.NAMJAI_ENV: the environment name, saved asprod.NAMJAI_OUTBOX_KEY: a random key that would lock what is waiting to be sent, if a Namjai server were ever set up.NAMJAI_STATE_DIR: the folder where Namjai keeps its own state, including the record of sends.
nj set format, it adds a sixth line,NAMJAI_OUTPUT_FORMAT, your chosen format. - Files you save are yours. A file you make with
>, such aswaiting.csv, holds real names and messages. Treat it like the chats themselves.
Check it yourself
This prints only the names of the settings saved on this Mac, never their values:
cut -d= -f1 ~/Library/Application\ Support/Namjai/settings.env# Written by `namjai setup`. Run it again to change a value. NAMJAI_ENV NAMJAI_OUTBOX_KEY NAMJAI_STATE_DIR NAMJAI_TIME_ZONE NAMJAI_WHATSAPP_STORE
After nj set format, a sixth line, NAMJAI_OUTPUT_FORMAT, appears too. When no line says NAMJAI_SERVER, NAMJAI_WHATSAPP_ACCOUNT or NAMJAI_WHATSAPP_CLIENT_CHATS, nothing is saved that would make a plain nj wp sync upload. The first line is a note the file starts with.
For people connecting Namjai to a Namjai server, nj help settings lists the extra commands and settings. You do not need them to use anything on this guide.