Troubleshooting
The first three rows are about getting Namjai installed: the first is a check you make before installing; the Quickstart has the full text and samples for each. From the fourth row on, start with nj wp doctor: a line that starts with FAIL names the problem.
| You see | Why | Fix |
|---|---|---|
shasum prints a code that differs from the one in Quickstart, step 1 | The file is not the Namjai 0.2.13 this guide describes. | Do not install it. Tell the person who gave you the file. If you already installed it, remove it as in Update or remove. |
| "Apple could not verify "Namjai-0.2.13.pkg" is free of malware..." when you double-click the installer | The installer is not signed with an Apple developer certificate yet. | Click Done, then System Settings, Privacy & Security, Open Anyway, your Mac password, and open the file again. On macOS 14 only: Control-click the file, Open. See Quickstart, step 2. |
zsh: command not found: nj | Terminal was open before the install, or the install did not finish. | Open a new Terminal window (Command and N). If it still says so, run the installer again. See Quickstart, step 2. |
WhatsApp is not on this computer yet. | The WhatsApp app for Mac is missing or not linked to your phone. | Install it from the App Store, link it (Settings, Linked Devices, Link a Device on the phone), wait for chats, run nj setup. |
macOS did not let this program read WhatsApp's chats. | macOS did not give Terminal access to WhatsApp's data. | System Settings, Privacy & Security, Full Disk Access, turn on Terminal, reopen Terminal, run nj setup. See Quickstart, step 3. |
nj: configuration: and If you have not yet, run: nj setup | Setup was never run on this Mac account. | Run nj setup. |
could not read this computer's time zone (exit code 1) | You gave no --time-zone, and macOS did not say which zone it is in. | Run nj setup --time-zone Asia/Bangkok with your own zone in place of the example. See Quickstart, step 3. |
--time-zone "..." is not a time zone name (exit code 2) | The name after --time-zone is not a known zone. | Run nj setup --time-zone Asia/Bangkok with your own zone, spelled as in the time zone examples. |
macOS asks whether Namjai Send may send messages with WhatsApp | macOS asks this the first time the shortcut sends. Only you can answer it; no program can. | Click Always Allow, so that it does not ask again. To answer it at a quiet moment, run nj setup and take the test message in its last step. If you clicked Don't Allow, delete the Namjai Send shortcut in the Shortcuts app (hold Control, click it, choose Delete), run nj wp send-setup and click Add Shortcut, then run nj setup again. This way back was not tested on a real Mac. |
no chat matches "..." | No chat name contains the words you typed, no person has that number, or no chat has that chat ID. Words look at names only; a number finds a person's own chat, not a group. | Run nj wp find with part of the name, or use the person's number with + and country code. Find a group by its name. |
... chats match "...": ... Use more of the name, or the number | Several chats contain what you typed. | Type more of the name, or the number. |
| A list is shorter than you expected | Waiting, unanswered, archived and new-customers look back 7 days, and every list except labels and count shows up to 50 entries. Or WhatsApp on this Mac has not finished syncing. | Add --within 30d or --within 0, and --limit 200. Open WhatsApp on the Mac and let it sync. |
nj wp: "bogus" is not a command | The command is misspelt, or this Namjai is older than the command: version 0.2.8 and older print the list of commands instead of this line. | Check the spelling against the cheat sheet, and the version with nj version; see Update or remove. |
One line ending in See: nj help, such as nj wp read: needs the name or number of a chat | A value, an option or a word did not fit the command. The line says which. | Correct what the line names. The command's section in Commands lists the options it takes. |
| Commands print commas or brackets instead of normal lines | A default format was saved with nj set format. It changes the commands listed under Formats from then on. | Run nj set format text. |
FAIL the store has a recent message: it holds no message | WhatsApp on this Mac has no chats yet. | Open WhatsApp on the Mac and wait until your chats appear. |