How to Setup

Requirements
- Apache (any version)
- PHP 5 (PHP 4 won't work!)
- SOAP PHP module active
To check if you have SOAP enabled, use this command on your shell:
echo '' | php | grep "Soap"
and look for Soap Client => enabled
- (Optional) Subversion - Will allow you to fetch updates directly from our code repository.

Server Configuration (on your web server host)

1. Transfer the content of the "eyetv-epg-proxy" directory to your web server host, in /var/www/html/eyetv-epg-proxy/dataservice.asmx/.
Make sure you also transfer the .htaccess (hidden) file.
It's easier to just send the eyetv-epg-proxy.tar.gz file on your web server, and extract it in /var/www/html/.

2. Make the dataservice.asmx/cache directory writable for your web server.
Example:
chown apache /var/www/html/eyetv-epg-proxy/dataservice.asmx/cache
chmod 755 /var/www/html/eyetv-epg-proxy/dataservice.asmx/cache

3. Create a virtual host to catch requests for data.titantv.com, and specify the path to your new "eyetv-epg-proxy" directory.
<VirtualHost *:80>
    ServerName data.titantv.com
    DocumentRoot /var/www/html/eyetv-epg-proxy
</VirtualHost>
<VirtualHost *:80>
    ServerName partners.titantv.com
    DocumentRoot /var/www/html/eyetv-epg-proxy/dataservice.asmx/partnertools
</VirtualHost>
<Directory /var/www/html/eyetv-epg-proxy>
    AllowOverride All
</Directory>

Also make sure you have VirtualHosts enabled. Search for NameVirtualHost *:80 and remove any # there might be before it.
Restart Apache for your changes to take effect.

If you don't use Apache, find the correct configuration for your web server to handle requests for data.titantv.com correctly.

4. Get a Zap2It Data Direct account: go to http://labs.zap2it.com and create a new account.
When asked for a certificate code, enter: ZYZM-TE5O-SBUT
Configure your Zap2It account with the correct Lineup that you want to receive in EyeTV.
Important Note: Only enter one Lineup per Zap2It account!

5. Edit dataservice.asmx/config.inc.php; enter the details of your provider, and your account information to access Zap2It data. Change all the text that looks like 'your_xxx_here'.
Here's an example of what a configured file would look like:
<?php

$config = array();

$config['providers'] = array(
'A_00001' => array('epg-source' => 'zap2it', 'type' => 'cable', 'desc' => 'Videotron', 'city' => 'Montreal'),
);

$config['zap2it_access'] = array(
'A_00001' => array('username' => 'gboudrea', 'password' => 'something'),
);

?>

The type of a provider is important. If you don't use the correct value, the Channels Lineup dropdown menu in EyeTV will be empty.
Step 5.a of the EyeTV Installation instructions will tell you how to verify that you have the correct value.

6. [Optional] If you want to override some channel names (I prefer my own names instead of using Zap2It channel names), then create a file named "providerId.channels" (Example: "A_00001.channels"), and enter each channel name in it. The format is: channel_number[TAB]channel_name
See example.channels to see how it should look like.

Important note about the .channels file

EyeTV seems to keep a cache of the channels lineup (including channel names) on it's side. If you want to change the channel names from an already existing .channels file, you need to also change the provider ID in your configuration to disable any cache that EyeTV might keep.

For example, if your provider ID was A_00001, and you want to change your A_00001.channels file, first rename it to A_00002.channels, then edit your config.inc.php to change A_00001 for A_00002 and finally rename cache/A_00001.cache to A_00002.cache. Then, in EyeTV, select again your channel lineup to see your changes.

Continue with either XMLTV Installation instructions (if you're not in Canada) or the EyeTV Installation instructions.