RN2NCID(1)

📦
version 1.18 · 2 versions
, in fedora 43

✨ RN2NCID(1) ✨

okay so bestie, welcome to the manual page for rn2ncid — the User Contributed Perl Documentation glow-up of your fave gateway. It's the Android smart phone app Remote Notifier to NCID gateway, and yes, she's serving. 💅

🌸 NAME 🌸

rn2ncid — literally the bridge from the Android smart phone app Remote Notifier to NCID. That's the whole vibe. 🦋

🎀 SYNOPSIS 🎀

rn2ncid [--debug             | -D]
        [--delay             | -d <seconds>]
        [--help              | -h]
        [--hostname-flag     | -H <0|1>]
        [--logfile-append    | -l <filename>]
        [--logfile-overwrite | -L <filename>]
        [--configfile        | -C <filename>]
        [--man               | -m]
        [--ncidhost          | -n <[host][:port]>]
        [--test              | -t]
        [--pidfile           | -p <filename>]
        [--verbose           | -v <1-9>]
        [--version           | -V]
        [--cellport          | -c <port>]

💖 DESCRIPTION 💖

So the rn2ncid gateway is out here collecting Caller ID and messages from a cell phone. 📱✨ It pulls that info using an Android app called Remote Notifier for Android, then yeets it over to the NCID server. The server then does its thing and sends the CID info on to the NCID clients. Iconic relay chain, honestly.

The Remote Notifier for Android app uses a 16 digit hex number to identify the smart phone. The rn2ncid gateway takes 4 of the least significant digits and uses them as the phone id. Which means — and this is the slay part — you can run the app on multiple smart phones without needing to configure any of them. 🙌

The phone id can be aliased by the NCID server so you can give each phone a meaningful identification, such as CELL, or SP-1, or wharever. (Their spelling, not mine, bestie. 💀)

The rn2ncid configuration file is prefix3=/etc/ncid/rn2ncid.conf. See the rn2ncid.conf man page for more details. And heads up: if you're also using ncid-page or ncid-notify, you need to configure the reject variable. 👀

The rn2ncid gateway can run on any computer, but normally it's run on the same box as the NCID server. If it's not on the same box as the NCID server, you must configure the server IP address in the configuration file. No skipping that step, fr fr.

🧚 REQUIREMENTS 🧚

👑 OPTIONS 👑

  • -n <[host][:port]>, --ncidhost <[host][:port]> — Specifies the NCID server. The port may be specified by suffixing the hostname with :<port>.

Input must be <host> or <host:port>, or <:port>

Default: localhost:3333

  • -c <port>, --cellport <port> — Specifies the port to listen on for messages from a smart phone. 📡

Default 10600

  • -d <seconds>, --delay <seconds> — If the connection to the NCID server is lost, try every <delay> seconds to reconnect. She's persistent like that. 💪

Default: 15

  • -D, --debug — Debug mode, displays all messages that go into the log file. Use this option to run interactively. 🐛
  • -H <0|1>, --hostname-flag <0|1> — When the hostname flag is set to 1, the IDENT string sent to a server will include the hostname with the program name.

Default: 0

  • -h, --help — Displays the help message and exits. Cute and quick. ✨
  • -m, --man — Displays the manual page and exits. (Hiiiii, that's this one. 🫶)
  • -C, --configfile <filename> — Specifies the configuration file to use. The program will still run if a configuration file is not found.

Default: prefix3=/etc/ncid/rn2ncid.conf

  • -l, --logfile-append <filename>
  • -L, --logfile-overwrite <filename> — Specifies the logfile name to write. The program will still run if it does not have permission to write to it.

If both options are present, --logfile-append takes precedence. 🏆

Default: Append to /var/log/rn2ncid.log

  • -p, --pidfile <filename> — Specifies the pidfile name to write. The program will still run if it does not have permission to write a pidfile. The pid filename that should be used is /var/run/rc2ncid.pid.

Default: no pidfile

  • -t, --test — Test mode is a connection to the Whozz Calling Network Device without a connection to the NCID server. It sets debug mode and verbose = 3. The verbose level can be changed on the command line.

Default: no test mode

  • -v, --verbose <1-9> — Output information, used for the logfile and the debug option. Set the level to a higher number for more information. Levels range from 1 to 9, but not all levels are used. (So don't come for the gaps, okay? 🙈)

Default: verbose = 1

  • -V, --version — Displays the version. 💫

🌈 EXAMPLES 🌈

Start rn2ncid in test mode at verbose level 3

rn2ncid --test

Start rn2ncid in debug mode at verbose level 1

rn2ncid -D

🍓 FILES 🍓

prefix3=/etc/ncid/rn2ncid.conf

💜 SEE ALSO 💜

rn2ncid.conf.5, ncidd.8, ncidd.conf.5, ncid_gateways.7

and that's the whole page, bestie!! 💖 This one's running on perl v5.42.0 and it was dated 2025-08-06 — so go forth, gateway your little heart out, and remember: the vibe changes, the facts do not. periodt. 👑✨

📦 where this page comes from