Configuring Storages

1. Existing storages

For an introduction and a list of preconfigured storages in MythStream see here

2. Creating storages

2.1 File storage

A file storage is a plain textfile with the following format:

[item]
<folder name>
<stream name>
<stream url>
<stream description>
<stream handler>
<empty line(s)>

All entries are mandatory. [item] is a literal. <empty line(s)> are the only empty lines allowed. Empty fields are indicated by the literal [emptystring]

Example:

[item]
Interaction
Browse Shoutcast genres
http://www.shoutcast.com
[emptystring]
*shoutcast/menu

[item]
...

The easiest way to create a file storage is to add it in the MythStream storage configuration module, and then copy streams to it. The file will be created automatically.

2.2 Database storage

Create a table with the following columns (MySQL):

CREATE TABLE `streams` (
	`folder` varchar(100) NOT NULL default '',
	`name` varchar(100) NOT NULL default '',
	`url` varchar(255) NOT NULL default '',
	`description` varchar(255) default NULL,
	`handler` varchar(50) default ''
) TYPE=MyISAM;

Enter the storage properties in the MythStream storage configuration module

2.3 Creating a static (readonly) web storage

Create a file storage and add the following header:

[storage]
readonly

Upload the file to a webserver and use it's url to create a web storage in the MythStream storage configuration module.

2.3 Creating a dynamic (read/write) web storage

Copy misc/base.php and misc/streamtuned.php to a proper directory under the Apache document root.
Check global vars in php.ini, must be on for this to work (or leave off - safer - and change php code accordingly)
Create a database repository
Edit base.php to configure access to the database
Change password in streamtuned.php

Enter the storage properties in the MythStream storage configuration module

To test the storage direct your browser to http://<path>/streamtuned.php?command=list&pass=<your password>