Make a Twitter bot that tweets random images (with node.js)

Need help with this tutorial? Join the Botmakers community!

Note: If you're familiar with concepts like APIs, and maybe even have node.js installed, feel free to skip the introduction.

Page content

What is a bot?

Most people might think of bots as little automated programs that send out spam email and messages online. Yes, there are certainly those kinds of bots, but a bot is really just that: a little automated program, and it can automate all kinds of activities. Anything from generating images and poetry, to telling stories and letting you play games.

The only limits to what a bot can do is your imagination! And maybe the Twitter API rate limits.

In this tutorial, I am going to show you how easy it is to create your own Twitter bot using node.js, a popular framework that lets you run JavaScript on a server, as opposed to a browser, and Twit, a node.js library for interacting with Twitter's public API.

A few words on APIs

API, which stands for Application Programming Interface, is, to put it simply, a way for you to interact with the data of a website by accessing it directly on their server.

So for example, with Twitter's API you will be able to read Tweets as they are posted on the site, or post your own Tweets, respond to people, follow users, and pretty much everything else that a regular Twitter user could do using Twitter's website or mobile app.

This is the key part: Twitter's API is what lets you automate user behavior, in order to create a Twitter bot. And like I said in the beginning, this activity could be non-malicous and even entertaining.

So let's make something fun then!


First, let's install node.js. The instructions will vary a bit depending on your operating system, so just follow the official download and installation guide.

Once you have node.js installed, you can open your command line (check out this brief tutorial if you need to get up to speed with using it) and type:

node --version

When you type this and hit Enter, you should see something like 6.0.0 (the number might be a bit different, but the point is that you should see a number to check that node.js was installed correctly).

Great, now let's bootstrap our node.js application.

At its core, node.js is just JavaScript that can be executed on a web server. Let's try this: create a file called server.js. Inside this file, type:

console.log('I am making a Twitter bot!');

Save the file, go back to your console, and run your script:

node '/home/stefan/twitter-bots/server.js' 

Your console will display I am making a Twitter bot!. Very well, you just wrote your first node.js application! Let's move on to the actual bot now.

Node.js comes with a little program called npm, or Node Package Manager. npm lets you, among other things, keep node.js up to date, and install various libraries.

The one we are going to need today is called Twit. But before we install it, let's do one thing real quick.

Go back to your command line and type npm init. You will be prompted to fill out some basic information about your node.js app.

You can pretty much just keep pressing Enter to accept the default values. Once that's done, let's go back to npm and Twit.

Still in the command line, type npm install twit --save. This will download the Twit library and place the necessary files into the node_modules folder.

There is no real need to interact with the actual files, instead open your server.js file, delete the console.log command, and replace it with the following:

var fs = require('fs'),
    path = require('path'),
    Twit = require('twit'),
    config = require(path.join(__dirname, 'config.js'));

Here we are loading a few modules (or libraries). You already know Twit, and fs and path are modules that come with node.js by default and let your work with files.

As for config, we are going to need to make another detour.

Creating a Twitter app

Before you can start writing any code, you will need something called API keys. These will let you make API calls, or in other words, interact with the data on Twitter's website.

To get your API keys, you need to first create a Twitter app. Here's a quick guide on how to do that.

After that, you will have the following information:

  • Consumer Key
  • Consumer Secret
  • Access Token
  • Access Token Secret

Now we need to create a new file called config.js, it will look like this:

var config = {
  consumer_key:         'XXXXX',
  consumer_secret:      'XXXXX',
  access_token:         'XXXXX',
  access_token_secret:  'XXXXX'

module.exports = config;

Replace XXXXX with matching values, for example, consumer_key should be your app's Consumer Key, and so on.

Now you can go back to your server.js file and add the following code:

var T = new Twit(config);'statuses/update', { status: 'Look, I am tweeting!' }, function(err, data, response) {

So your full server.js file should look like this:

var Twit = require('twit')

var fs = require('fs'),
    path = require('path'),
    Twit = require('twit'),
    config = require(path.join(__dirname, 'config.js'));

var T = new Twit(config);'statuses/update', { status: 'Look, I am tweeting!' }, function(err, data, response) {

And now, back to the console:

node server.js

Your console will fill up with a bit of information about the successful posting of your tweet, and if you switch to your browser and look at your bot's profile page --

Your bot's first tweet

Congratulations, your bot is now tweeting!

There are two more steps left now. Making your bot do something interesting, and hosting your bot somewhere so that you can turn off your computer without having to shut down the script powering your bot.

Cute animals bot

Here's an idea: maybe our bot could post cute pictures of puppies, kittens, panda bears, and other animals!

First, download a few pictures of animals that you think look cute. Create a folder called images and add these images here.

Next, remove the code that posted your first tweet:'statuses/update', { status: 'Look, I am tweeting!' }, function(err, data, response) {

We are going to write these two functions:

We will read all the files in our images folder and use the above two functions to pick one random image, upload it to Twitter, and post it.

Here is the first function:

function random_from_array(images){
  return images[Math.floor(Math.random() * images.length)];

We're using a little trick here. On its own, Math.random() returns a random number between 0 and 1 (excluding the number 1). What we need is to pick a random number between 0 and the last index of our array, so that we can access a random element of the array.

In my case, images.length will be 5. So Math.random() * images.length will always give me a number between 0 and 5, but excluding the number 5, which is okay, because the index of an array in JavaScript starts at 0, and the last index is always its length minus 1.

To avoid picking a number like 3.202108, we are using the Math.floor() function, which rounds the number down to the nearest whole number.

With the random_from_array() function in place, we can now start uploading the images. Here is the function, with a few console logs for easier understanding of the code.

function upload_random_image(images){
  console.log('Opening an image...');
  var image_path = path.join(__dirname, '/images/' + random_from_array(images)),
      b64content = fs.readFileSync(image_path, { encoding: 'base64' });

  console.log('Uploading an image...');'media/upload', { media_data: b64content }, function (err, data, response) {
    if (err){
      console.log('Image uploaded!');
      console.log('Now tweeting it...');'statuses/update', {
        media_ids: new Array(data.media_id_string)
        function(err, data, response) {
          if (err){
            console.log('Posted an image!');

There are some more technical parts to this, but in essence, we pick a random image from our folder (using the random_from_array function), and then load the file into a variable b64content.

The b64 refers to Twitter requiring the uploaded media files to be "base64-encoded" (see this StackOverflow thread for a more technical explanation of what this means).

Once we load our image, we can use Twitter's media/upload API endpoint (documented here). After the image is succesfully uploaded to Twitter's server, we can use the statuses/update method we previously used to post our first tweet and use it to post the image.

We need to first see what files are in our images directory.

fs.readdir(__dirname + '/images', function(err, files) {
  if (err){
    var images = [];
    files.forEach(function(f) {

    }, 10000);

When you run node server.js now, you will see your Twitter bot post a random picture every 10 seconds (or 10,000 milliseconds).

Great job so far!

Your console will show what the bot is up to:

Opening an image...
Uploading an image...
Image uploaded!
Now tweeting it...
Posted an image!

And once again, looking at our bot's Twitter page, we see it was indeed posting.

Posting images

Running into problems? See the full code on GitHub.

You can press CTRL+C while using the command line to end the script.

Also, if you want to delete the image after posting it, you can use fs.unlink for that, so add this to the upload_random_image function, after you successfully post an image to Twitter:

fs.unlink(image_path, function(err){
  if (err){
    console.log('ERROR: unable to delete image ' + image_path);
    console.log('image ' + image_path + ' was deleted');

(See server-delete-images.js on GitHub.)

This way you can choose whether you want to cycle through all the images or only use each image once. You could also keep a list of images you already posted to avoid posting the same one twice in a row, or too many times. Or you could move the images to a different folder after posting them, and once your original folder is empty, move them back.

Hosting your bot

Great, so now you have your very own image-tweeting bot. The final step is moving the code to a server that will host the bot for you.

I put the finished code on GitHub and I also wrote a tutorial on importing GitHub projects to Glitch, which is a really awesome and free app that lets you create and remix all kinds of fun apps, including bots.

(Note: I made a Glitch version as well, but this one doesn't let you delete images.)

For a good overview of all your bot-hosting options, check out this list of available hosting solutions, but keep in mind that almost all of them are paid, starting at $5-7 a month. And the free options are usually quite limited (for example, Heroku only allows your app to run for a few hours every day if you're on the free plan).

Note: This tutorial is based on an older version that used OpenShift for hosting, you can find the instructions here.

I hope you enjoyed making your Twitter bot! Feel free to browse the Twit documentation and Twitter API documentation to learn more about what your bot can do, and maybe get some more ideas browsing open source Twitter bots here on Botwiki!

And you are always welcome to join the Botmakers community :-)

Support Botwiki through donations or the Botwiki store! Here's a list of our supporters.

Tags: #tutorial #twitter #images #node #nodejs #node.js #fourtonfish #botwiki-original