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. user_id,
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!
- Fork it ( https://github.com/jvenezia/tinderbot/fork )
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
License
Released under the MIT License, which can be found in LICENSE.txt.