sscodersen / tweitwit

Simple bot for twitter.

_{Coded with 💙 by edoardottt}

Description • Install • Usage • Notes • Contributing • License
live demo running on @ai_testing

Description 🔦

Simple twitter bot that can like and retweet your tweets, or search tweets with a specified topic. It stores and serves data with a Flask webapp. 🐦

Installation 📡

• git clone https://github.com/edoardottt/twitterbot2
• cd twitterbot2
• pip install -r requirements.txt
• Edit the config.yaml and globals.py files
• python init_db.py
• python twitterbot2.py -h

Usage 🚀

usage: twitterbot2.py [-h] [-v] [-t] [-k KEYWORD] [-p PORT] [-nu] [-nl] [-nr] [-s STATS] [-oc OUTPUT_CSV] [-oj OUTPUT_JSON] [-oh OUTPUT_HTML]

Twitterbot v2

optional arguments:
  -h, --help            show this help message and exit
  -v, --version         Show the version of this program.
  -t, --timeline        Search for tweets in the bot and user's timeline.
  -k KEYWORD, --keyword KEYWORD
                        Search for tweets with defined keyword(s). If more than one, comma separated enclosed in double quotes.
  -p PORT, --port PORT  Set the port to be used (default 5555).
  -nu, --no-user        Don't like and retweet user tweets.
  -nl, --no-like        Don't like tweets, just retweet.
  -nr, --no-retweet     Don't retweet tweets, just like.
  -s STATS, --stats STATS
                        Show the statistics of the inputted bot (username).
  -oc OUTPUT_CSV, --output-csv OUTPUT_CSV
                        Produce a csv file containing the stats for the inputted used (ALL for anyone).
  -oj OUTPUT_JSON, --output-json OUTPUT_JSON
                        Produce a json file containing the stats for the inputted used (ALL for anyone).
  -oh OUTPUT_HTML, --output-html OUTPUT_HTML
                        Produce a html file containing the stats for the inputted used (ALL for anyone).

See some examples to get started.

Useful notes/links 🔗

• Getting access to the Twitter api
• Twitter api rate limits
• This app uses a Flask webserver (default port 5555). Expose it on public Internet at your own risk (I use it behind NAT/firewall).
• ValueError: Unrecognised argument(s): encoding
• twitterbot2 Api documentation

Changelog 📌

Detailed changes for each release are documented in the release notes.

Contributing 🤝

If you want to contribute to this project, you can start opening an issue/pull request.
Read also Code of Conduct and Contributing files.

License 📝

This repository is under GPLv3 License.
edoardoottavianelli.it to contact me.