• Introduction
• Download necessary files
• PBX: Back-end Installation
• Move files around
• PBX Time
• XBMC: Front-end Installation
• Via zip file
• Via Add-ons official repository
• Autoexec.py
• XBMC: Front-end Configuration
• XBMC Restart
• XBMC: Front-end first run

Introduction

This addon has two components:

• A front-end, which runs on XBMC side as a Program Add-on;
• A back-end, which runs on the PBX server side as part of the Asterisk itself and as PHP component;

Download necessary files

1. Download latest version from here: http://code.google.com/p/xbmc-pbx-addon/downloads/list
• Save this file somewhere, you will need it later;
• We assume this file is named script.xbmc-pbx-addon.zip;

PBX: Back-end Installation

Move files around

1. Unzip the script.xbmc-pbx-addon.zip file you downloaded before;
2. Find a directory named backend_files inside the file you just extracted;
3. Using your favorite FTP program move this folder content to your PBX server;
• You might try FileZilla if you don't have one: http://filezilla-project.org/

PBX Time

1. Log-in into your PBX server;
2. Put the manager_custom.conf file into /etc/asterisk/;
3. Edit this file, specially the IP address which has to be IP Address of your XBMC host;
• Remove the trailing ; in order to enable it;
4. If you are not using a standard install of FreePBX and Asterisk make sure /etc/asterisk/manager.conf has an include line like this one:

#include manager_custom.conf

5. Append the contents from extensions_custom.conf.sample to your own /etc/asterisk/extensions_custom.conf;
• DO NOT OVERWRITE IT
6. Put the xbmc-pbx-addon.php file somewhere you can access it from a web browser;
• Probably you'll pace it here: /var/www/html/;
• And you may reach it with the web browser at: http://asterisk/xbmc-pbx-addon.php;
• Of course, you must already have a Web Server (i.e. Apache) running on the PBX server;
7. Using a standard install of FreePBX and Asterisk you may not have to change any values in the PHP file;
• Otherwise, do so;
8. Once you've finished, restart your PBX software:
• If you have FreePBX installed:

root-pbx$amportal restart

• Otherwise:

root-pbx$/etc/init.d/asterisk restart

Optional

1. To stop Fail2Ban from banning XBMC while setting it up set:

ignoreip = [IP OF XBMC]

• Do this in /etc/fail2ban/jail.conf;
2. Also, restart it:

root-pbx$service fail2ban restart

XBMC: Front-end Installation

Via zip file

1. In XBMC, go to System -> Add-ons -> Install from zip file;
• Find and select the script.xbmc-pbx-addon.zip file you downloaded before;
2. You must see a notification pop-up saying XBMC PBX Addon is Enabled;

Via Add-ons official repository

1. In XBMC, go to System -> Add-ons -> Get Add-ons -> XBMC.org Add-ons -> Program Add-ons -> XBMC PBX Addon;
2. Select the Install option;
3. You must see a notification pop-up saying XBMC PBX Addon is Enabled;

Autoexec.py

• For XBMC Eden, you don't need to worry about this;
• For XBMC Dharma, copy the autoexec.py file (from the script.xbmc-pbx-addon.zip file you downloaded before) to ~/.xbmc/userdata/;
• For XBMC4XBOX 3.0.1, customize then copy the autoexec.py file (from the script.xbmc-pbx-addon.zip file you downloaded before) to Q:\scripts;

XBMC: Front-end Configuration

1. In XBMC, go to System -> Add-ons -> Enabled Add-ons -> Program Add-ons -> XBMC PBX Addon -> Configure;
2. Connection:
• Be very careful to put here the correct values for AMI (the ones you put in /etc/asterisk/manager_custom.conf);
• Also set the hostname to the correct hostname or IP address for your PBX Server;
3. CDR & VoiceMail:
• Specify the URL you used with your web-browser to access the xbmc-pbx-addon.php;
• Then you may want to change the Mailbox number for the one you would like to retrieve VoiceMail messages;
4. Outbound Calls:
• Customize it with the extension (and context) you would like to use when initiating outbound calls;
5. Inbound Calls:
• The first setting (...NewChannel State) defines how inbound calls are detected so you might try these values:
• Ring if you have an Asterisk 1.6 PBX server;
• Down if you have an Asterisk 1.4 PBX server;
• Personalize the remaining settings to modify the XBMC and Asterisk behavior for inbound calls;
6. OK:
• Click OK for settings to be saved;

XBMC Restart

1. Restart XBMC for the background service to automatically start;
2. Once XBMC has loaded, you should see a notification pop-up showing the number of VoiceMail messages you have in your Mailbox;
• If not, see the Troubleshooting page;

XBMC: Front-end first run

1. To open (run) it, just go to Programs from the XBMC home screen and find XBMC PBX Addon;
2. In case you didn't if before, you will be prompted to configure this add-on;
3. If everything went fine, you will see the front-end main screen with the list of your phone calls;
• Otherwise see the Troubleshooting page;