The above should cause the plug-in to get active.
Alternatively you can add the hidden argument to disable the
small window. If you do so, please use the ``Get SIDPlug'' icon to link
to the
plug-in page.
In short, ask your internet service provider to set up the following file type on their HTTP server. You will then be able to offer one-file sidtunes from your home page without problems. This MIME Media Type has been registered at the Internet Assigned Numbers Authority:
MIME type: audio/prs.sid Extension: .sid File type: SID Music
The usage of the old MIME type audio/x-sidtune is deprecated. No guarantee is made that outdated types will be supported in the future.
Find more detailed online-docs here.
In case of the availability of an installed Netscape Navigator/Communicator, copy the plug-in DLL file to your local plug-ins directory. This can be anything like:
For usage with Internet Explorer only, it is something like:
Internet Explorer: You can also run the ie_install.vbs script to automate the task of installing the plug-in.
If you install the plug-in manually, Internet Explorer 6 will need additional registry entries to enable this Netscape-style plug-in. Simply execute the ie6.reg script to add those entries.
If you have previously assigned a helper application to the same MIME type(s) which this plug-in uses, you will need to remove that assignment.
The plug-in has been tested with Mozilla 3.x, 4.x, and 5.x, as well as IE 3.0, 4.0, 5.x, and 6. Offline usage with Mozilla 3.x requires a few restrictions due to bugs in the Navigator software.
Restart the Navigator and check the plug-in help page whether plug-in has been found (about:plugins). You need to enable JavaScript in order to watch that page. The same page also shows information about which version of the plug-in is installed, as well as additional information on whether the plug-in is a limited version with fixed audio settings (which means, it doesn't evaluate any of the audio quality parameters: FREQUENCY, BITS, STEREO, SURROUND, PANNING.
With Mozilla 3.01 don't double-click a html file from the File Manager/Explorer. For different language versions of Mozilla 3.01, this has different effects. At its worst, it can cause a "General Privilege Fault" (for instance, in the German version - after double-clicking a html page from the Explorer - it immediately pops up a blank page and displays "about:editnewfile" as URL). In the local file system, use "Open Page" instead.
The plug-in stores a little bit of run-time information in human readable form in a file called sidplug.log in the system's directory for temporary files. Where this is exactly depends on your operating system version. Please submit this file when contacting the author about any problems you might have getting the plug-in to work.
Currently supported plug-in arguments are:
FILTER=true or false
to enable/disable the SID filter emulation.
Default: true
SIDPlug allows the HTML page creator to provide a recommended audio playback configuration. If a soundcard is not capable of the settings, the plug-in tries to select the closest possible configuration. In case of problems it will stay silent. Currently supported arguments in the configurable version are:
BITS=8 or 16
to select the resolution of the output signal.
Default: 16
STEREO=true or false
to select stereo (true) or mono (false) output.
Default: true
SURROUND=true or false
to enable/disable stereo surround.
Default: false
PANNING=0 or 1 or 2
to select no auto-panning (0), normal auto-panning (1, deprecated!) or centered
auto-panning (2).
Default: 2
If you pass illegal values to an argument, SIDPlug will fall back to defaults. The order of the arguments is not important. If an argument is multiply used, the last occurence is taken.