ncid_modules man page

ncid_modules — NCID client output modules overview

Description

NCID output modules are used to extend the functionality of the client. They are mostly simple shell scripts.

Module names are of the format: ncid-<name>.

Modules are normally called by the client using the command line:

   ncid --no-gui --program ncid-<name>

The client can only call one module at a time, but multiple clients can each have a different output module.

Each module may have a configuration file called ncid-<name>.conf>.

The ncid-<name>.conf> file understands three line types:

blank line:

ignored

comment line:

begins with a '#' and is ignored

shell variable:

set to a value, for example: foo=bar

The current modules distributed with NCID are:

ncid-alert

Module sends NCID call or message desktop notifications.
Its configuration file: ncid-alert.conf

ncid-initmodem

Module reinitializes the modem when RING is received as the number. Does not have a configuration file.

IMPORTANT:

Module should only be used if modem stops sending CID to ncidd but continues to send RING.

ncid-kpopup

Module popups Caller ID using KDE.  Its configuration file:
ncid-kpopup.conf

ncid-mysql

Module stores NCID data in a MySQL or MariaDB Database.  Its configuration file: ncid-mysql.conf

ncid-mythtv

Module displays Caller ID on MythTV.  Its configuration file:
ncid-mythtv.conf

ncid-notify

Module displays Caller ID on a iOS or Android device.  Its configuration file: ncid-notify.conf

IMPORTANT:

Register at https://www.prowlapp.com/ for iOS key
Register at https://www.notifymyandroid.com/ for Android key

ncid-page

Module sends Caller ID to a cell phone or pager.  Its configuration file: ncid-page.conf

IMPORTANT:

sendmail.cf must hide user root when masquerading is used and root is sending the email

ncid-samba

Module sends Caller ID to samba to get a popup.  Its configuration file: ncid-samba.conf

ncid-skel

Module just echos the input.  Modify it and its configuration file to write new modules.  Its configuration file: ncid-skel.conf

ncid-speak

Module sends Caller ID to a text-to-speech program.  Its configuration file: ncid-speak.cconf

ncid-wakeup

Module wakes up a X-Window system that is using Gnome.  It is automatically called when the ncid option is set. Does not have a configuration file.

ncid-yac

Module sends Caller ID to YAC clients.  Its configuration file: ncid-yac.conf

Files

/usr/share/ncid/modules/ncid-<name>
/etc/ncid/conf.d/ncid-<name>.conf
/etc/ncid/ncid.conf

See Also

ncid.1, ncid.conf.5, ncid-initmodem.1, ncid-kpopup.1, ncid-mysql.1, ncid-mysql-setup.8, ncid-mythtv.1, ncid-notify.1, ncid-page.1, ncid-samba.1, ncid-skel.1, ncid-speak.1, ncid-wakeup.1, ncid-yac.1