Manpage of NCID
Section: User Commands (1)
Return to Main Contents
- Network Caller ID Client
[--alt-date | -A]
[--delay <seconds> | -D <seconds>]
[--help | -h]
[--hostname-flag | -H]
[--noexit | -X]
[--pidfile <file name> | -p <file name>]
[--PopupTime <seconds> | -t <seconds>]
[--program <program name> | -P <program name>]
[--ring <count> | -r <count>]
[--tivo | -T]
[--verbose | -v]
[--version | -V]
[IP_ADDRESS | HOSTNAME]
The ncid client
displays Caller ID information sent to it by the NCID server.
In the default GUI mode, if the server is configured to send the
Call Log, it will load the call log in the call history window at
startup. The history window is then updated by ncid whenever
a call is received.
The size of the client window at startup is controlled by the
the ncid.conf file. The user can resize the window, but
there is a minimum size restriction.
The history window displays one line per call or message. Each
line line starts with a call label. There are five call types
and two message types that can be displayed:
Blacklisted Call Hangup
Blacklisted Call Block
CID from a smart phone
User or NCID message
Message from a smart phone
The ncid client
also has a message window that will send a single line message
to the server which, in turn, will send it to all connected clients.
The ncid client
runs on Linux and Windows 98, ME, XP, 2000, NT and Mac OS X. In the
GUI mode, it will pop up, and go on top whenever a call comes in.
In addition, it will display itself on whatever desktop is active in
Linux. If ncid is given the --no-gui option, it will run
without a GUI.
If ncid is given the --program <module> option, it will
output to either a external program or output module. The
client can be configured to call any one module. It cannot call
multiple modules, but multiple clients can be used, each calling
a different output module.
If ncid is named tivocid, it will start in a no-gui mode
and output to a external program called out2osd which displays
the Caller ID on a TV using a TiVo.
If ncid is named tivoncid, it will start in a no-gui mode
and output to a module called ncid-tivo which displays
the Caller ID on a TV using a TiVo. This option uses the TiVo
program, text2osd, instead of out2osd.
If ncid is configured to output to a external program, it will
test for it, and if it is not found, or if it is not executable,
it will terminate with a error message.
The configuration file for ncid is /usr/local/etc/ncid/ncid.conf.
The distributed output modules are listed in the ncid-modules man page,
can be customized as needed in the /usr/local/etc/ncid/conf.d/ncid-<name>.conf files.
Whenever the server connection is broken, ncid will normally try
to reconnect once a minute. It provides a visual record of the countdown
and number of tries.
If the delay between attempts is set to
zero seconds, ncid will not attempt a reconnect.
The file menu provides three menu items in the GUI mode:
provides an immediate reconnect and a reload of the call log file.
This provides a way to synchronize ncid with the server call log in
the event of a network problem.
clears the call log
Do not display CID information using a GUI.
Default: display CID using a GUI, unless called as tivocid
- --alt-date | -A
Display the date in a alternate format.
Assuming the date separator is a "/",
the date is displayed as dd/mm/yyyy.
Default: display the date as mm/dd/yyyy
- --delay SECONDS | -D SECONDS
Delay SECONDS between server connection attempts if SECONDS > 0.
Only one attempt to connect to server if SECONDS = 0.
Default: 60 seconds
- --help | -h
- --hostname-flag | -H
Changes the LINE field to <hostname>:ncid for created messages, and
adds <hostname> to the IDENT string
Default LINE field: ncid.
- --noexit | -X
Configure ncid to to ignore the close window button.
- --pidfile | -p
Name of PID file to create.
Set to /var/run/ncid.pid in a rc or init script when used as a service.
Set to /var/run/OUTPUTMODULE.pid in a rc or init script when used as
a service and when using a output module.
There is no default. If pidfile is not set, no pid file will be used.
- --program PROGRAM | -P PROGRAM
Output the Caller ID information to the external program or output module.
PROGRAM is the name of the output module (program) to use.
The selected module is sent all calls and messages.
Default module PATH: /usr/local/share/ncid/modules
- --ring count | -r count
Call output module on specific ring count.
All count values: -9 -2 -1 0 2 3 4 5 6 7 8 9
For modems that indicate RING, count is: -9 0 2 3 4 5 6 7 8 9
A count of -9 indicates call on each ring.
A count of 0 indicates call when ringing stops.
A count of 1 should never be used, Caller ID is between 1 and 2.
A count between 2-9 indicates call on that ring number.
A count greater than 9 is not useful.
For VoIP, using a SIP or wc2ncid gateway, count is: -2 -1
A count of -1 indicates call on hangup with no answer.
A count of -2 indicates call on hangup after answer.
Default: output module called as soon as CID received
- --Tivo | -T
This option is for a TiVo using out2osd or text2osd
Changes output to 2 lines: name number line.
Default output is 5 lines: date time number name line.
- --PopupTime seconds | -t seconds
Time for the popup to stay on top of all windows.
Range is 1 second to 99 seconds.
Default popup time os 5 seconds.
- --verbose | -v
Display formatted CID information, including CID log file.
- --version | -V
Display version and quit.
- IP_ADDRESS | HOSTNAME
Set the IP Address.
Default: 127.0.0.1 (localhost)
Set the port number.
# Display the date as dd/mm/yyyy
# run ncid in a terminal window, server on remote host
ncid --no-gui tardis.drwho.home
# only speak Caller ID
ncid --no-gui --program ncid-speak
# send CID output to GUI and speak it
ncid --program /usr/local/bin/ncid-speak
# send CID output to a cell phone
ncid --no-gui --program ncid-page
# run ncid on a TiVo using out2osd, server on remote host
ncid2ncid.1, ncidrotate.1, yac2ncid.1,
- SEE ALSO
This document was created by
using the manual pages.
Time: 12:53:54 GMT, November 06, 2017