Flash Widgets for Streaming

Developers are free to use our Flash widgets on their site to stream music to their users.

Restrictions and Purpose

Widgets are designed to easily allow developers and users to add music to their website for their visitors to enjoy. They cannot be controlled via Javascript and there are no hooks to listen for when a song ends or begins. They are based on prior knowledge of songIDs or playlistIDs. They can be generated a customized from the Grooveshark website.

The widgets must remain visible and allow for user interaction.

Embedding Songs

You can embed songs using a songID returned from the Grooveshark API or the TinySong API. The embedded player looks like:

Playlist Widget

Parameters

Each of the following parameters appears twice in the embed code; make sure to change both instances. Unlike the single-song widget earlier, you have a lot more parameters that can be used to adjust the exact appearance you desire.

playlistID or songIDs

You can send either a playlistID or a comma-delimited list of songIDs to control what songs are in the widget upon load.

bbg

The hex color code provided here changes the background of the player itself inside the widget.

pfg

The hex color code provided here changes the player"s font color, along with the buttons for the player (not background color).

pbgh

The hex color code provided here changes the hover background of the player buttons.

pfgh

The hex color code provided here changes the volume control hover color (not the background).

bt

The hex color code provided here changes the footer font color.

bth

The hex color code provided here changes the footer hover font color.

bfg

The hex color code provided here changes the background of the footer.

lfg

The hex color code provided here changes the song listing font color.

lbg

The hex color code provided here changes the background of the song listing rows.

lfgh

The hex color code provided here changes the selected/hovered song listing font color.

lbgh

The hex color code provided here changes the selected/hovered song listing row backgrounds.

sb

The hex color code provided here changes the color of the scroll bar for the listing of songs.

sbh

The hex color code provided here changes the hover color of the scroll bar for the listing of songs.

p

This parameter changes whether the first song begins playing as soon as the player is loaded or not. p=0 means it doesn"t play on load and p=1 means it does.