SHOUTcast DSP Plug-in v2.2.3 for Winamp (07/19/2011)

[DrO]

The updated version of the SHOUTcast DSP plug-in has now been released and is available from:

http://www.shoutcast.com/broadcast-tools
(Direct download link -> here)
Note: This updated version of the plug-in will only work on Winamp 5.5 and higher and requires Windows 2000 and higher to work (though the plug-in has only been actively tested on Windows 2000 / XP / Window 7). Additionally, this is a 32-bit dll like Winamp though should run fine on a 64-bit version of Windows.


Summary

This is a recommended update for anyone using the DSP plug-in as it resolves a number of stability issues with the prior 2.x and 1.9x versions and also adds support for SHOUTcast 2 along with a number of other improvements to the experience of using the plug-in with a number of bug fixes as well.


Changes

Changes from v2.2.2

• Fixed title updates to remove characters the v2 DNAS will abort a connection on
• Fixed DSP not starting connections if Winamp is starting minimised
• Fixed the AAC encoder not being re-loaded if closing the dialog and re-opening without re-loading the DSP
• Fixed some rare issues preventing the dialog from loading correctly

Changes from v2.2.1

• Added support for Winamp 5.62's new AAC encoder dll (Winamp now uses Fraunhofer's AAC library instead of Coding Technologies)
• Changed the genre to be chosen from a menu (in supported situations) so only allow supported values
• Changed MP3 default settings to be 96 kbps Stereo (meant to have been this for a while but wasn't working)
• Changed default genre to be 'Misc' on clean installs or on loading and not matching the supported genre list
• Changed the version string so it's more like the v1 tools (and pending DNAS / Transcoder updates)
• Changed 'Description' to 'Name' on the Yellow Pages tab
• Fixed the vu input meters to not show a level if there is currently no audio input instead of keeping the last value
• Fixed issue with loading of the config dialog not showing the tabs correctly in some situations
• Fixed sending a manual title update in v2 mode also incorrectly sending inappropriate cached title data
• Miscellaneous code tidyups, optimisations, removal of unwanted code

Changes from v2.2.0

• Fixed crash on some machines when the playlist editor is empty
• Fixed some minor localisation issues with some of the error messages
• Fixed the installer not setting the DSP as the default DSP for some non-standard installs
• Changed message when loading in an invalid configuration to mention DSP stackers

Changes from v2.1.3

• Added new 'Artwork' tab which allows for configuration of how and what artwork will be sent for SHOUTcast 2 streams to a compatible SHOUTcast 2 DNAS)
• Added support of the IPC_GETNEXTLISTPOS api in Winamp 5.61+ to better determine the next song to be played even if shuffle is enabled
• Added explict blocking of trying to load the plug-in not in Winamp to resolve loading issues and crashes due to lacking api support required
• Added to the logs tab the option to log the next tracks to be played from the DSP in plain txt or in xml format
• Added sending of icypub data as per SHOUTcast 2 protocol specifications (only needed for the SHOUTcast 2 DNAS)
• Added 'lookahead' ini only option for determining how many next tracks from the playback queue (if available) to report (default is 3)
• Changed all of the SHOUTcast 2 packet generation to fix a number of issues like large / invalid packets, being unable to connect, unstable connections
• Changed all of the title gathering to no long poll Winamp but instead query it directly (reduces cpu usage and inproves reliability of metadata gathering)
• Changed all of the plug-in UI to use unicode where possible to improve localisation support
• Changed some of the UI elements to make certain information or errors more obvious (like the 'Cipher Response' message when using the wrong SHOUTcast mode)
• Changed the 'Logging' tab to 'Logs' due to the wider range of options it now provides
• Changed next track logging to be a per-configuration feature instead of being applied globally (as in the previous DSP release)
• Changed to send the full title in the metadata <extension> block for the first (current) title so it follows the SHOUTcast 2 specs
• Changed the 'Send Update' button to not be enabled unless there is a title to send as well as disabling the next title option as applicable
• Changed YellowPages tab to disable options not applicable to SHOUTcast 2 mode and when running as a public server (where the details relating to 'streamauthhash' for the DNAS are used instead)
• Changed to send a default stream id if one is not specified in SHOUTcast 2 mode to improve DJ connection issues (which can fail if not specified)
• Fixed some metadata conversions leading to crashes
• Fixed internal utf8 conversions to prevent malformed SHOUTcast 2 metadata being generated which would cause the SHOUTcast 2 DNAS to block the connection
• Fixed some of the entered stream configuration options to not accept invalid input and revert to safe defaults as applicable if this happens
• Fixed some issues with logging initialisation leading to random lockups in some rare cases
• Fixed memory corruption using SHOUTcast 2 mode preventing 'Connection 1' being used in rare cases (mainly affected Windows 2000 / XP systems)
• Fixed metadata not being sent if the connection to the DNAS is lost and a connection then comes back or is manually started
• Fixed clean up of resources if unloading whilst Winamp is still running to prevent a potential crash on close or UI corruption when the plug-in is loaded again
• Fixed when Winamp is not playing or is paused outputting blank stream data at a higher rate compared to playing leading to higher bandwidth usage then should be happening
• Fixed the Summary page listview flickering on update
• Fixed rare crash when Winamp is not playing and certain playlist configurations are in use when trying to find the next track title
• Fixed to not reset the music levels if not using the soundcard input on closing
• Fixed to not reset the Winamp level if not using the soundcard input on startup but will instead apply it on changing to soundcard input
• Fixed playback queue lookup issues on older 5.5x clients when api_queue is not present or not correctly loaded when queried
• Fixed the 'Send Update' option to not send cached information from Winamp's title and to not crash in rare situations
• Fixed rare lockup issue when using the soundcard input due to the input device taking longer to reset than expected
• Fixed refresh capture device not setting to a valid selection if the number of devices changed
• Updated help link for the plug-in to go to the new page at http://wiki.winamp.com/wiki/Source_DSP_Plug-in
• Updated installer to allow the plug-in to be set as the default DSP as well as run Winamp after completion (with the checked states remembered for next time)
• Miscellaneous code tidyups, optimisations, removal of unwanted code and other build related changes to make this more portable at a later date

Changes from v2.1.1

• Added passing of metadata from the playing track (if known) to the server so it acts like sc_trans from a client connecting to the stream
• Added an option to not log 'Status X bytes' messages (enabled by default) and improved log file handling
• Added a refresh capture device button to help update the plug-in if connected capture devices have changed
• Changed status info duration to be the time connected rather than a relative date time and allows for more than 24hrs to be displayed e.g. 26:48:57 instead of looping back to 03:48:57
• Changed logging to filter 'Status X bytes' messages to only 1 second (if the option to include them is enabled)
• Changed log files to use CR+LF linebreaks instead of just LF
• Changed logging to remove newlines so each message is a single line to match the status info
• Fixed crash on Vista (and potentially Windows 7) where no capture devices are being present resulting in no default capture device known
• Fixed crash in SC2 mode when a different cipher is set in the plug-in to the server as well as indicating this error in the status info
• Fixed button images in the 'Soundcard Mixer Control' section not appearing on all OSes

Changes from v2.1.0

• Added new 'Logging' tab on the Output tab to log the connection status messages
• Added a mini dropdown next to the 'Lock' button for 'Push to Talk' to allow the mode to be automatically enabled on startup
• Fixed plug-in to not crash when the network connection is lost
• Fixed random plug-in crashes whilst the plug-in is streaming (mainly in SC2 mode)
• Fixed internal plug-in uninstall not always working
• Fixed SC2 title updates to properly work as UTF-8 and to not strip out characters incorrectly
• Fixed next track detection to only be reported if shuffle mode is off and not to act in an undefined manner when on the last playlist item (wraps around to the start of the playlist as needed)
• Fixed title updates to cope with the same title being played but the next song title being different
• Changed SC2 metadata to not output <soon> and <title seq="2"> tags in the xml metadata if they are not known (when shuffle mode is enabled)
• Changed the <TENC/> tag in the xml metadata to include the plug-in version

Changes from v2.0.2

• Added a separate capture device fader timeout option
• Added copies of the plug-in documentation as an installer option
• Added help and documentation links to the 'About' tab
• Changed on Vista / Windows 7 to only show actually connected capture devices (requires a restart of the plug-in if connecting a new device whilst the plug-in is active (*))
• Changed the 'Open Mixer' button to open to the recording devices dialog on Vista / Windows 7
• Changed wording of the legacy mode checkbox to be clearer (hopefully) and added an info panel below to deal with the 'Cipher response message'
• Changed capture device level to not alter the device's level unless Push to Talk is active
• Changed the resolution on the faders from 500ms to 100ms (will re-map old settings)
• Changed opening of help links in the plug-in to follow Winamp's style of handling
• Fixed major issue in the plug-in leading to breaking of Winamp (and 3rd party plug-in's) COM usage
• Fixed running of the plug-in not starting auto-connect connections when 'Input' or 'About' were the opened tab
• Fixed capture device level not being correctly handled leading to spiking in on transitions (affected at least Windows 2000 / XP where it is all known to work)
• Fixed capture devices source selection not being remembered
• Fixed capture device and source levels not being set back to the non-Push to Talk level if Push to Talk is active when the plug-in is closed
• Fixed a few localisation issues with missing items on Windows 2000 / XP
• Fixed capture deviceRemoved tooltip from the microphone slider on the line-in page
• Fixed some issues with the installer and uninstaller
• Miscellaneous code changes to make some things easier to manage

(*) There are other changes being made to the plug-ins handling of the Input devices over the next few versions so this behaviour will change again

Changes from v2.0.0

• Fixed SHOUTcast 1 connection errors to a remote connection
• Fixed authorisation error checking for Ultravox 2 & 2.1
• More changes to the output manager to avoid out of sync states
• Fixed timing issue which caused out of sequence Ultravox audio data frames in some scenarios
• Fixed some localisation and tabbing order issues on the config pages
• Removed unwanted encoder option on the Output -> Connection tab
• Added a SHOUTcast 1 mode only information prompt on how to enter the password for DJ connections

Changes from v1.9.1

• Added SHOUTcast 2 (Ultravox 2.1) support for the generated stream data
• Cleanup and general fixes to the streaming support in the plug-in
• Fixed settings not being saved on Vista / Windows 7
• Fixed a number of lock-ups in the plug-in (should be more stable now)
• Fixed plug-in to not stall if Winamp is not playing
• Fixed a number of UI issues (tabs not showing in all cases, controls not in the correct tabbing order, theming issues, notification icon handling)
• Config window now remembers its last position between use
• Improved Lame encoder quality
• Attempted to resolve standard AAC (LC-AAC) not working (additionally this is reported as audio/aacp so it will work with the YP)
• Uses the current enc_aacplus.dll (AAC / AAC+ encoder) from the Winamp install used instead of bundling an old version from Winamp 5.1)
• Fixed SHOUTcast 1 issue with titles containing "[" & "]"
• Changes made to improve selection of the 'microphone' device allowing for more control over the capture device used
• Added localisation support to the plug-in (including supporting localised encoder plug-ins when showing their configurations)
• Some other minor changes including those from the 1.9.2 beta

Reporting Issues

If you do come across an issue with the plug-in, then please do post in this thread with as much information as possible about what you're doing at the time, the system you are using and anything else which will make it easier to understand what is or isn't going on with your install.


Important Notes

1) There are still a few issues regarding the soundcard control features on Vista / Windows 7 due to changes made in these OSes in the way it handles sound and how it can be obtained. This is being investigated though there is no eta on when a resolution will be found.

2) By default on new installs of the plug-in, it will enable support for using the newer SHOUTcast 2 features. However, if you're using an older version of the DNAS (or an alternative which is not compatible with the SHOUTcast 2 protocol) then you will need to check the 'Use SHOUTcast v1 mode (for legacy servers)' on the Output Page -> Connection Tab.

3) This version includes artwork support but requires a newer version of the SHOUTcast DNAS v2 in order to be able to use it. This will be released shortly once a number of other aspects have been completed with the DNAS's development.


Issues

Cipher response received message - If this happens then you most likely are connecting in SHOUTcast 2 mode to a SHOUTcast 1 setup and so need check the 'Use SHOUTcast v1 mode (for legacy servers)' on the Output Page -> Connection Tab. The plug-in will give you a number of hints if this is what you need to do.

Soundcard Mixer Control - On Vista / Windows 7 there are issues with the use of the features with the selected device to act as the 'microphone' where it basically will not work in an expected manner. This is being investigated though is not clear if there will be a solution for this.


Thanks

Big thanks goes to kind people who've helped out from trying new test builds to providing access to systems experiencing weird issues as well as those who reported issues with the DSP whilst trying to resolve the issues with connection stability and other things from the v2.1.3 release.


-daz

[DrO]

For anyone who has used the v2 DSP then they really should consider upgrading to this version as it fixes the known connection and stability issues which have been reported (and been able to be reproduced) so should be a far nicer experience (especially if you've been hanging onto the v1.9.x builds of the DSP due to the stability issues).

Enjoy!

-daz

[SC_faisal]

Solid!

[DrO]

Updated to v2.2.1 which can be downloaded via the direct link (main site will be updated soonish).

This new releases resolves the crash issue reported by MrSinatra and DigiBC (who's posts have been moved to here).

-daz

[DrO]

Main site download link is now active for the v2.2.1 download

-daz

[MrSinatra]

hey DrO,

question: if i run a headless machine with no sound card, can it stream music via the DSP? i haven't loaded the music onto the machine yet, but when i have the DSP up and try to "play" the llama clip, i get a no directsound output error.

do i need to select the DSP as a device somehow?

[thinktink]

For no soundcard use ZeroPointer as the active output plugin.

[MrSinatra]

you're the man TT, that seems to work! but is there a way to do it without a 3rd party plugin? DrO, is that what you would have done? are there other alternatives?

TT, what are the options for in the null plugin? what do they do?

[thinktink]

The options in the plugin are for playback fine-tuning. If you find your stream running too fast or too slow you can tweak the rates. Otherwise just leave 'em at 0.0 and 0.0 (or whatever the install defaults were) respectively.

As far as the 3rd party plugin issue. The closest would be the (if memory serves) official NULL Output Plugin that came with one of the old SHOUTcast DSP installs. I think ZeroPointer is far superior though.

[MrSinatra]

The options in the plugin are for playback fine-tuning. If you find your stream running too fast or too slow you can tweak the rates. Otherwise just leave 'em at 0.0 and 0.0 (or whatever the install defaults were) respectively.

As far as the 3rd party plugin issue. The closest would be the (if memory serves) official NULL Output Plugin that came with one of the old SHOUTcast DSP installs. I think ZeroPointer is far superior though.

that would explain why i don't recall having this issue before. perhaps they should ask you to turn it into "official."

the first option default is 0.0 for playback, but 0.01 for "end song fudge factor." i just don't get what they do?

my next task is to get this working with the new DNAS, but i don't know if i should try to get that going until i have a permanent static IP, and until the auth hash issues are settled. DrO gave me a lot of good info for it, but it seems like a daunting challenge.

[thinktink]

Yup, I just double checked, 0.0 and 0.01 are the normal defaults.

"Song End Fudge Factor" is mainly for input plugins (as of the time ZeroPointer was first constructed) not always sending the same amount of data to DSP plugins as Output plugins thereby causing some data rate flow irregularities in the SC DSP send. 0.01 is based on an average experience with different MP3 files.

For a more in-depth understanding of the data rate (about to get technical~ish):
For machines with a soundcard that Winamp can play to, the soundcard acts as a timer of sorts to control how fast Winamp plays music (and how fast audio data gets pushed through the DSP (or DSP stack if running)). Without that regulation Winamp would just dump the audio data way too fast for the DNAS or anybody trying to listen to your radio station to handle. With no soundcard that inherent regulation is gone. Winamp has to playback to something. ZeroPointer and other NULL output plugins therefore simulate that playback timing. Because not all system clocks are perfect I added this feature to ZeroPointer, again, out of experience dealing with different machines.

Hope this answers your questions.

[DrO]

i'd go with thinktink's option or basically any null output plug-in which is known to be stable / developed (not sure where the out_null source code even is nowadays).

-daz

[IgorPobi]

SHOUTcast DSP Soundcard input and metadata

Hello !

When set SHOUTcast DSP to Soundcard input, how grab metadata ?
Is possible implement HTTP Event Adaptor ? (like Spacialnet Simplecast).
For example: http://localhost:8181/?artist=myarti...uration=240000

Please see: http://support.spacialaudio.com/wiki..._Event_Adaptor

For now, when DSP set to Soundcard input, no possible to grab metadata ...

Thanks !

[DrO]

there's no metadata available when using the soundcard input mode as that's just how that works i.e. its just acquiring what's being passed to the audio output so will never know where the audio is coming from.

so you'd either need to use something else or use the Winamp capture mode and play what you're trying to capture through that which will send title updates as long as the source is changing the title / provides metadata Winamp is able to obtain.

-daz

[MrSinatra]

hope you don't mind if i jump in here, but i was eventually going to ask about this myself.

as you know, at our station we just simulcast the FM, so no title/artist info on the webcasts.

however, the CD players and computer DJ automation systems will output that info as XML or other similar txt-like info. i understand that some middleware or scripts or something would need to translate that output to a winamp/shoutcast standard, but the problem is that neither the DSP nor the DNAS seems to have an "injection point" for 3rd party metadata.

it would be good if as an option/setting, at some point along the way in some piece of shoutcast, a user could say "look every 3 seconds here at this txt file for artist/album/title updates" or something like that.

possible?