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.
Finally, configure and load the Stratus plugin.
And that's it. For further customization options, keep reading.
You can customize Stratus by passing the appropriate options to the
For example, the code below will cause the player to auto play a random QOTSA track and hide the download button.
Refer to the table below for all configuration options.
|align||'bottom'||Whether the player appears at the top of bottom of the page. Acceptable values: |
|animate||'slide'||How and if the player should animate when it opens. Acceptable values: |
|auto_play||false||Whether the player should start playing automatically.|
|buying||true||Whether 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)|
|download||true||Whether the download button should appear on the player.|
|links||An comma separated list of SoundCloud links. Can be a track, set, user, or group.|
|offset||0||This will position the player |
|position||'fixed'||Change to |
|random||false||Whether the first played track is randomly chosen.|
|user||true||Whether or not the track artist name is shown on player.|
|stats||true||Whether or not the stats for comments, favorites, and plays appear on the player.|
|theme||Pass a css url to theme the player. For example |
|volume||50||The default volume level. Acceptable value: 0 - 100|
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
Users can now click the share button to email, tweet, facebook, and embed your tracks around the web.
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.
Double-click any blank space on the player to unveil a tracklist of all currently queued up tracks.
Users can now popup your player and continue listening to tunes while they browser your site.
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.
Got a suggestion? Found a bug? Deployed the player on your site? Let us know firstname.lastname@example.org
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.
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.
Stratus is Copyright © 2012 SoundCloud, released under the MIT License.