Streaming Media Support

The CONTENTdm Server can store and manage your streamed media files and link to your streaming server for access to the streamed media.

There are two methods for storing your streaming media files and interfacing to your streaming server from CONTENTdm:

Mapping a streamed file type allows you to manage the streamed file in CONTENTdm as you would any other item in the collection. This is the preferred method of storing media files. Store URLs of streamed files if the stream URLs have different parameters (other than the stream file name) for different streams or if you access your streaming server remotely.

Mapping a Streamed File Type

When mapping a streamed file type, the CONTENTdm Server maps the file name of your stored stream file to its URL on your streaming media server.

To map a streamed file type:

  1. Add the stream files to a CONTENTdm collection as you would any other item. First, import them using the Project Client, enter the metadata, upload them to CONTENTdm Server, approve them and index the collection.

    The stream files are then located in the image subdirectory for the designated collection.

  2. Locate the image subdirectory for the designated collection on your CONTENTdm Server. Create a link/alias to this directory from your streaming media server so it can access the stream files.
  3. Define a mapping from the file name of the stream files to the URL on your streaming media server. To do this, locate the streaming media configuration file on your CONTENTdm Server. The streaming media configuration file, called stream.txt, is located in the CONTENTdm Server conf directory.

    The default location for the server conf directory is:

    /conf

  4. Enter a record in the file corresponding to the type of media supported. The format of the record is the file extension of the stream file, followed by one or more spaces, followed by the URL of the streams. Within the URL, designate the place where the file name of the stream file should be inserted using the following two-character string: %f.

The example below shows the configuration file mapping a Real server file type to its associated URL:

file

After the file type has been mapped in the configuration file, the stream will then be accessed from the streaming server using the streamed URL in the CONTENTdm Web interfaces. In the example above, a stored stream file named 1234.ram would be accessed from the streaming server via the URL http://your.real.server/1234.ram.

Storing URLs of Streamed Files

Integrate your streaming media server by storing URLs of streamed files in CONTENTdm by importing the URLs in the Project Client. In the Project Client, choose Add Item to add the URL of your streams and store them in CONTENTdm. Then, enter metadata, upload the URL to the CONTENTdm Server, approve it, and index the collection.