Skip to content

mattmakai/mms-picture-roulette

Repository files navigation

Picture Roulette MMS

Deploy on Heroku

Picture Roulette is a game of chance that uses the Twilio and Flickr APIs. Flickr's tags are only as accurate as the humans who apply them to photos.

This program was originally designed to query a tag for a relevant picture. What we didn't expect is that Flickr users' use of tags would be so diverse and often nonsensical. Hence, the MMS Picture Roulette game was born!

How to play

Text a one-word query to your Twilio number from any texting device. Wait 30 seconds (or less), and receive your photo.

Does the photo match your query? You win.

Is the photo totally random? Everyone else playing wins (yes, this means you lose).

Requirements

  • Twilio API credentials
  • Flickr API credentials
  • Heroku Account - free tier

Setup

  • Click "Deploy to Heroku" button
  • Input your Twilio API credentials in the boxes provided
  • Launch the app. If it works, it should look like the photo below:

  • Now, copy the Heroku app URL and go to your Twilio account
  • On the Numbers page, click on the Twilio number you want to use. Make the URL the Messaging Request URL and save. Start texting.