Forum Home Enhancements - Shoutcast Status 3 (VB4)

Shoutcast Status 3.0 on your VB4 ForumHome.

/* ----------------- 03/13/2010 -----------------
This is a Nice hack to add Shoutcast Status on your VB4 ForumHome.
Hope it helps !!!

Zachariah @ http://www.szone.us

SHOUTcast is a free-of-charge audio homesteading solution. It permits anyone
on the internet to broadcast audio from their PC to listeners across the
Internet or any other IP-based network (Office LANs, college campuses, etc.).

http://www.shoutcast.com

Zerro Queries Added

================================================== =====
Tested On:

vBulletin 4+
SHOUTcast Server v1.9.5
================================================== =====

== Install: 2-5 min ==

Full Stats
- Needs Shoutcast server admin password

Server Name
Last 19 songs
4 media layers (winamp, quicktime, media player, real player)
DJ Name
Bitrate
Current Song
Media Type
Most Ever Connected
Hit Count
Users Connected
Avj. Connect Time
User Max
Online / Offline status
XML Data Cache

Lite Stats
- Dose not need shoutcast server admin password

Server Name
4 media players (winamp, quicktime, media player, real player)
Bitrate
Current Song
Users Connected
User Max
Online / Offline status

================================================== =====
Adds: 2 plugins
Adds: 8 images, 2 files
Adds: 10 templates
Adds: 45 phrases
================================================== =====

VB3.8X - https://vborg.vbsupport.ru/showthread.php?t=126007
(Shoutcast Status 2.0, 4387 downloads)

[Zachariah]

================================================== =====
Changelog |
================
v3.0 - 03.15.2010
- Made the hack work for VB4.0
- Custom variable for location changed from $scast to {vb:raw scast}

v2.0 - 11.15.06

- Merged shoutcast lite and full into 1 program
** If you do not have an admin password for your shoutcast server you can get limited information from the server "lite".

- Stats and History moved
** There was a need to hit collapsible +/- image to show song history and server stats. This has been moved to a 2 vbmenus as a click dropdown.

- Show Off Line Status
** Set to "No" to remove off line template when the shoutcast server is off line, or there is no DJ source

- Select what usergroups can see the add-on
- Fully phrased
- Cleaned up code in templates
- Changed and added templates.

v1.9

9.06.06
- Moved body of hack to: /includes/shoutcast/scast.php vs. in datastore.
- added 2 templates: forumhome_shoutcast_who, forumhome_shoutcast_who_off
- popup player url from index.php to $vboptions[forumhome].php
- Locations:

* Above Header
* Below Header
* Under Navbar
* Above What's going on
* Inside What's going on
* Below What's going on
* Custom

Select "Custom" and place {vb:raw scast} in FORUMHOME template for custom location.

[Zachariah]

Originally Posted by ANARCH?

not a real problem, but only 9 song appear in list of "last 19 songs":


there is a way to solve that ?
ah, an other question ... i have 19 DJ's ... there is a way to show who is the DJ ?

- sc_sevr.ini (on the shoutcast server)

This is the "Boss in Charge" of what feeds to the XML files.

; ShowLastSongs specifies how many songs to list in the /played.html
; page.  The default is 10.  Acceptable entries are 1 to 20.
ShowLastSongs=20

If you can not change it you can remove the $song[9] - $song[18] from the "forumhome_shoutcast" template.

$servertitle = "Discription" - setting in DJ - DSP (I used for DJ Name).

If you choose not to show any/all:

Variables used.
Here is a list of variables that can be used in your "forumhome_shoutcast". If do not wish to show data, just remove the variables.

$scdef = Default station name
$scip = IP shoutcast server
$scport = Port of shoutcast server
$scpass = Admin password (not DJ) to shoutcast server
$song[t] = Song History:t can range from 0-19. EX: $song[0], $song[1], $song[2] .... $song[19] ----- $song[0] (zerro) is the current song playing.
$servertitle = "Discription" - setting in DJ - DSP (I used for DJ Name).
$servergenre = - setting in DSP.
$bitrate = Quility of the Bitrate - setting in DJ - DSP .
$url = URL - setting in DJ - DSP
$currentlisteners = Current connected users.
$maxlisteners = Max users for the server.
$listenamp = http://$scip:$scport/listen.pls
$listenlnk = http://$scip:$scport
$averagemin = average listener time in minuets
$peaklisteners = Most Ever
$content = Media Type
$streamhits = Hit Count

[Zachariah]

Most people pay for a shoutcast service, co-locate a server, host small servers on their local cable / dsl modem, or install via SSH to their web host.

Make sure you have Unlimited Bandwith on your web package if you plan to host the shoutcast server on your web server.

The bandwidth usage depends on "# of users connected" and the quality of the song in kbps.

uploadspeed / bitrate = max listeners , always leave some for overhead

Example: 256k upload speed / 56k bitrate = max 4 listeners ( 4* 56 = 224kbps ) keep in mind that your provider says he gives you 256kbps upload, the actual speed might be much lower.

Bitrates
192k CD quality
56k stereo
24k mono (like an AM radio, but works for music)
8k voice

[Zachariah]

HELP !! I Install the hack and I am always off line


CHMOD 666 scast_home.xml
- This file should be in the root of the forums folder. ($vboptions[bburl])

/forums/scast_home.xml - The vBulletin install folder.

To put less load on the shoutcast server and to speed up page loads. The shoutcast info the script gets is cached to your local webserver in that XML file. The XML file is called up when a request to show the data. If your cache file does not update then you are not connecting to the shoutcast server.

9 out of 10 times this is because of settings (port,ip,password) or your webhost has blocked ports. Many hosts only allow queries for data on port 80 (http, rss, xml feeds). I have seen many webhosts designate a port for "other" needs of their clients.

If you are 100% sure your setting and install is correct.

Send a ticket to your webhost and see if ports are blocked (ie:8000). If so they may give you another port you can use. Reset your shoutcast server to output on that port. Lastly, if there is nothing that your host will do, you can move the shoutcast server to output on port 80 vs. 8000.

[Zachariah]

Originally Posted by zep

ive tried to install it but it gives my site some kind of error.. I have tried to CHMOD 777 it but my friend says it can only be done on a linux server..

I understand, I develop on a windows box.
Do not worry about CHMOD.

In the zip build.

product-shoutcast_home_full.xml
install.txt
- upload
-- scast_home.xml
-- includes
---- shoutcast
------ scast.php
------ cache_templates.php
-- images
---- misc
-------- shoutcast_off.gif
-------- radio_sm.gif
-------- im_winmp.gif
-------- im_real.gif
-------- im_qt.gif
-------- im_mirc.gif
-------- im_genre.gif

When you upload the files to your web server you want to keep the folder structure in tact.

Everything in the "upload" folder will be placed in the root of your vBulletin install.

D:\httpdocs\forums

/forums/scast_home.xml

The forums/includes/shoutcast folder will be made and the php files uploaded.

The images by default will upload where the default style is installed. /forums/images/misc/. If you have a custom style with a different location then upload the images to the custom /images/misc/.

$stylevar[imgdir_misc] - style_location/images/misc

[Netaudio]

mERCI!

[Juggernaut]

<i>I use a free shout cast service, will this mod work with the free service? </i>

[dengbej]

lite or full?

[Juggernaut]

<i>I installed, but don't get anything on my forum, just offline shows. </i>