Introduction: Thermal Tweeter Networked Twitter Printer

Picture of Thermal Tweeter Networked Twitter Printer

Send a Tweet to @dangerousproto and watch it print live on the USTREAM feed. This project was inspired by the Make it Tweet Challenge.

Thermal Tweeter is hacked together from a SparkFun thermal printer and the web platform internet development board. No computers are used to query twitter or run the printer, this is a 100% stand-alone Twitter appliance.

Keep reading to find out how it works. Read the original version of this article at Dangerous Prototypes.


You tweet, the web platform contacts Twitter and grabs the newest tweets, the tweets are formatted and output to the printer.

Is this wasteful? You bet. And the thermal chemicals on the paper may cause cancer - don't eat it! Thermal Tweeter is an homage to the waste generated by checkout receipts. Unlike a store checkout where you always get a receipt, you're in charge of the Twitter waste. Save the earth, don't Tweet. Or not.

Thermal Tweeter builds on our previous interactive internet projects like the @tweet_tree and internet graffiti wall.

Note: we noticed that Twitter sometimes excludes people from our feed. You can check here [JSON text] to see if your tweet was included. If not, just send it again, we've got tons of paper!

Step 1: Hardware

Picture of Hardware
Setup is really simple. The thermal printer connects to the web platform with one data wire. A second wire connects the common ground between them. 

Printer Web platform

A serial port assigned to pin IO7 on the web platform outputs serial data to the printer RX pin at 19200bps. See the web platform intro article for more about assigning hardware peripherals with peripheral pin select. See SparkFun's Arduino code and the printer datasheet for the simple control commands.

The printer requires a beefy 5volt power supply for the heating element (1.5A+). We used a 1.5A 5volt wall wort power adapter.

The web platform can be powered from USB or a wall wort. Our best wall wort is powering the printer, and we want to use the web platform USB connection for debugging info, so we used the USB supply. USB connection is only for power and debugging info, it doesn't contribute anything to the Twitter printer.

Step 2: Firmware

Picture of Firmware

Firmware is built on the @tweet_tree source. It searches twitter for the latest tweets to @dangerousproto and prints them.

"created_at":"Wed, 22 Jun 2011 16:19:17 +0000",
"text":"@dangerousproto Missed it =). Didn't know ustream doesn't work on the iPad.",
"id":83569757827248129, ...}
Tweets, user names, and IDs are extracted from a simple JSON search results feed, an example is shown above. JSON is a way to share data, like XML, but way more compact. The web platform stores tweet text in a giant array. After all new Tweets are processed, the text is sent to the printer.

The ID tag is especially important because it tells Twitter which tweets we already grabbed. The highest ID number is stored and appended to the next search URL. Twitter only sends tweets newer than the ID number so we only get fresh commentary.

The printer is controlled by 19200bps serial UART output from the web platform. Simple commands configure it. Using it is simple, send a line of ASCII text and print it with a line feed character (0x0a).

We used 32 characters per printed row. Row breaks are inserted into the tweet by the web platform without regard for the location of words, words will often be split on two lines. 

Server responses are dumped out the USB serial connection to help with debugging. The activity can be viewed on a PC with a serial terminal set to 115200bps. Even if you don't have a thermal printer, you can program the firmware into your web platform and watch the twitter queries.

Playing nice

Twitter doesn't like it when you hammer their server with requests. Thermal Tweeter waits at least 30 seconds between updates. This should be responsive, but stay within the 150 search/hour limit set by Twitter.

Don't kick Twitter when it's down. If Twitter doesn't reply or responds with an error, Thermal Tweeter retries twice and then waits a few minutes before trying again. It'll be easier for Twitter to get their act together if we don't flood them with search requests.


The firmware uses Microchip's TCPIP stack, which is a separate (free but not open source) download. It is compiled with the free C30 compiler. Our source and HEX files are in SVN.

Step 3: Taking It Further

Picture of Taking It Further


This project isn't fun without you. Please send us a tweet @dangerousproto and watch it print a few seconds later on the USTREAM live feed.

Taking it further

Originally we planned to add a keyboard for two way communications. Type a message and it is pushed to Twitter on enter, or every 140 characters.

Microchip's non-open source TCPIP stack is a pain to work with because we can't share all our code. We'd prefer to use the FreeRTOS port for the web platform instead.

Unfortunately we didn't have enough time to include these ideas in the final design.

Build one

You can build this project with SparkFun's thermal printer ($50), the web platform ($40), and a good 5volt power supply.


Jonathanrjpereira (author)2016-01-29

. I featured this Instructable in one of my collections:

jekimim (author)2012-11-02

Very good idea. You can also use it to print notes, shopping list, reminders ...

sockless (author)2011-06-29

Now, to connect Twitter to a teletype machine...

bschran (author)sockless2011-11-20

im game if you are... my dads an oldschool teletype man so maybe he can getter done :D

pastaking (author)2011-07-30

Idea: Have a set of printers in a 'tweetdeck' format, with an LCD and a small keyboard for tweeting!

bulb66 (author)2011-07-01


As your web server isn't available anywhere, if i make one following the hack a day write up with i need anything else? i.e programmer etc

Good luck in the contest


ian (author)bulb662011-07-01

The web platform and the HaD board are totally different. You can build your own web platform though, or it will be back in stock at Seeed Studio in a few days.

bulb66 (author)ian2011-07-01

Oh OK thanks, if i were to but one from Seeed Studio would i need anything else?

I'm in the UK, if you no of anywhere else that will have these in stock?


ian (author)bulb662011-07-01

Maybe Watterott in Germany, but I think they are out too.

bulb66 (author)ian2011-07-01

Would it be possible to out put the @ replies to another device? such as a LCD?

Also have you a link to a guide on how to modify the code for my twitter account?



ian (author)bulb662011-07-01

Sure, the output could be made to go just about anywhere. Coding would be needed.

There's no guide, but it's as easy as changing the web address on one line of code. However, the TCPIP internet driver is a pain to deal with, so if you want I will make you a custom compile with your address.

bulb66 (author)ian2011-07-01

Yes they are :-(

ChuckieDub (author)2011-06-28

Yay, paper waster. All hail deforestation.

Robot Lover (author)ChuckieDub2011-06-29

The trees have already been cut down to make the paper. It would be wasting to not use it.

ChuckieDub (author)Robot Lover2011-06-30

Good point. Touche sir.

midsummermuse (author)2011-06-28


-max- (author)2011-06-26

AHHH... the perfect ink (money) waster... though it is int resting...

J-Ri (author)-max-2011-06-26

It's a thermal printer, no ink here. It only wastes paper, but luckily that stuff grows on trees! :)

-max- (author)J-Ri2011-06-26

oh ok... i didnt read the instructable, just glanced over it. it is still cool and this is why you cant erase stuff on the internet. it can be burned into paper as a hard copy i see use for it in the 1980s goverment

bulb66 (author)2011-06-26

I love this Instructable and will without a doubt be voting for this, the only problem is the web platform is out of stock :(

Any chance this will change anytime soon, i would love one of my own :)


jhd04 (author)2011-06-26

Great, now Twitter is not only inane, it's also environmentally destructive. And for only a few hundred dollars in materials...

Get an aggregator on your phone. It's free, and doesn't waste paper.

imusewhipped (author)jhd042011-06-26

Yeah, I'm all for inanity, but I don't need it in hard copy, and certainly not at the expense of our environment.

slopez12 (author)jhd042011-06-26

Just what I was thinking...

Azayles (author)2011-06-26

Just seen it change now as four people tweeted :P That's eerie, and totally amazing!
I'm right in saying, aren't I? (five people now :P) that this will print off the tweets on your feed as they happen? So people you follow (ooh there's another!), it will print their tweets?

ian (author)Azayles2011-06-26

The way it's setup now it could be pointed at a keyword search, mentions, or your follows URL. If it was a long-term installation it would need a bit more finessing.

Azayles (author)ian2011-06-26

Sounds excellent :D And thanks for the timely reply ^_^
Could it be used to print out a facebook news feed of friends' status updates? Or would that need a host computer running a facebook API?

maxjus (author)2011-06-24

Awesome, ambitious, excellent project. Beautifully executed! The ustream channel was a fantastic addition!

About This Instructable




More by ian:Thermal Tweeter networked Twitter printer@tweet_tree: Twitter controlled Christmas treeHackable Christmas card & ornament
Add instructable to: