Stratus 2 BETA

Stratus is a jQuery powered SoundCloud player that lives at the bottom (or top) of your website or blog.

Installation

See installation guides for:  Wordpress  Tumblr  Blogger

Installing Stratus is easy. All you need to do is add some code to the <head> section of your HTML.

First, make sure you have jQuery installed. Once you've done that you're ready for the next step.

Next, include the main Stratus library.

<script type="text/javascript" src="http://stratus.sc/stratus.js"></script>

Finally, configure and load the Stratus plugin.

And that's it. For further customization options, keep reading.

Customization

You can customize Stratus by passing the appropriate options to the stratus function.

For example, the code below will cause the player to auto play a random QOTSA track and hide the download button.

Options

Refer to the table below for all configuration options.

KeyDefaultDescription
align'bottom'Whether the player appears at the top of bottom of the page. Acceptable values: top or bottom
animate'slide'How and if the player should animate when it opens. Acceptable values: slide, fade, or false.
auto_playfalseWhether the player should start playing automatically.
buyingtrueWhether the buy button should appear on the player.
color'F60'The color of the controls and waveform. Acceptable value: hex or name (from SVG color codes)
downloadtrueWhether the download button should appear on the player.
links An comma separated list of SoundCloud links. Can be a track, set, user, or group.
offset0This will position the player x pixels from the top or bottom of page depending on alignment.
position'fixed'Change to absolute if you do not want the player to scroll with the page.
randomfalseWhether the first played track is randomly chosen.
usertrueWhether or not the track artist name is shown on player.
statstrueWhether or not the stats for comments, favorites, and plays appear on the player.
themePass a css url to theme the player. For example http://stratus.sc/themes/dark.css
volume50The default volume level. Acceptable value: 0 - 100

New Features

Dynamically Add Tracks

You can now add tracks to Stratus right from your page. Simply give a SoundCloud track link the class of stratus and the player will do the rest. This works great for the discography section of your site.

<a href="http://soundcloud.com/foofighters/rope" class="stratus">Foo Fighters - Rope</a>    

Try it out: Foo Fighters - Rope

Sharing

Users can now click the share button to email, tweet, facebook, and embed your tracks around the web.

Commenting & Favoriting

Users can now comment and favorite tracks right from Stratus. Upon intially clicking either button, they will be asked to login to your player. Once logged in, they'll be able to comment and favorite currently playing tracks.

Tracklist

Double-click any blank space on the player to unveil a tracklist of all currently queued up tracks.

Pop-up Player

Users can now popup your player and continue listening to tunes while they browser your site.

Theming

If you'd like to change the aesthetic of Stratus beyond the coloring provided in the configuration options, all you need to do is pass a CSS sheet into the theme setting mentioned in the options chart.

Who's using it?

Feedback

Got a suggestion? Found a bug? Deployed the player on your site? Let us know api@soundcloud.com

FAQ

Can I keep Stratus playing even when the page reloads?

Not currently. Your site would need to be built so that it doesn't reload rather than the player. However, we do provide a popup function that users can click to enjoy your tunes while browsing your site.

How can I make YouTube videos appear below Stratus?

The trick is adding ?wmode=transparent to each of your YouTube videos. You can also adjust all YouTube videos on a single page with jQuery.