Tinderbot

Tinderbot is a ruby wrapper for the Tinder API.

It also contains a bot which automatically like recommended people.

It can be used in ruby, or in command line.

Installation

Add this line to your application's Gemfile:

gem 'tinderbot'

Or install it yourself as:

$ gem install tinderbot

Getting your facebook authentication token

You'll need to supply a facebook authentication token and an associated facebook id.

You can get those manually by getting to this link:
https://www.facebook.com/dialog/oauth?client_id=464891386855067&redirect_uri=https://www.facebook.com/connect/login_success.html&scope=basic_info,email,public_profile,user_about_me,user_activities,user_birthday,user_education_history,user_friends,user_interests,user_likes,user_location,user_photos,user_relationship_details&response_type=token
Sign in, then pick up your authentication token from the access_token param in the url.
Get your facebook user id with this online tool by providing your profile url.

Tinderbot also provides a script to get your facebook credentials.

facebook_email = 'your facebook email'
facebook_password = 'your facebook password'

facebook_authentication_token, facebook_user_id = Tinderbot::Facebook.get_credentials facebook_email, facebook_password

Usage

Authenticating

Once you get your credentials, you can sign in to Tinder.

facebook_authentication_token = 'your facebook authentication token'
facebook_user_id = 'your facebook user id'

tinder_client = Tinderbot::Client.new
tinder_authentication_token = tinder_client.get_authentication_token facebook_authentication_token, facebook_user_id
tinder_client.sign_in tinder_authentication_token

Interacting with the Tinder API

user = tinder_client.profile #=> returns an instance of Tinderbot::Model::User
user.original_tinder_json #=> {...} original json from tinder's API
user.id #=> 1234
user.name #=> 'Bob'
user.bio #=> 'I am awesome'
user.birth_date #=> #<Date: 2014-05-01>
user.gender #=> :male (or :female)
user.photo_urls #=> ['http://photo_1_url.jpg', 'http://photo_2_url.jpg']

user = tinder_client.user user_id #=> returns an instance of Tinderbot::Model::User

users = tinder_client.recommended_users #=> returns an array of Tinderbot::Model::User instances

tinder_client.updates #=> {...} original json from tinder's API

tinder_client.send_message user_id, message

tinder_client.update_location '40.7313029,-73.9884189'

# you can provide a user instance or a user id to like or dislike users
tinder_client.like user
tinder_client.like user.id

tinder_client.dislike user
tinder_client.dislike user.id

tinder_client.remove user
tinder_client.remove user.id

Using the bot

Tinderbot provides a simple bot which automatically likes all recommended people. It stops when there is no more recommended people.

tinder_bot = Tinderbot::Bot.new tinder_client
tinder_bot.like_recommended_users

Using the command line tool

You can interact with Tinderbot with command lines.

> tinderbot
Commands:
  tinderbot autolike                     # Automatically like recommended people (Stops when there is no more people to like)
  tinderbot dislike USER_ID              # Dislike user
  tinderbot help [COMMAND]               # Describe available commands or one specific command
  tinderbot like USER_ID                 # Like user
  tinderbot location ALTITUDE,LONGITUDE  # Update location using latitude and longitude, e.g. tinderbot location 40.7313029,-73.9884189
  tinderbot profile                      # Get your profile data
  tinderbot recommended                  # Get recommended users
  tinderbot remove USER_ID               # Remove previously liked user
  tinderbot send USER_ID MESSAGE         # Send message to user
  tinderbot updates                      # Get updates
  tinderbot user USER_ID                 # Get user profile data

Contributing

Feel free to contribute!

1. Fork it ( https://github.com/jvenezia/tinderbot/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

License

Released under the MIT License, which can be found in LICENSE.txt.