Posted at 06-03-2008 @ 01:07 by ..::DeUCeD::..
Important: MAJOR RELEASE! Version 3.0 will adopt FFmp3 player from now on. Minicaster and Media player will still remain but FFmp3 is what is really needed. Upgrade and do not forget to read the configuration instructions!
- Features
- Use it as Widget or in a Page (shortcode) or both.
- FFmp3 flash player or Mini Media Player or MiniCaster flash player.
- Ability to customize FFmp3!
- Autoplay in configuration.
- Multiple streams supported.
- Larger Popup windows.
- Stats with latest 10 songs history.
- Stats update using AJAX.
- Supports Shoutcast and Icecast.
Shout Stream version 3.3
Updated @ 03/02/2010
Download Shout Stream
(from the Wordpress Repository)
- Description
Shout Stream is a WordPRess plugin that embeds a mini Player at your sidebar to connect to a shoutcast stream along with LIVE stats. You can select between FFmp3 flash player or Media player or Minicaster flash player. It has also links for popup windows so your readers could surf at your blog without stopping hearing the stream. In this version there is ability to make your own skin for FFmp3 and also use a simple shortcode available so you can easily built a static page with stats on your WordPress. There are also extended stats with latest 10 songs history and (at last) an options page where you can configure Shout Stream to do what you need.
Everything is optional so you must configure it well to get exactly what you need to show to your visitors. No external files needed to configure and an easy plugin update with the latest WordPress! But as Shout Stream plugin is getting richer and new features are being added, i strongly advise you to read all the info in this page to configure it properly.
- Shout Stream General Configuration
Shout Stream has it’s own options page. So after activation go to your Dashboard and select Options -> Shout Stream configuration page. There are five sections to configure and a sixth which is useful for uninstallation process.
1. Shout Stream Usage is the first section you must configure. Declare the type of your MAIN stream (Shoutcast OR Icecast) and choose where are you gonna use Shout Stream. You can use it as a widget (as it used to be) or have a dedicated page for your stream (using a shortcode) or both. If you plan to make a dedicated page for your stream you must first create the page, publish it and then put it’s URL in the field.

- To create a page make a new static page at WordPress and add somewhere between this code exactly as you see it here: [shout-stream-page]
- To add a widget go at Appearance -> Widgets and add Shout Stream Widget.
At my sidebar there’s a full widget sample and there’s also a sample page with extended live stats enabled. Check them.
2. Default Stream and Alternative Streams is the second section you must configure. Shout Stream needs to know one default stream. This would be the main stream from where it ’ll gets stats and set it up for the default player (the type of your main stream has been set at the previous step above). Additionally you can have up to NINE alternative streams. Many stations use this option for their audience offering various types of streams like 48Kbps, 64Kbps, 128Kbps etc. You can also use it to put different streams (as I do). New thing here that you can mix different streams, shoutcast or icecast.
Every stream has a row, fill the fields giving a stream NAME, a stream IP (or DOMAIN) and a stream PORT. Only default stream is required, other streams are optional. There is also a mountpoint. For Shoutcast streams leave mountpoint blank but for icecast streams fill their mount point (without .m3u) for each stream.
Different streams settings. Only main stream is required, others are optional.

(Stream name, IP, Port, mountpoint only for icecast, blank for shoutcast)
3. Shout Stream Player is the third section you must configure. If you don’t want a player at your page or sidebar it’s OK, you ‘ll have only popup links which they ’ll use mini media player to open the stream for the visitor. If you choose Media Player you ‘ll also have a player at your sidebar or at your page (depending what you have chosen before). If you enable MiniCaster then ALL browsers EXCEPT MSIE will try to open the stream with MiniCaster flash player. BEST CHOICE is to enable FFmp3 flash player. ALL browsers can listen to your stream and there are 4 skins to choose depending on your width of your sidebar.

FFmp3 comes with 4 skins. Tiny is a really small SWF file while the rest are SWF files using background images. You can customize them changing skin or colors and there ’s also a custom option for the experts. For all these please take a look at customization PAGE of FFmp3.
There ‘s also a width and height useful for sidebar Media Player. MiniCaster has a standard width and height but you may want to change the look of Media Player. This is also USEFUL for FFmp3. If its narrow then put a bigger width to align it wherever you are. It must be bigger than the actual size of the selected skin.
A last thing here is align for your sidebar player. This will also influence heading, images and anything is static. If you have a wide sidebar choose left, else choose center. It’s up to you.
4. Shout Stream Stats is the fourth section. First of all if you have Icecast stream and wanna show some stats then only try curl. Icecast stats are experimental. I ‘ve tried different streams and seems to work but as I don’t know it so well it might not work for you. So if you have an Icecast stream please let me know how it goes.

For shoutcast streams you can use fsockopen method but you ‘ll only get basic stats. If you need to show some more try curl method (which is recommended). If you do then you can also have 10 latest songs history at your stream’s page (if you have created one). You can have stats at your sidebar, at your page or both places.
If you want them updated live (using ajax) set a number of seconds to refresh. Minimum is 30 because we don’t want to slow down your blog and have lot’s of useless connections to your stream. Setting something like 40 or 60 secs seems more logical to me. If you don’t want to update stats leave it blank.
Heading Page/Sidebar is the way some heading will be shown like a small title saying: “Current Song”. You can choose anything between h1 till h6, first box is for Page heading and second for Sidebar heading. This also depends on your theme. If you are not happy, play with your CSS.
There’s also a DIV style for page. A basic code is there. Alter it if you want but it only applies to your static page (if you have created one). Check my Radio Casbah page to get the idea.
5. Custom Text Messages is the fifth section. Put anything to replace all messages that Shout Stream displays. Localization is a piece of cake here!

There’s another section called Shout Stream Unistall. If you ever wanna uninstall Shout Stream first reset all database values and then delete the folder. It’s also useful if you wanna start over the configuration. BEWARE: If you press that button action cannot be undone! Click for an image ↓↑
- Shout Stream Widget Configuration
If you wanna use the widget everything is configured through options page. But widget has also two more capabilities. Click for an image ↓↑
- You can place an image with a link. Image could be an ad or a logo or anything you want and will be displayed right after stats/player, whatever you have set above. Two fields to set, image URL (location) and image link URL (where the image is linking to).
- Right after an image (or without an image) you can have a note field (if you want). This is useful for some announcements or anything wanna write there (check my sidebar). Basic html tags are permitted here.
- Important Notes
1. If you make a static page, widget won’t be visible when visiting that page but will be visible to any other post or page at your blog.
2. POPUP Player acts the same as sidebar player. If Minicaster is enabled then every browsers will see it EXCEPT MSIE. If Minicaster is disabled then every browser will try to get the stream through Media Player. POPUP player title is stream’s name.
3. Mountpoint is only needed for icecast streams. For shoutcast streams leave it blank. Alternative streams can be mixed having any shoutcast or icecast streams you want.
4. Icecast basic stats will work only if bitrate is shown at the status.xsl page.
5. Customizing page for FFmp3 is right here! More questions about customizing it please let them there!
While you can see ALL FFmp3 skins and demo @ customization page you can also see some screenshots from the rest popup players in different browsers and sidebar players in the default Kubrick theme of WordPress. Open the following links to see them:
| MediaPlayer POPUP (MSIE) ↓↑ | Minicaster POPUP (FireFox) ↓↑ |
| Minicaster POPUP (Safari) ↓↑ | Minicaster POPUP (Opera) ↓↑ |
| Sidebar Media Player ↓↑ |
Sidebar Minicaster ↓↑ |
- Installation ↓↑
- Upgrading ↓↑
- FAQ ↓↑
- Changelog:
- version 3.3:Icons for popups, fixed a bug in JS, better support icecast/niceast stats.
- version 3.2: Bug in media player on static page fixed, added autoplay value in popup window.
- version 3.1: Bug in popup player fixed.
- version 3.0: FFmp3 player with 4 skins, 9 alt streams, check for flash 10, autoplay configuration.
- version 2.7: A fix for icecast and popup titles comes from stream names.
- version 2.6: A quick fix for IE popup.
- version 2.5: Support shortcode to add a page, 10 songs history, options page configuration and icecast support.
- version 2.4: Support multiple streams to POPUP, extended stats, widget only configuration and WP 2.7.X compatibility.
- version 2.3: Support LIVE stats using AJAX and WP2.6 compatibility.
- version 2.2: Support cURL for stat.
- version 2.1: Fixed POPUP dimensions & style.
- version 2.0: Minicaster flash player added end some JS errors fixed.
- version 1.5: Fixed an error for IE7 mplayer.
- version 1.4: Ready for WP2.5 and fixed width popup.
- version 1.3: Winamp link added and minor fixes.
- version 1.2: JS in HEAD so POPUP could be opened everywhere.
- version 1.1: Popup media player was added and changed stats.
- version 1.0: First release.
- Credits
Thanx a lot to Federico Bricker for developing FFmp3 flash player, i think that made me really happy these days when i had the chance to work with a decent open source flash player. He earned my respect!
Thanx a lot to the guys at Draftlight Networks who let me pack Minicaster along with Shout Stream plugin for the Wordpress users!
AJAX live stats was made using a script i found in DYNAMIC DRIVE website. I used the code from Dynamic Ajax Content script which was altered to work with Shout Stream plugin. Thanx a lot to the guys that developed it!
Feedback is more than welcome especially now with v3.0 so please let me kmow how it goes! Shoutcasters all over… Happy Streaming!



























31-01-2010 @ 01:17 [ID:11174]
I have two basic questions for you..
1) I like having the Mini FFmp3 player in my sidebar, because it attracts visitors visually – however, not all my visitors will figure out the popup window link below the player, and will loose the stream when they change pages in my site.
I would like to put up an image of the player instead of the player itself in the sidebar, that (when clicked) opens up the popup window.
Is there a good way to accomplish this please?
2) Like many others here, I too have not been able to get the stats to display.
My setup works like this – my library is defined in iTunes as a smart playlist.
Then, I use djay to open and play the items in the playlist sequentially (it will repeat the list once it completes a cycle), and then I use Nicecast to stream it.
The stream plays fine in my wordpress site thanks to you wornderful plugin, but no matter how I configure it to show the stats and history, nothing comes up.
I host the wordpress site on my own server at home.
I use my fixed IP as the sharing address in nicecast.
***server info deleted***
31-01-2010 @ 15:28 [ID:11176]
Hi Streamer
Go at your WP Control Panel and open Shout Stream configuration page. Then search for Enable or Disable Sidebar Stats and choose what you want. Same for Page Stats (if you ‘ve made a static page). The stats that are shown are specific and you cannot choose among them. It’s all or nothing. Altering plugins files to have only specific stats you want isnt possible at this time and requires many files to be changed and i dont advise you to do it.
Regards.
31-01-2010 @ 16:16 [ID:11177]
Hi Timothy, lots of questions here!
Let’s start from the stats.
First of all Shout Stream gets stats from Shoutcast or Icecast but stats from Nicecast could also be retrieved since its same as icecast. Problem is a different html structure status page (stat page) which sometimes confuses Shout Stream. If this is a typicall nicecast setup i will use your stream as a guide and include Nicecast stats at next release (planned for this month). Right now you wont be able to get any stats from your stream. Have in mind that Nicecast (as Icecast) dont have a public history page so (in new release) you will only have basic stats like “what’s playing now” but not latest 10 songs as you could have in Shoutcast.
Popup windows are dynamically created each time the link is clicked taking parameters from WordPress configuration page. You cannot just replace the code that shows the player with an image as you wont have the right link, needs a lot of tweaking setting a separate function that will do just that and so on. It could be done but it’s something custom. I would advise to wait for the next release where i ll have icons below the popup links that each of it will open a popup in media player, flash player, winamp, itunes etc. Then you wont need a sidebar player image.
I deleted all info you provided since there’s no need to let your server config in public view.
Thx a lot for the feedback and letting me know about Nicecast.
31-01-2010 @ 22:12 [ID:11178]
Hi.
I’m working with your Shout Stream WordPress plugin, and I’m wondering if there’s any way to get rid of the links under the plugin?
Thanks!!
31-01-2010 @ 23:50 [ID:11179]
Hi Yitzchok, if you mean the text links that open the popup windows just open shoutstream.php with notepad and then go after line 390 and search for “echo SS_text_links();” then put a double slash in front like this: //echo SS_text_links(); save and upload back.
03-02-2010 @ 05:03 [ID:11183]
I hope you can help – I have very little experience with shoutcast and I’m having trouble getting the widget to work. If you visit this page: http://www.misplacedmusic.org/test/?page_id=2
The player is active and it’s showing the correct information, however I get no sound when I press play. Can you tell me what I’m doing wrong?
03-02-2010 @ 08:14 [ID:11185]
Hey Kent,
i m in your page and all works smooth and sweet!
You must probably empty your browser cache and reload your page.
Nice music with your stream by the way!
04-02-2010 @ 11:49 [ID:11189]
I’m using shoutcast stream.
To check it works go to http://omskmusicradio.homeip.net:8001/
I have a trouble with viewing of shoutcast stats (song history).
1. If I set Shoutcast Stats Options:
Enable Sidebar Stats
Disable Page Stats
Method to fetch Stats is cURL
Seconds between updates: 5
Then I get:
Fatal error: Call to undefined function: curl_init() in
../wp-content/plugins/shout-stream/shout-stream.php on line 743
and all another page widgets unable to load and open via browser (Firefox).
2. If I set Shoutcast Stats Options:
Enable Sidebar Stats
Disable Page Stats
Method to fetch Stats is fsocket
Seconds between updates: 5
Then I get:
Warning: fsockopen() [function.fsockopen]: unable to connect to omskmusicradio.homeip.net:8001 in
../wp-content/plugins/shout-stream/shout-stream.php on line 796
# STREAM CONNECT FAILED
error N: 60
Check : configuration
PLEASE, help me to view my shoutcast stats!
04-02-2010 @ 11:52 [ID:11190]
How can you view your shoutcast stats when i try to reach http://omskmusicradio.homeip.net:8001/ and i got a CONNECTION FAILED in my browser?
If shoutcast is dead then NO stats are displayed.
PS: If your shoutcast server is hosted in your home check apache and firewall. PHP cURL must be enabled and the port of your stream should be open for the web visitors.
04-02-2010 @ 11:58 [ID:11191]
DeUCeD,
Yeah, right now stream is stopped.
Can you see my trouble tomorrow? Please.
04-02-2010 @ 15:04 [ID:11192]
I ll take a look but i cannot stay connected waiting for your stream. If it’s up by the time i ll be online i m gonna try to nail down the problem.
05-02-2010 @ 07:16 [ID:11193]
Some streaming host (spacialnet) do not set up http://spacialnet.com:port. They setup http:spacailnet.com/username12476157415. Is there a way to disable the requirement to have a port number? Because if port box is left blank that line is ignored.
05-02-2010 @ 08:15 [ID:11194]
First show me a live stream and i ll tell you what you can do to make it work.
05-02-2010 @ 14:37 [ID:11195]
The page with streams.
http://faithbaptist.churchhomepage.org/fbc-radio
The stream
http://wm4.spacialnet.com/fbcringgold141747
What is happening is that SpacialNet uses IDs. When using stream link visitors installed player opens, but script needs url:port. I am not complaining about script. I just hope there is a work around. I have tried with “FREE” streaming host and your script works excellent, but free streaming is very limited as you know. I would prefer listeners not be dropped.
05-02-2010 @ 19:45 [ID:11196]
Your stream IP is 209.51.163.229 but unfortunately i cannot resolve the username into port as this is done through your stream host. More than that i am not sure if this is a shoutcast server or a windows media server. If it’s a window media server then you got no luck with Shout Stream plugin since it’s focused on shoutcast/icecast streams.
If i were you i would ask my stream host and if its a shoutcast stream i would ask for the port to configure the player. As you said your stream host has tied usernames with ip:port asking you to use them. While that isnt common in shoutcast he may have his reason. But i dont think he would have any objections if was asked to give you real port:ip to configure your player.
Regards
06-02-2010 @ 21:29 [ID:11197]
Hi there, trying to get the Minicaster to display the current song. Your guidance would be greatly appreciated.
07-02-2010 @ 00:49 [ID:11198]
The player that pops up in another window..
[ see: http://wordpress.videvent.com for an example of my usage ]
I would like the currently playing track to scroll in the player window.
Is this possible?
It’s too bad the stats are not more configurable.
Nonetheless, if the current track can be displayed in the player window – I would be more than fine with that.
07-02-2010 @ 06:09 [ID:11199]
I just downloaded and installed Adobe FLEX – which updated my flash player 9 to the one with debugging features.
Now, when I go to your site here, or my own – running the Shout-Stream plugin, I get the following two error messages in a popup window..
VerifyError: Error #1033: Cpool entry 82 is wrong type.
ReferenceError: Error #1065: Variable Boot is not defined.
Any thoughts?
07-02-2010 @ 22:57 [ID:11200]
I want to know if I can add a widget to another website of mine that happens to be a ning social network Thanks.
08-02-2010 @ 08:17 [ID:11201]
Hey Timothy,
First of all FFmp3 requires flash 10 and above. Second thing to have in mind is that FFmp3 is a swf component that was build with haXe and and as far as i know you cannot edit it with a flash developer tool. If you would like to try it and recompile it you can get its sources and play with it.
Changes inside the player can be done of you understand haXe and recompile it. Federico Bricker developed it and a new version is up with some nice feautures that i ll pass to Shout Stream. But its his own project which i can rely on it since its the ONLY open source flash player that can handle memory leak when streaming in all browsers.
As for stats you use nicecast/icecast which only have a page with basic stats and not a history page like shoutcast where my plugin could read and display. Popup window could display the current song thats is played in a next version but i cannot give you an exact date for that. But its a great idea that i could implement when i ll find some free time.
Regards