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.

shout stream options

- 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.
shoutcast streams
(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.

shout stream options

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.

shout stream options

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!

shout stream options

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

  • Changelog:
  1. version 3.3:Icons for popups, fixed a bug in JS, better support icecast/niceast stats.
  2. version 3.2: Bug in media player on static page fixed, added autoplay value in popup window.
  3. version 3.1: Bug in popup player fixed.
  4. version 3.0: FFmp3 player with 4 skins, 9 alt streams, check for flash 10, autoplay configuration.
  5. version 2.7: A fix for icecast and popup titles comes from stream names.
  6. version 2.6: A quick fix for IE popup.
  7. version 2.5: Support shortcode to add a page, 10 songs history, options page configuration and icecast support.
  8. version 2.4: Support multiple streams to POPUP, extended stats, widget only configuration and WP 2.7.X compatibility.
  9. version 2.3: Support LIVE stats using AJAX and WP2.6 compatibility.
  10. version 2.2: Support cURL for stat.
  11. version 2.1: Fixed POPUP dimensions & style.
  12. version 2.0: Minicaster flash player added end some JS errors fixed.
  13. version 1.5: Fixed an error for IE7 mplayer.
  14. version 1.4: Ready for WP2.5 and fixed width popup.
  15. version 1.3: Winamp link added and minor fixes.
  16. version 1.2: JS in HEAD so POPUP could be opened everywhere.
  17. version 1.1: Popup media player was added and changed stats.
  18. 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!

302 Comments in 16 pages

Go to Comment Form »
  •  Timothy Hall said:

    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 ... ...

  •  ..::DeUCeD::.. said:

    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 noth... ...

  •  ..::DeUCeD::.. said:

    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 ... ...

  •  Yitzchok said:

    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!!

  •  ..::DeUCeD::.. said:

    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.

  •  Kent said:

    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. C... ...

  •  ..::DeUCeD::.. said:

    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!

  •  Antony NoFog said:

    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: ... ...

  •  ..::DeUCeD::.. said:

    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 enable... ...

  •  Antony NoFog said:

    04-02-2010 @ 11:58 [ID:11191]

    [-]

    DeUCeD,
    Yeah, right now stream is stopped.
    Can you see my trouble tomorrow? Please.

  •  ..::DeUCeD::.. said:

    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.

  •  Bill Huff said:

    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.

  •  ..::DeUCeD::.. said:

    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.

  •  Bill Huff said:

    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... ...

  •  ..::DeUCeD::.. said:

    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... ...

  •  Steve N said:

    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.

  •  Timothy Hall said:

    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... ...

  •  Timothy Hall said:

    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... ...

  •  Diana Broomfield said:

    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.

  •  ..::DeUCeD::.. said:

    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 pl... ...

Post a Comment

Are you a SPAMMER?   YES     NO   (required)