NCID-NOTIFY(1)

💖 NCID-NOTIFY 💖

okay bestie, welcome to the ncid-notify(1) manual page — this is the NCID module that yeets your Caller ID straight to your iOS device, and yes it's giving main character energy ✨

---

🌸 NAME 🌸

ncid-notify — send an NCID notification to your iOS device 📱

---

✨ SYNOPSIS ✨

ncid --no-gui --module ncid-notify

---

🦋 DESCRIPTION 🦋

The ncid-notify output module uses Prowl to display the Caller ID or message on an iOS device. no cap, that's the whole vibe 🫶

🍓 Prowl (iOS)

So the notify values are 'application', 'event' and 'notification', and they can hold:

$NAME $NMBR $LINE $DATE $TIME $TYPE
$DESC $MESG $MTYPE

Three "rows" of information are available for Prowl. three. rows. iconic.

When $TYPE is one of the CALLTYPEs

• Row 1 'application' — NCID
• Row 2 'event' text — Incoming Call
• Row 3 'notification' text — John on Cell 407-555-7777 POTS
• Click on ">" to see 'url' — http://callerr.com/4075557777

The Prowl "bubble" notification pop-up is even more compact, consisting of only two lines:

• Row 1 'application' & 'event' — NCID -- Incoming Call
• Row 2 'notification' — John on Cell 407-555-7777 POTS

When $TYPE is one of the MSGTYPEs

• Row 1 'application' — NCID
• Row 2 'event' text — Message
• Row 3 'notification' text — Food ready!

The Prowl "bubble" notification pop-up is even more compact, consisting of only two lines:

• Row 1 'application' & 'event' — NCID -- Message
• Row 2 'notification' — Food ready!

Prowl defaults when $TYPE is one of the CALLTYPEs

   notify_application_for_calls_prowl='NCID'
         notify_event_for_calls_prowl='$DESC'
  notify_notification_for_calls_prowl='$NAME $NMBR $LINE'

Prowl defaults when $TYPE is one of the MSGTYPEs

notify_application_for_messages_prowl='NCID'
      notify_event_for_messages_prowl='$DESC'
notify_notification_for_messages_prowl='$MESG'

💀 NMA (Notify My Android)

No longer supported, closed operation on May 24, 2018. rip bestie, it's gone gone 😭

---

🎀 CONFIGURATION 🎀

The ncid-notify output module is configured in ncid-notify.conf. that's the one, that's the file 💅

allowed types

This sets the NCID call and/or message types ncid-notify will send. See ncid-notify.conf for a complete list.

Default: allowed_types="ALLTYPES"

If you want to send notification only when a ring count is reached, configure ring by creating the ncid_notify variable in ncid-conf.

---

👑 REQUIREMENTS 👑

The ncid-notify module requires either a key variable to be set to an API key or a key file that contains the API key. one or the other, no in-between, fr fr.

iOS Device Requirements:

• The Prowl (Growl client for iOS) app from the app store
• Registration at Prowl website http://www.prowlapp.com/
• Generated API key to be placed in configuration file.

---

🌈 FILES 🌈

prefix3=/etc/ncid/conf.d/ncid-notify.conf
/usr/share/ncid/modules/ncid-notify
prefix3=/etc/ncid/conf.d/key-prowl-api
prefix3=/etc/ncid/conf.d/key-prowl-provider

---

⭐ SEE ALSO ⭐

ncidd.8, ncid_modules.7, ncid.1, ncid.conf.5

---

bestie reminder: the API key situation is not optional. no key, no notifications, that's just how it is 🫶

okay that's the whole page, mwah 💋 this one is from the NCID crew, dated 2022-11-8, and it lives in the NCID-NOTIFY(1) section of the manual. slay, go set up your notifications 🎀✨