TweetBoxBot is a script written in Python that automatically tweets random informations from a Linux machine.
The initial idea was to "speak" a Raspberry Pi on Twitter. The script tweets several information such as:
- CPU load
- CPU frequency
- CPU temperature
- available memory
- kernel version
- speedtest datas
- local time in a random city
- the temperature of a random city
- random GIF
- random Chuck Norris quote
- random Ron Swanson quote
- random popular movie title and picture
- the Astronomy Picture Of the Day from NASA
TweetBoxBot is used on my Raspberry Pi 2 with the dedicated Twitter account @TweetBoxBot.
You must have Python installed.
The script uses the speedtest-cli package to test the Internet connection. To install it, use your package manager (on Debian, do
apt-get install speedtest-cli).
However, if the package is not found, go through the Python package manager. Here are the commands:
apt-get install python-pip pip install speedtest-cli
Once installation is complete, test with
If you do not run the script on a Raspberry Pi, you have to install
lm-sensors to retreive CPU temperature.
TweetBoxBot uses the Twython package, which is a simple interface to communicate with Twitter in Python. To install it, just do:
pip install twython
Creating a Twitter application
To communicate on Twitter from the script with the Twitter API, you must create a Twitter application. Nothing complicated well. To do this, go on https://apps.twitter.com/.
Click on "Create new app" button. Just put a name and a description. You can put anything in the Website field.
By default, the app is set to read-only, so you won't be able to publish tweets. Go to the "Permissions" tab and modify access to "Read, Write and Access direct messages".
Once saved, go to the "Keys and Access Tokens" tab and click the button at the bottom ("Create my access token").
Leave the page open for later, we will need to copy paste some of those keys in the script.
The TweetBoxBot script
Download the script via the "Download ZIP" button to the right or do
git clone https://github.com/shevabam/TweetBoxBot.git directly on your machine.
The script is pretty simple. Each information transmitted over Twitter is a function. At the end of the script, I generate a random number having the maximum number of available functions. Thus, once found the number, the script launches the corresponding function and publishes on Twitter the content returned!
At the beginning of the script, you must change the following variables that correspond to the keys present in the page of the Twitter app:
CONSUMER_KEYby your Consumer Key (API Key)
CONSUMER_SECRETby your Consumer Secret (API Secret)
ACCESS_TOKENby your Access Token
ACCESS_TOKEN_SECRETby your Access Token Secret
Then, you have several others variables that you can edit:
GIF_CATEGORIES: contains search keywords to a random GIF on giphy.com
TMP_FILE: is the name of the recovered file from the Giphy API or TheMovieDb API (deleted after you send the tweet)
OWM_APIKEY: API key from openweathermap.org. This is my own key, but you can leave it
TMDB_APIKEY: API key from themoviedb.org
PING_HOSTS: array containing the hosts to ping randomly
TWITTER_SUFFIX: the content of this variable will be added to the final tweet, at the end
DEBUG: change to
Trueto enable the debug log
DEBUG_FILE: filename used to log
Finally, do this command to make the script executable:
chmod u+x TweetBoxBot.py
To test, simply run the following command in the script directory:
You should have a tweet on your Twitter account!
By default, if you run
./TweetBoxBot.py, the script will choose a random function to be executed.
However, you can perform a especially function, in argument :
Here are the available arguments :
Sending tweets automatically
For sending tweets automatically, you need to add a cron job on your machine.
The difficulty was to make sending tweets randomly. For my part, I chose a send period each about 1.5 and 11.5 hours using the following cron job:
0 5,17 * * * sleep $(( 100 + $(od -vAn -N2 -tu4 /dev/urandom) \% 600 ))m ; /usr/bin/python /root/TweetBoxBot.py
To explain briefly, every 12 hours (at 5 and 17), the task starts the command
sleep $((...))m. It allows to wait a random number of minutes between 100 and 700, so between 1.5 and 11.5 hours!
Finally, after waiting a random delay, the task launches the script TweetBoxBot.py that launch itself a random function and tweets the result!
You can see the result on Twitter, on @TweetBoxBot.
If you have any ideas for improving the script or to add features, please fork the project and do a pull request!
Thanks for reading me ;)
Twitter account of the creator : @shevabam