1NCID_MODULES(7) NCID NCID_MODULES(7)
2
3
4
6 ncid_modules - NCID client output modules overview
7
9 NCID output modules are used to extend the functionality of the client.
10 They are mostly simple shell scripts.
11
12 Module names are of the format: ncid-<name>.
13
14 Modules are normally called by the client using the command line:
15 ncid --no-gui --module ncid-<name>
16
17 The client can only call one module at a time, but multiple clients can
18 each have a different output module.
19
20 Each module may have a configuration file called ncid-<name>.conf>.
21
22 The ncid-<name>.conf> file understands three line types:
23 blank line: ignored
24 comment line: begins with a '#' and is ignored
25 shell variable: set to a value, for example: foo=bar
26
27 The current modules distributed with NCID are:
28
29 ncid-alert
30 Module sends NCID call or message desktop notifications.
31 Its configuration file: ncid-alert.conf
32
33 ncid-initmodem
34 Module reinitializes the modem when RING is received as the num‐
35 ber. Does not have a configuration file.
36
37 IMPORTANT:
38 Module should only be used if modem stops sending CID to
39 ncidd but continues to send RING.
40
41 ncid-kpopup
42 Module popups Caller ID using KDE. Its configuration file:
43 ncid-kpopup.conf
44
45 ncid-mysql
46 Module stores NCID data in a MySQL or MariaDB Database. Its
47 configuration file: ncid-mysql.conf
48
49 ncid-mythtv
50 Module displays Caller ID on MythTV. Its configuration file:
51 ncid-mythtv.conf
52
53 ncid-notify
54 Module displays Caller ID on a iOS device. Its configuration
55 file: ncid-notify.conf
56
57 IMPORTANT:
58 Register at https://www.prowlapp.com/ for iOS key
59
60 ncid-page
61 Module sends Caller ID to a cell phone or pager. Its configura‐
62 tion file: ncid-page.conf
63
64 IMPORTANT:
65 sendmail.cf must hide user root when masquerading is used
66 and root is sending the email
67
68 ncid-samba
69 Module sends Caller ID to samba to get a popup. Its configura‐
70 tion file: ncid-samba.conf
71
72 ncid-skel
73 Module just echos the input. Modify it and its configuration
74 file to write new modules. Its configuration file: ncid-
75 skel.conf
76
77 ncid-speak
78 Module sends Caller ID to a text-to-speech program. Its config‐
79 uration file: ncid-speak.cconf
80
81 ncid-wakeup
82 Module wakes up a X-Window system that is using Gnome. It is
83 automatically called when the ncid option is set. Does not have
84 a configuration file.
85
86 ncid-yac
87 Module sends Caller ID to YAC clients. Its configuration file:
88 ncid-yac.conf
89
91 /usr/share/ncid/modules/ncid-<name>
92 /etc/ncid/conf.d/ncid-<name>.conf
93 /etc/ncid/ncid.conf
94
96 ncid.1, ncid.conf.5, ncid-initmodem.1, ncid-kpopup.1, ncid-mysql.1,
97 ncid-mysql-setup.8, ncid-mythtv.1, ncid-notify.1, ncid-page.1, ncid-
98 samba.1, ncid-skel.1, ncid-speak.1, ncid-wakeup.1, ncid-yac.1
99
100
101
102NCID 2019-09-06 NCID_MODULES(7)