Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Give a SoundCloud download in exchange for a social interaction, such as Share on Facebook.
Ruby JavaScript
branch: email

This branch is 1 commit ahead, 97 commits behind master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.



This app allows you to distribute a free SoundCloud track download in exchange for a social interaction, such as Sharing on Facebook and Tweeting on Twitter. Effectively creating a "Tweet/Share for Download" campaign. The default application has many customization options, but feel free to adjust and fork as needed. You can see an example of the default app running here.


1. Install Ruby, RubyGems, & Rails

Mac OS X: Ruby and Rails comes pre-installed on Mac OS X, but you'll want to upgrade it by following these instructions.

Windows: Follow these instructions to install Ruby and Rails on Windows.

2. Install Git & Generate SSH Key

Git is a free & open source, distributed version control system designed to handle everything from small to very large projects with speed and efficiency.

  1. Install Git: On a Mac, Windows, or UNIX/Linux
  2. Sign up for Github
  3. Follow these instructions to generate an SSH key & add the key to your Github account.
  4. Set user name and email globally on git by following these instructions

3. Register a new SoundCloud application

  1. Make sure you're signed up for SoundCloud and logged in.
  2. Go here, name your app, and click Register
  3. Copy the Consumer Key and Consumer Secret to a text file for later

4. Register a new Facebook application

  1. Go here, name your app, agree to terms, and click Create Application
  2. Click Connect in the left column and add your Connect URL (url where your app will live), then click Save Changes
  3. Copy the Application ID and Application Secret to a text file for later

5. Register a new Twitter application

  1. Go here
  2. Name your application and give it a Description
  3. Input your Application Website (url where your app will live)
  4. Add your artist name as Organization and your artist website url as Website
  5. Make sure Browser is selected on Application Type
  6. Input your Callback URL (url where your app will live)
  7. Select Read & Write for Default Access type
  8. Click Save
  9. Finally, copy the Consumer Key and Consumer Secret to a text file for later


Clone the application on your local computer by running the following command in your Terminal emulator. (Terminal on Mac, Console on Windows)

 git clone project_name

Now you're ready to do some configuring.


Configuring the application is simply done by editing the following files auth.yml settings.yml in the config folder.

If you're looking for a decent text editor, try TextMate

1. Update Authentication File

  1. Input the following into config/auth.yml
  2. SoundCloud app Consumer Key and Consumer Secret into production > soundcloud > prokey & prosecret
  3. Facebook app Application ID and Application Secret into production > facebook > proappid & prosecret
  4. Twitter app Consumer Key and Consumer Secret into production > twitter > prokey & prosecret

2. Update Settings File

  1. Input the following into config/settings.yml
  2. Your promotion title, description, and track url
  3. Customize the player params as needed (You can view a full list of parameters here)
  4. You can also set your player type, height, and width
  5. Next input the promotion header and instructions
  6. Finally, adjust the button, header, and default status for both Facebook and Twitter.

Customize CSS & Images

Replace default images

Replace the following images within the public/images folder with something that relates to your competition.

  • bg.jpg: background image
  • logo.png: logo that appears in the top center of your app. Replace with another transparent png of your choosing.
  • artwork.jpg: a square 425 x 425 pixel image used for sharing. This should be the image associated with your track (album cover, single cover, etc).

Adjust default CSS

You can further customize the aesthetics of your application by adjusting application.css found within public/stylesheets. Here's a few ideas:

  • Change the color and font of text in the body selector
  • Change the color of links and their hover effect in the a selector
  • Change the color of headlines in the h1, h2 selector
  • Change the background gradient and color of the button in the button selector


Deploying on Heroku

  1. Create a Heroku Account
  2. Install the Heroku Gem
  3. And finally, deploy it to Heroku

Connect the App to Your SoundCloud Account

You must connect the app to the SoundCloud account which owns the track you are offering for download.

To do this, visit and login with the appropriate SoundCloud account.

Tips and Tricks

Coming Soon ;-)


SoundCloud-Social-Download is Copyright (c) 2010 Lee Martin and SoundCloud, released under the MIT License.

Something went wrong with that request. Please try again.