PBIT Fone for Mac
=================

A small always-on-top BLF (busy lamp field) panel for the PBIT Cloud PBX.
It floats in the top-right of your screen and shows who is on the phone.
Clicking an extension hands the call off to your Mac SIP softphone.

Requirements: macOS 13 or newer, Apple Silicon.

The app contains no credentials. Each install is configured with an
Access key issued by PBIT, the PBX address and your extension number.


INSTALL
-------
1. Unzip PBIT-Fone-Mac.zip (double-click it in Finder).
2. Open Terminal, change into the unzipped folder and run ONE of:

       ./install.sh
       ./install.sh 1016
       ./install.sh 1016 YOUR-ACCESS-KEY
       ./install.sh 1016 YOUR-ACCESS-KEY pbx.pbit.com.au

   Arguments, in order: extension, access key, PBX address. Anything
   you leave out is asked for on first launch. The PBX address defaults
   to pbx.pbit.com.au and normally does not need to be given.

   The installer copies "PBIT Fone.app" to /Applications (or
   ~/Applications if /Applications is not writable), saves any settings
   you supplied, installs a login item so the panel starts
   automatically, and launches the app.

3. On first launch, if anything is missing, the app asks for your
   Extension, the PBX address and the Access key issued by PBIT.
   Enter them and click OK.

4. Look for the phone icon in the menu bar (top right). The panel
   opens automatically.


FIRST RUN AND GATEKEEPER
------------------------
This is an internal PBIT tool. It is signed ad hoc and is not notarised
by Apple, so macOS may say the app "cannot be opened" or is from an
unidentified developer.

The installer removes the quarantine flag, so normally you will not see
this. If you do:

   - In Finder, go to /Applications, right-click "PBIT Fone" and choose
     Open, then click Open in the dialog. You only need to do this once.
   - Or go to System Settings > Privacy and Security, scroll down and
     click "Open Anyway" next to PBIT Fone.


USING THE PANEL
---------------
   Menu bar phone icon > Show Panel         brings the panel back if closed
   Menu bar phone icon > Reload             reloads the panel page
   Menu bar phone icon > Settings...        change extension, PBX address
                                            or access key
   Menu bar phone icon > Quit PBIT Fone     exits the app

Closing the panel with the red button only hides it. Use Show Panel to
bring it back. The panel stays on top of other windows and follows you
across Spaces and full-screen apps.


CHANGING YOUR SETTINGS
----------------------
Use the menu bar: phone icon > Settings...

Or from Terminal (then quit and reopen the app):

       defaults write au.com.pbit.fone extension 1016
       defaults write au.com.pbit.fone accessKey YOUR-ACCESS-KEY
       defaults write au.com.pbit.fone pbxHost pbx.pbit.com.au


UNINSTALL
---------
From the unzipped folder run:

       ./uninstall.sh

This removes the login item, quits the app, deletes it from
/Applications and ~/Applications, and clears the saved extension,
PBX address and access key.


SUPPORT
-------
PBIT Support, 07 5551 0721, support@pbit.com.au
