Skip to content

Yatcobot (Yet another twitter contest bot) is the most advanced and configurable bot for twitter contests and giveaways

License

Notifications You must be signed in to change notification settings

johnbuluba/Yatcobot

Repository files navigation

logo

The best bot for retweeting twitter giveaways!

Build Status codecov.io Maintainability

Do you want free stuff?
Do you like to win?
Do you want to participate in twitter giveaways but you dont have the time to search and retweet?
Yatcobot is the solution! A bot that search and retweet giveaways automatically!

Features:

  • Search for new giveaways Search and queue tweets to retweet, with a customizable way
  • Retweet Obviously...
  • Advanced sort Prioritize tweets found based on parameters like user defined keywords, age and popularity
  • Notification Can notify you using pushbullet when someone mentions you so you can quickly get your precious gift

Warning

Your account may be banned for using this kind of bot, so dont use your primary account


Visit our documentation for more info or follow these steps for a quick start!

Installation

The easiest way to install is:

pip install yatcobot

See more at Installation

Configuration

Before starting you must get api keys from twitter. You can get these keys from here. (See more at How to get twitter api keys)

You must create a config named config.yaml and must at least set the api keys. A minimal config.yaml is

twitter:
    consumer_key: your_consumer_key
    consumer_secret: your_consumer_secret
    access_token_key: your_access_token
    access_token_secret: your_access_token_secret

You can edit config.sample.yaml that is placed in the root of the project (dont forget to rename it to config.yaml) or view the sample on github

Config file is loaded automatically from specific paths. The paths that are searched for config.yaml are (from highest priority to lowest):

  1. ./config.yaml
    Search for config in the current working directory
  2. ~/.config/Yatcobot/config.yaml
    Search in config folder. If for example your username is user the full path will be /home/user/.config/Yatcobot/config.yaml
  3. default
    The default config that is packaged with the bot.

Also you can define another config with the --config argument, which will have the highest priority

Higher priority configs override settings that are defined in the lower. So in your config you only need to define the changes. (See more at Configuration documentation)

Run

In the directory where your config.yaml run:

yatcobot

Or you can specify the path of config with:

yatcobot --config=/path/to/config.yaml

See more at Command Line Arguments

Now just wait for all the free gifts!


Documentation

For more info visit our docs: documentation .


Donate

Please donate to support the development if you find this software useful (or if you are so rich from the staff you won).

Flattr this git repo

Donate with Patreon

Donate with Paypal

Donate with Bitcoin

Donate with Litecoin

Donate with Ethereum

Licence

This program is released under GPL v2

About

Yatcobot (Yet another twitter contest bot) is the most advanced and configurable bot for twitter contests and giveaways

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages