
˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜
                           Installation instructions
˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜

1. Merge the !System supplied here with your main !System. The use of an
   automated tool to perform this merge is strongly advised. On machines
   running a new style boot sequence run !Boot, click on the System icon and
   follow instructions. For other machines use !SysMerge (or install
   the new boot sequence).

2. For !DigitalCD v2.50 or above see the DigitalCD configuration section.

3. For existing applications which loads the modules from their !Run file,
   edit the file and modify the RMLoad lines to:

     RMLoad System:Modules.Audio.Trackers.TimPlayer
     RMLoad System:Modules.Audio.DiskSample
     RMLoad System:Modules.Audio.MP3.AudioMPEG

4. For the other applications like !DigitalCD v2.49 or below which dynamically
   load modules copy the new version of the modules over existing version of
   the modules (e.g. in !DigitalCD.RMStore).

5. For PlayIt, v1.69 is v1.68 patched to make it 26/32-bit compatible,
   but does not work on ARMv7 (ARMini, Beagleboard, ...)
   Follow its ReadMe file for the installation.

DigitalCD configuration of module usage
˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜˜

DigitalCD has always offered some degree of configurability in the choice
of modules used to play music files and Internet radios. For the full details
read the sections:

A. Accepted filetypes, configuration

   This basically describes how to ask DigitalCD to play a file of a given
   RISC OS filetype with a given module.

B. Updating the mimemap file

   This describes how to translate foreign (PC, MAC, etc.) file extensions
   and Internet mime types into RISC OS filetypes. It also describes
   the precautions to take while modifying your MimeMap file because
   of the important differences in the way the various versions of RISC OS
   handle the MimeMap file.

   In the same directory as the current file you will find a file MimeMap
   with the latest mappings to merge with your mimemap file.

The most significant recent changes are:

1. Support of MatrixTRK files and Digital Symphonies with TimPlayer

  This is the only way to play such files on 32-bit systems like the Iyonix.
  The TimPlayer modules takes full use of 16-bit sound cards so there is also
  an advantage to use the TimPlayer module on older systems.

  To use it you will have to edit in your !DCDRes.Setup file the lines:

  Matrix
  00B = trk
  Digital Symphony
  10B = ds

  and change them to:

  Matrix
  00B = tim
  Digital Symphony
  10B = tim


2. Support for extra tracker formats with TimPlayer

  From time to time the TimPlayer modules is extended with some uncommon
  tracker file format. As the TimPlayer module is able to recognize
  the format a file uses by its content, the RISC OS filetype is somewhat
  irrelevant but RISC OS filetype 1B1 has been officially reserved to them.
  This can be seen with the following lines in the !DCDRes.Setup file:

  PC trackers: ULT, MTM, PTM, ...
  1B1 = tim

  So you just have to save the files under the 1B1 RISC OS filetype
  and DigitalCD will play them just fine.


3. Support of Flac, Ogg Vorbis, etc with DiskSample

  To do so you will have to edit in your !DCDRes.Setup file and add the lines:

  CDAudio
  0CD = smp, playit
  Ogg Vorbis (OGG)
  1AB = smp
  Flac
  1CF = smp
  Monkey's Audio Codec (Ape)
  1F0 = smp
  Advanced Audio Coding (AAC), MP4 Audio: AAC and ALAC
  A62 = smp
  AC3Audio
  A8F = smp
