Introduction: Tweet-a-Pot: Twitter Enabled Coffee Pot

Picture of Tweet-a-Pot: Twitter Enabled Coffee Pot

Like the idea of making coffee on the fly? from your bed? While you're on the bus coming home? Then the Tweet-a-pot is for you!

Tweet-a-pot is the next in fancy twitter enabled devices. This coffee pot enables its owner to make a pot of coffee from anywhere they have cell phone reception, using twitter and an arduino board.

The tweet-a-pot is the easy implementation for remote device control! with a bit of code and some hardware, you can have your very own twitter enabled coffee pot.

Take a look at this quick video, Special thanks to Sam:

Step 1: Supplies

Picture of Supplies

To make your very own tweet-a-pot you will need the following

1 Power Switch Tail, this is basically a relay that is used to interface with the AC voltage
1 Arduino Board (any will do)
1 Computer running the arduino IDE and Python
1 Drip Coffee Pot

Step 2: Setting Up Your Computer

Picture of Setting Up Your Computer

First you need to set up your receiving computer.

To interface between the arduino and twitter, we are going to use python. There is a library that is already put together that enables us to use the twitter API. It's called python-twitter.

After you have installed python, install the python-twitter library and all its dependencies. If you run into trouble just consult the documentation over on the python-twitter website.

Next, install the Arduino IDE so you can program your arduino and talk to it via serial port.

Once those are set up and working, time to go grab your credentials from

Step 3: Setting Up Twitter

Picture of Setting Up Twitter

Interfacing with twitter used to be easy, all you had to do was put your name and password into your code and it would work. Now twitter has taken user info more seriously using oAuth, and as a result now you must register your app with twitter and get an API key.

First, make a twitter account for this project that is separate from your main twitter account. I chose, driptwit. 

Then, go to and register your app, this will enable you to grab 4 important pieces of information

-Access Token
-Access Token Secret
-Consumer Key
-Consumer Secret

These keys will be needed in the python code later to interface with the twitter API. After you have those 4 codes, you should be able to continue.

Step 4: The Code: Python Side

Picture of The Code: Python Side

First lets go over our python code. The python code basically uses the python-twitter library to ask twitter for the statuses of user "x", it then takes the last status and searches for the term "#driptwit".
if found sends the ascii value of 1 to the serial port (and to the arduino), if #driptwitstop is found, it sends an ascii value of 0.
Lastly it loops and checks the twitter account every 15 seconds looking for changes.

As you can see, below is where you enter the keys you got from twitter in the last step.

Here is the actual code:

# Tweet-a-Pot by Gregg Horton 2011 #
# Please email changes or #
# updates to #
# *****************************************#

##Import Libraries

import twitter
import serial
import time

##authenticate yourself with twitter
api = twitter.Api(consumer_key='consumerkeyhere', consumer_secret='consumersecrethere', access_token_key='accesskey', access_token_secret='accesssecret')

##set to your serial port
ser = serial.Serial('/dev/ttyUSB0', 19200)

## check serial port
def checkokay():

if line == ' ':
print 'here'
## Welcome message
print 'Welcome To Drip Twit!'
print 'Making Coffee..'
def driptwit():
status = [ ]
x = 0

status = api.GetUserTimeline('X') ##grab latest statuses

checkIt = [s.text for s in status] ##put status in an array

drip = checkIt[0].split() ##split first tweet into words

## check for match and write to serial if match
if drip[0] == '#driptwit':
print 'Tweet Recieved, Making Coffee'
elif drip[0] == '#driptwitstop': ##break if done
print 'stopped, awaiting instructions.'
print 'Awaiting Tweet'

while 1:
driptwit() ## call driptwit function
time.sleep(15) ## sleep for 15 seconds to avoid rate limiting

Step 5: The Code: Arduino Side

Picture of The Code: Arduino Side

The only connection between the python code and arduino is a single serial value. Python sends this as an ascii value, so arduino interprets this as a bit number, in our case 1= 49.

I didn't know how to make python spit out serial bytes, so after seeing what the python code was sending, i just modified the arduino code to react to the right value.

Here is the code:

Tweet-a-pot Gregg Horton 2011
Please email changes to so i
can improve this code!

Enables blinking/relay control over twitter, using python code
Based off of Blink and Serial demo code


int relayPin = 13; // LED connected to digital pin 13
int incomingByte = 0; //declare incoming byte
// The setup() method runs once, when the sketch starts

void setup() {
// initialize the digital pin as an output:
pinMode(relayPin, OUTPUT);
Serial.begin(19200); // set up Serial library at 19200 bps

Serial.println("Arduino is ready!");

// the loop() method runs over and over again,
// as long as the Arduino has power

void loop()
if (Serial.available() > 0) {
// read the incoming byte:
incomingByte =;
if (incomingByte == 49){
digitalWrite(relayPin, HIGH);
} else {
digitalWrite(relayPin, LOW);

// say what you got:
Serial.print("I received: ");
Serial.println(incomingByte, DEC);

Step 6: Hardware Setup

Picture of Hardware Setup

The hardware set up is pretty simple, as the AC voltage control is being handled by the power switch tail

The power switch tail allows you to hook up 2 wires, one to ground and one to the control pin, to turn on and off the relay. As seen in the code, all you need is a simple high/low statement.

Connect the arduino to your computer and make sure your serial port is set, then plug the power switch tail leads into pin 13 and ground

Next connect the coffee pot to the relay and plug the relay into a regular outlet. Its that easy!

The coffee maker has to have coffee and water in it as well before you begin.

Step 7: Make Some Coffee

Picture of Make Some Coffee

I did a lot of testing before hooking this up to an actual coffee pot (and even then found some bugs), but once you get it working, its time to make coffee!

Fill the pot with water and coffee grounds, and tweet to the account the code is following.

If the message contains the word #driptwit the coffee will start, if it receives #driptwitstop, or you tweet something else it will stop.

Once the pot of coffee is done, tweet again to turn it off. Its that easy!

Then enjoy your hot piping cup of tweet coffee.

Step 8: Final Thoughts

Picture of Final Thoughts

This project can be extended to any AC device that you want to control remotely. You could turn on lights or open garage doors with the same concepts

The code is not perfect, any improvements that people give me i will gladly include and test out. A large improvement on this project would be to integrate an ethernet shield so you wouldn't have to have a dedicated computer.

I want to give special thanks to the team the developed the python-twitter library, without them this project would be much harder.


Koneyiyo (author)2017-10-04


mbenguelamine90 (author)2017-06-02

Its a very nice Idea... lovely

balkan kuşcu (author)2017-04-24

ı want to ask somethink, the output of the power switch going to the coffee machine, but you cannot tell from the photo attached where the input ends

IshaanJ3 (author)2016-12-06

how can we make it without using power tail as I live in India and here it is not available

T0BY (author)2016-12-03

Lovely idea!

MattY18 (author)2016-01-30

New to the Arduino world. Having trouble uploading the code to the Arduino board. Also where do I input the Access Tokens and Consumer Key?

Jonathanrjpereira (author)2016-01-29

I featured this Instructable in one of my collections: along with many other Twitter Powered Instructables. I can't wait to make my own Twitter Enabled Coffee Pot.

ΓιώργοςΚ4 (author)2015-10-04

is it still working , please answer if u know :)

jperdomohn (author)2015-06-09

I will try this out , cause was the first thing that came to my mind when knowing about arduino for the first is great somebody else did it already!!

RobertGoldring (author)2014-08-20

great design, could a raspberry pi work as the receiving computer?

AmitS17 (author)RobertGoldring2015-04-04

Thats what I am currently making.

I am using Raspberry Pi 2 instead of laptop and according to me it definetely would.

iamm99 (author)AmitS172015-04-26

cant u just just rapsberry Pi 2? do u need arduino here?

eddierome (author)RobertGoldring2014-11-27

Hummm? Can the Arduino IDE run in Linux(Raspberry Pi). That is a good question.

AmitS17 (author)eddierome2015-04-04

There is Arduino IDE available for raspberry pi.(Raspian)

To get it use command sudo apt-get install arduino

BertugBerkay (author)2015-04-12

Is it still working ? I ve heard that twitter changed some policy or something.

ThomasL3 (author)2015-03-21

How do I program the part that adds water and coffee?

sakibmuhammad.anwar (author)2015-03-20

Made it :D

escaleraalcielo made it! (author)2014-12-06

It's working!!!

Greetings from Mexico

well done, very impressive

escaleraalcielo (author)2014-12-06

To connect to the serial port i use this code instead of the suggested one because allows to search in more than one serial port :D

##set to your serial port

#to use with linux locations = ['/dev/ttyACM0', '/dev/ttyACM1', '/dev/ttyACM2']

locations = ['COM3','COM4','COM5','COM6'] #to use with windows

for device in locations:


ser = serial.Serial(device, baudrate=9600, bytesize=8,

parity=serial.PARITY_NONE, stopbits=serial.STOPBITS_ONE)

print ("\nArduino found on: " + ser.portstr + " please wait...\n")




print "Failed to connect on", device

escaleraalcielo (author)2014-12-06

To register a new app you must go to the next link

Because dev.twitter send you to download fabric, the new Builder from twitter

davidbarcomb (author)2014-11-20

Great idea. Thanks for sharing us

tanish.kotyankar (author)2014-11-12

This is an amazing idea, but I was wondering that the requirement of a Laptop to be present doesn't make it as portable so what if we use a wifi shield to connect to the Arduino. I saw this in a different project that scanned twitter for particular phrases. Would we have to change the programming or will it remain the same. I am a curious Engineering Student and wanted to learn about this. Would appreciate your help.

luketyrel (author)2014-11-10

This is a really cool idea. Just wondering do you sell this device with out the coffee machine. I'm looking to buy a working version or pay a developer to create one with a simple laptop and AC switch.



FranciscoC (author)2014-09-10

Great tutorial, how can anyone activate the Coffee by sending a tweet? Is this possible to do in this example or similar?

danmellow (author)2014-08-28

wow this can be used for something bigger may be

LadySith (author)2013-10-14

I always come back to this page. Loved the idea since I saw it. We were planning on doing it for our space but we can't find a relay switch anywhere. Is there any way we can effectively mutilate a regular power supply to work as a relay switch?

ChrisW3 (author)LadySith2014-08-23

I know it is a bit late but did you try Radio Shack? Also Jameco (online or catalog) has a really good selection of loads of different things. Good luck to you!

KarateLover21 (author)2011-01-09

where did you get the serial module

Be sure to run the install command with sudo.

Mitch11011 (author)KarateLover212011-06-27

Ya I am having the same problem. I tried downloading a serial module from here but when I run the program I get an error.

KarateLover21 (author)Mitch110112011-06-28

yeah that module didn't work for me either.

HomuraRun (author)2012-10-22

I keep getting "Index Error: list index out of range". What does that mean?

jarrodramsey (author)HomuraRun2014-06-25

This is due to you not having any tweets. Post a dummy tweet and problem solved.

firater (author)HomuraRun2013-10-06

I also get that error. Could you find any solutions?

jdawgaz (author)2014-04-13

I am not sure why there is an arduino at all here. This could be done more simply by just using one of the gpio pins on the rpi.

even the original powerswitch tail only draws 40ma and 3.3v dc is good enough to switch the relay: well within the rpi tolerance.

this would eliminate the need for the serial library. and all of it could be done with just the python program.

jarrodramsey (author)jdawgaz2014-06-25

The tutorial is for Arduino, not rpi. It's very useful exercise for going Arduino training.

mist42nz (author)2013-12-09

What functionality is the Arduino providing in this circuit? It looks redundant, the output signal could be used to drive relay on the tail in a similar manner to how computer tills used to be activated by the serial port. The laptop is providing all the controller "decisions"

manoellemos (author)2013-11-22

Hi, I'm writing a blog post about cool home automation Arduino based projects and your's is going to be there. Do you allow me to use one or two of your pictures in the post? I'm linking the reference to tweet-a-pot back to this page.

animedubbedonline (author)2013-09-09

nice one

Kelly02 (author)2013-06-26

nice idea.

pnoytech (author)2013-04-24

Activating my arduino projects thru twitter is awesome! Thank you so much!

contactscolored (author)2013-04-04

Nice Instructable!

There are some really good things for people to learn here. (from your instructions, especially)

ProbioticSoundsystem (author)2013-03-08

very cool

ShadowJesus (author)2013-02-13

This is a fairly simple arduino project.

JensonBut (author)2013-01-25

I am fairly new to Instructables so I will have to take a look at putting it together. I definitely want to get a video up. I'll let you know when I get either up. (I tried replying but the captcha thing seems messed up)

tcerier (author)2012-11-20

Hi, I'm following this, and i'm having some issues. it would be great if someone could help me.

-first: when running, does the arduino need to be connected via a serial cable? or can one use the usb cable?

-Also, (my main problem) i recieve a serial error... what could this be?

beverageexpert (author)2011-02-05

for my twitter app these are the only keys I received
# Consumer key
# Consumer secret
# Request token URL
# Access token URL
# Authorize URL

so what would I use for
access_token_key='accesskey', access_token_secret='accesssecret')


there should be a button that says "Show me my access token...(etc).

pdxnat (author)beverageexpert2011-06-14

I've got an instructable here detailing the process of getting your tokens. Like everything, it's simple once you know how....

About This Instructable




Bio: I'm a full stack web developer focusing on security and privacy.
More by frenzy:Make a WreathVegan ThanksgivingWireless DeadDrop
Add instructable to: