QR_STENCILER and QR_HOBO_CODES
Yep, it’s a QR code stencil generator! The F.A.T. Lab is pleased to present QR_STENCILER, a free, fully-automated utility which converts QR codes into vector-based stencil patterns suitable for laser-cutting. Additionally, we present QR_HOBO_CODES, a series of one hundred QR stencil designs which, covertly marked in urban spaces, may be used to warn people about danger or clue them into good situations. The QR_STENCILER and the QR_HOBO_CODES join the Adjustable Pie Chart Stencil in our suite of homebrew "infoviz graffiti" tools for locative and situated information display.
CONTENTS
ABOUT THIS PROJECT
QR codes are a form of two-dimensional barcode which are widely used to convey URLs and other short texts through camera-based smartphones. A variety of free tools exist to generate QR codes (such as the Google Charts API) and to read them (such as TapMedia’s free QR Reader for iPhone app). Our QR_STENCILER is a Java-based software utility which loads a user-specified QR code image — from which it then generates a lasercutter-ready, topologically correct stencil .PDF. As Fred Trotter has pointed out, QR codes contain stencil islands in unpredictable configurations. QR_STENCILER automatically detects and bridges these islands, using thin lines that are minimally disruptive to the highly robust QR algorithm. It does so through the use of two basic image processing techniques: connected component labeling (sometimes called blob detection) and 8-connected chain coding (sometimes called contour tracing). QR_STENCILER was created with Processing, a free, cross-platform programming toolkit for the arts.

Closeup of a QR code lasercut in 1/8"-thick fiberboard. The QR_STENCILER automatically thickens corners between squares (left) and generates "bridges" to connect stencil islands (center). The level (amount) of island bridging is user-adjustable.
Accompanying the QR_STENCILER are the QR_HOBO_CODES (see below), a set of 100 lasercutter-ready QR stencil designs created with the QR_STENCILER software. These stencils can be understood as a covert markup scheme for urban spaces — providing directions, information, and warnings to digital nomads and other indigenterati. We present these as modern equivalents of the chalk-based "hobo signs" developed by 19th century vagabonds and migratory workers to cope with the difficulty of nomadic life. Indeed, our set of QR stencils port a number of classic hobo annotations to the QR format ("turn right here", "dangerous dog", "food for work") as well as some new ones, with a nod to warchalking, that are specific to contemporary conditions ("insecure wifi", "hidden cameras", "vegans beware").

Examples of 19th- and 20th-Century "hobo signs". Sources: Fran DeLorenzo (left), Wikipedia (right).
DOWNLOAD & INSTRUCTIONS
QR_STENCILER has been tested in MacOSX 10.6.8, but (since Processing is a cross-platform toolkit) it should work in Windows or Linux as well.
- Make yourself a QR code image which embeds a short piece of text. GoQR.me, Google and Kaywa all provide free online QR generators. To reduce the complexity of the stencil, we recommend generating your code with the shortest possible texts, and with lower levels of error correction (L-level or M-level). At the same time, we recommend generating QR code images with more pixel resolution, such as 500x500px; for QR_STENCILER, the ideal input image has a “grid size” of about 20 image-pixels per QR grid-cell. (See this QR code for an example; it has 23-pixel grid-cells in an overall image size of 540x540px.)
- Download QR_STENCILER.zip, and unzip this to a folder. The QR_STENCILER is also available from this Github repository.
- Although the zip includes compiled executables for Mac, Windows and Linux, we recommend running the QR_STENCILER from the Processing development environment. Download and install the Processing development tool. The QR_STENCILER works with Processing v.1.5.1 or later.
- Put your QR code image in the folder, ‘QR_STENCILER/data/’
- Launch Processing and open ‘QR_STENCILER.pde’
- Press ‘Run’ (Command-R) to start the stenciler.
- You will be prompted to Open your QR code image. (A default “hello world” QR code will be opened if none is provided).
- After opening the QR code image, the program will generate a stencil .PDF in the ‘data’ folder. Note that there are some options (checkboxes, sliders) which you can use to alter the generated stencils in various ways, including (for example) generating “reverse” (white-on-black) stencils.
- The .PDF can be opened in your favorite CAD program, for laser-cutting materials like cardboard, delrin, MDF or acrylic. If you need to find a lasercutter, consider Ponoko.com, which ships anywhere. You can also Google ‘lasercutting service‘ to find a bureau near you, or check the Architecture or Design departments of your local university. (Of course, you could always print out the PDF on paper if you prefer to cut the stencil by hand. Cheap!)
- For non-permanent outdoor marking materials, we recommend Erwin Strait-Line 64908 powdered chalk; black spray chalk; black finger paint; and Crayola Sidewalk Paint.
- After marking your stencil, test it with a QR code reader, such as TapMedia’s free QR Reader for iPhone app.
LICENSE
The QR_STENCILER software is provided "as is", without warranty of any kind. QR_STENCILER is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License. You are free to distribute, remix, and modify QR_STENCILER, so long as you share alike and provide attribution to FFFFF.AT. The repackaging of QR_STENCILER as or into commercial software, is expressly prohibited. Please note that QR_STENCILER also enjoys protections under the GRL Repercussions 3.0 license. More details about QR_STENCILER’s license and warranty can be found in the preamble to its main code file, QR_STENCILER.pde; for other uses, please contact us. The 100 QR_HOBO_CODES and their respective stencils are hereby dedicated to the public domain.
![]() 25-minute wait png | stencil |
![]() assholes png | stencil |
![]() bad coffee png | stencil |
![]() bad food png | stencil |
![]() bad tempered owner png | stencil |
![]() bad water png | stencil |
![]() be alert png | stencil |
![]() be quiet png | stencil |
![]() be ready to defend yourself png | stencil |
![]() beware pickpockets png | stencil |
![]() bike thieves png | stencil |
![]() boring png | stencil |
![]() broken meter png | stencil |
![]() camera perverts png | stencil |
![]() camp here png | stencil |
![]() cars ticketed png | stencil |
![]() caveat emptor png | stencil |
![]() changing table png | stencil |
![]() cheap drinks png | stencil |
![]() check cashing png | stencil |
![]() civilized place png | stencil |
![]() contraception available png | stencil |
![]() cops active png | stencil |
![]() cops inactive png | stencil |
![]() danger png | stencil |
![]() dangerous homophobes png | stencil |
![]() dangerous neighborhood png | stencil |
![]() dishonest scalpers here png | stencil |
![]() dog png | stencil |
![]() food for work png | stencil |
![]() free doctor png | stencil |
![]() free out-of-date food png | stencil |
![]() free wifi png | stencil |
![]() get out fast png | stencil |
![]() go straight png | stencil |
![]() good cheap food png | stencil |
![]() good coffee png | stencil |
![]() good for a handout png | stencil |
![]() good to kids png | stencil |
![]() good veg-burger png | stencil |
![]() good water png | stencil |
![]() GPS is incorrect png | stencil |
![]() great dumpster png | stencil |
![]() habla espanol png | stencil |
![]() has showers png | stencil |
![]() help if sick png | stencil |
![]() here is the place png | stencil |
![]() hidden cameras png | stencil |
![]() high-fee ATM png | stencil |
![]() hold your tongue png | stencil |
![]() insecure wifi png | stencil |
![]() it’s fake png | stencil |
![]() just ignore him png | stencil |
![]() keep away png | stencil |
![]() keep going png | stencil |
![]() kind family png | stencil |
![]() lax oversight png | stencil |
![]() look down png | stencil |
![]() look up png | stencil |
![]() lots of outlets png | stencil |
![]() mean to children png | stencil |
![]() nice bathroom png | stencil |
![]() no bathrooms png | stencil |
![]() no changing table png | stencil |
![]() no fee ATM png | stencil |
![]() no outlets png | stencil |
![]() no pets png | stencil |
![]() no privacy png | stencil |
![]() open late png | stencil |
![]() over-priced png | stencil |
![]() over-rated png | stencil |
![]() owner gives to GOP png | stencil |
![]() owner has a gun png | stencil |
![]() perverts png | stencil |
![]() pissoir png | stencil |
![]() Plan B sold here png | stencil |
![]() prostitution sting png | stencil |
![]() scammers png | stencil |
![]() sleep in barn png | stencil |
![]() speed trap png | stencil |
![]() stay low png | stencil |
![]() strong phone signal png | stencil |
![]() talk religion get food png | stencil |
![]() tell a hard luck story here png | stencil |
![]() test market png | stencil |
![]() those aren’t real png | stencil |
![]() toll road png | stencil |
![]() tramp camp png | stencil |
![]() tramps arrested on sight png | stencil |
![]() turn left here png | stencil |
![]() turn right here png | stencil |
![]() unexpectedly good coffee png | stencil |
![]() unsafe area png | stencil |
![]() use gloves png | stencil |
![]() used frying oil available png | stencil |
![]() vegans beware png | stencil |
![]() well guarded png | stencil |
![]() will give to get rid of you png | stencil |
![]() work available png | stencil |
![]() worth saving png | stencil |
ACKNOWLEDGMENTS
QR_STENCILER was created by Golan Levin and Asa Foster III with support from the STUDIO for Creative Inquiry at Carnegie Mellon University. Thanks to Ben Fry, Andreas Schlegel, Marcus Beausang, Neil Brown & Judy Robertson for the terrific code they have made available online. A tip of the hat to Fred Trotter, Jovino, Ric Johnson, le Suedois, Patrick Donnelly, David J. Burden, Matt Jones and others who have gone down similar or related paths. Additional thanks to Andrea Boykowycz for creative input. Some of the QR_HOBO_CODES are adapted from or inspired by designs presented elsewhere by Fran DeLorenzo and Cockeyed.com. "QR code" is trademarked by Denso Wave, Inc.
KEYWORDS
Barcode, QR code, stencil, QR code stencil, graffiti, grafitti, graffiti research, graf technology, street art, culture jamming, tactical media, urban messaging, locative media, situated visualization, contextual computing, lasercut, laser cutter, digital fabrication, template, chalk signs, chalk, spray paint, spraypaint, fffffat lab, hobo culture, hobo signs, warchalking.
- BROWSE / IN TIMELINE
- « Media Artist Contingency Plan
- » ‘When We Were Kings” docu and gallery walkthrough
COMMENTS
Al added these pithy words on Jul 19 11 at 1:18 amAny recommemded sites that will create the lasercut boards?
golan added these pithy words on Jul 19 11 at 2:02 amGoogle ‘lasercutting service‘ to find a bureau near you, or check the Architecture or Design departments of your local university.
Apostolos added these pithy words on Jul 19 11 at 3:11 amIn your opinion which is the best QR code generator? I’ve tried several ones within the past year, but many provide messed-up & non-readable QRs.
narnua added these pithy words on Jul 19 11 at 5:29 amThis is a nice one I use often (other than generating my own with software libraries)
http://qrcode.kaywa.com/For lasercutting you can use ponoko.com, send in your design & shipped anywhere
J. added these pithy words on Jul 19 11 at 7:24 amvery cool! thanks!
corgimas added these pithy words on Jul 19 11 at 7:26 amYou might want to double check your codes/names….looks like some of those codes up there are rearranged…..
Kieran added these pithy words on Jul 19 11 at 1:49 pmThis is very cute, and huge kudos for your work, but, some musings…
How small can you make these can still have them be effective? 1′ square stencils are a little big for the average urbanista, and the size also severely limits the range of stencils one could carry. Could you make them palm-sized and colour them with a sharpie? Or, better still, create some kind of hand-portable, Arduino-based QR graffiti printer (allowing you to leave any QR code you choose at any location)…
golan added these pithy words on Jul 19 11 at 2:31 pm@Kieran I’m working on a boxed set of 100 delrin mask sheets, which are 7″x7″. Each cell in the QR codes is around 0.25 – 0.33″, depending on the message. This is just large enough to color in with a sharpie or paint pen, but it’s more convenient to use a small (pocket) spraypaint can, such as Krylon Short Cuts (3oz can) or Duncan Tulip Fabric Spray Paint (2oz can).
golan added these pithy words on Jul 19 11 at 2:33 pm@corgimas, is there a specific example which is mis-labeled or mis-linked? The HTML was auto-generated; there “shouldn’t” be any errors. In all cases the text links appears below the corresponding image.
corgimas added these pithy words on Jul 19 11 at 2:36 pmI tried running a few of them off the screen with my phone and they came up mixed – but they were other codes on the page, not like the codes did not work at all!!!! Sorry i did not take any notes on them!!!
r
golan added these pithy words on Jul 19 11 at 2:38 pm@Apostolos – As I suggested in the text, I like the Google QR generator, documented at http://code.google.com/apis/chart/image/docs/gallery/qr_codes.html. To generate a QR code with this tool, follow this URL in your browser:
LINK — then start fiddling with the URL!
golan added these pithy words on Jul 19 11 at 2:57 pm@corgimas – I just exhaustively checked the hobo codes; all of the images are correctly labeled and linked. If you point your phone at a page full of different QR codes, however, it’s impossible to guarantee which one of the codes your phone will select to read.
Justin Watt added these pithy words on Jul 19 11 at 5:12 pmGolan, neat. Used your code to generate a transparent PNG “stencil” of sorts.
Rich added these pithy words on Jul 19 11 at 5:18 pmDo you think its possible to alter the code to work with any 2D 1bit graphics (ie just black / white pixels)?
Timbotron added these pithy words on Jul 19 11 at 7:59 pmHere’s a nice collection of early/original hobo signs. Use as you see fit, and enjoy:
http://supersecretclubhouse.blogspot.com/2011/02/secret-hobo-signs.html
golan added these pithy words on Jul 20 11 at 12:15 am@Rich – in principle, it would be quite easy to modify my code to produce stencil patterns from arbitrary black-and-white images. However, to produce the best results, the QR_STENCILER relies on the assumptions that (1) the input image consists of axis-aligned squares and rectangles, and (2) that these rectangles are sized according to integer multiples of some basic grid size. The code might still “work” (in some basic sense) if these assumptions are not true. But I would have written the code quite differently if I was dealing with such a general problem.
golan added these pithy words on Jul 20 11 at 1:23 am@narnua, thanks much for your terrific suggestions. I’ve incorporated them into the main blog post.
golan added these pithy words on Jul 20 11 at 3:07 amGeoffrey Dorne has kindly translated the QR_HOBO_CODES into French: http://graphism.fr/les-hobo-signs-de-2011-seront-des-qr-codes-vagabonds-armezvous-de-vos-tlphones/. He’s done a nice job maintaining the idiomatic flavor of the texts :) In his honor I’ll shortly produce a set of French QR stencils.
narnua added these pithy words on Jul 20 11 at 4:56 pmYou can also find your local Fablab or hackerspace, most Fablabs and some hackerspaces have lasercutters:
http://en.wikipedia.org/wiki/Fab_lab
http://hackerspaces.org/
Bryan Croft added these pithy words on Jul 21 11 at 3:00 amNice tool ! – im playing with now …and we have 3 laser engravers… hit me up ill make you one for free just to play with the laser :)
Brainspore added these pithy words on Jul 21 11 at 1:23 pmCool idea, I’ve been working on something similar but the software to streamline the process is a huge improvement.
If I may offer a suggestion, black spray chalk is an easier-to-use alternative to powdered chalk. It’s pretty hard to find compared to white spray chalk but one place that sells it is here: http://artprimo.com/catalog/molotow-chalk-spray-paint-p-1122.html
Awkward Engineer added these pithy words on Jul 21 11 at 2:15 pmcool dude! i had a project just like it I put up a few months ago. didn’t have the java program to make it automatically though.
I had a project just like this, although I didn’t have the java to made the .pdf for me automagicly.
Golan added these pithy words on Jul 21 11 at 2:27 pm@Brainspore – thanks for the tip! Feel free to add a link to your related work if you have a page for it.
Bryan Croft added these pithy words on Jul 21 11 at 4:02 pmwow – thanks for this tool ! we jsut made a few on our laser … took all of 5 minutes :)
John added these pithy words on Jul 22 11 at 8:12 amI do like this – perhaps clean graffitti could be done doo I’d the stencil is placed in a very green stone surface and is treated with a bleach solution? We’re at http://www.qrcodemaker.co.uk if you want to try us out.
Charles Boisseau added these pithy words on Jul 22 11 at 9:42 amI don’t get it. Say you use the “free wifi” stencil you provided. When I click on that where do i go to learn what the QR code is saying? When a person clicks on your code for free wifi it just shows me the code. It needs to say “Free Wifi” on a smartphone to know what the message is. So your codes need to connect online someplace. How can I see those messages?
Golan added these pithy words on Jul 22 11 at 2:34 pm@Charles, in order to decode a QR code image (whether downloaded, stenciled or otherwise), you will need a “QR code reader”, such as an app on your smartphone. When you point the reader’s camera at the QR code, you’ll be able to see the “hidden” text which is embedded in the code.
Network Geek added these pithy words on Jul 25 11 at 4:12 pmWhat program do you all recommend to read them with on your phone? iPhone or Android, or both, if possible.
Thanks!
Jawnita added these pithy words on Jul 26 11 at 5:58 pmI love the high/low tech approach, and this project is funny and insightful.
That said, a peeve: is the transphobic “those aren’t women” one really necessary?
Jim Bowes added these pithy words on Jul 29 11 at 1:02 pmGuys,
Super cool. Can we make a donation. It took time and effort to develop this tool and we will use it so we would like to at lest buy you a round of beer!
Let me know Jim
GreenGraffiti®
golan added these pithy words on Aug 01 11 at 9:19 pm@Jawnita, that issue is now resolved. Thanks for your feedback.
Rolf van Gelder added these pithy words on Aug 02 11 at 7:45 pmHey Golan,
Cool idea!
You can use our zxing4processing lib to easily incorporate QR-tag creation in the Processing sketch.
Get a copy of the library here:
http://www.artisopensource.net/productslife/library.phpPeace,
Rolf
golan added these pithy words on Aug 04 11 at 11:45 amJust a quick update that the QR_STENCILER is now available:
– As a ZIP file from the F.A.T. Lab website (Version 1.1, 3 August 2011, 15MB), including compiled Mac/Win/Linux applications.
– As a Java applet on OpenProcessing.org. This is primarily for pedagogic purposes and quick reference, as the in-browser Java virtual machine does not permit the exporting of stencil PDFs.
– As a code repository on Github. Any future updates to this project will be found there
Bryan Croft added these pithy words on Aug 04 11 at 1:35 pmCool stuff – we did a video about it yesterday -
jb added these pithy words on Aug 09 11 at 4:51 amI’ve already hear about it but don’t know that still use, crazy
Golan Levin added these pithy words on Aug 17 11 at 12:49 amText from an interview. //-GL
> Who are you?
We are a collective of artists, who are concerned with giving people tools to engage with rapidly changing new forms of culture. See our “people” page for information about us as individuals.> Why did you creat this software?
The Stenciler software was created as a disruptor, in order to allow everyday people a new way to mark up (annotate) their environment. the QR hobo codes were created to demonstrate the software, and spark people’s imaginations about the possibilities.> Are the software and hobo QR signs widely used in the USA?
Hobo signs used to be very common in the united states, in the early 20th century, but are no longer very common. The QR hobo signs are only two weeks old so I don’t expect they have been widely adopted yet. They are presented as a conjectural or speculative provocation. A small handful of people are already using the stenciler software, such as the folks at GreenGraffiti.com.> Is this only for fun, or is it really to inform people?
We see no reason why it can’t be both simultaneously. Medicine goes down more easily with a spoonful of sugar.> Are you still creating new hobo signs?
No, we made 100 and that seemed like enough. Now other people can make their own signs with the tool we provided, as we have demonstrated.> And what about the true hobo: are they still creating hobo signs?
Handmade chalk signs are still in use by some migrant workers. See the wikipedia article on hobo signs.
It is wrong to assume that a homeless person does not own or need or know how to use a mobile phone, however. Indeed, for some homeless people, their mobile number is the nearest thing they have to a definite address. The nature of “hobo” is changing, thus hobo marks need to change as well. Check out the concept of “technomadism”: homeless people with mobile phones and even laptops. And check out the concept of “warchalking”: marks made to indicate technological features of the environment.
> Do you have any idea whether hobo signs are used in other countries?
The QR code hobo signs are a type of graffiti, which has a long history across many societies: http://en.wikipedia.org/wiki/Graffiti#Modern-style_graffiti
For example: (quote from above article):
The first known example of “modern style” graffiti survives in the ancient Greek city of Ephesus (in modern-day Turkey). Local guides say it is an advertisement for prostitution. Located near a mosaic and stone walkway, the graffiti shows a handprint that vaguely resembles a heart, along with a footprint and a number. This is believed to indicate that a brothel was nearby, with the handprint symbolizing payment.This is fundamentally similar to the use of hobo codes to mark up architecture.
Irezumkiss added these pithy words on Nov 06 11 at 11:56 pmHas the white man screwed you over or do you feel that the white man should pay for what his ancestors did
Do you believe that black men should own white woman then this is the perfect place for you.Come join us at
http://forum.literotica.com/forumdisplay.php?f=4Log in and say hi and tell us why you hate white people. Pm me as I go by the name Irezumkiss
Thankyou and enjoy
INCOMING LINKS
- Fred Trotter » Blog Archive » QR code stencil upmanship
- QR Code Stencil Generator and QR Hobo Codes. « pegpost.com.br
- QR Code Stencil Pattern Generator
- QR Code Hobo Signs
- Found on the Interwebs: QR Stencils of Hobo Codes « The Paltry Sapien
- QR Code Hobo Signs | Custom QR Codes Canada
- QR_STENCILER and QR_HOBO_CODES – Mediated Toynbee
- Stencil 2.0 « Kell egy penge
- No hobo: secret codes to help the 21st century vagabound | Brokelyn
- High Technology » Blog Archive » QR Stenciler
- New QR Codes From Golan Levin Emulate 'Hobo Symbols' Of The Past « CBS New York
- QR Hobo Codes Let You Leave Secret Messages for the Tech-Savvy | Computer and Electronics Forum
- QR Code Stencil Generator of the Day - TDW Geeks
- QR_STENCILER and QR_HOBO_CODES | QR-Code and its applications | Scoop.it
- Codurile QR lovesc din nou « cinearedreptate.eu
- Créer automatiquement ses pochoirs QR codes, c’est maintenant possible ! | Le Blog de CityQR, Actualités QR code et Marketing innovant.
- Fábio Caparica » Links entre 08.07.2011 e 20.07.2011
- 24 HOURS SURFING #4: Joop de Boer | rebel:art
- QR Codes used in Graffiti | Dispatch5.o Blog
- Guest Blog – Going Local
- Free Art and Technology Lab: “Hobo Codes” | rebel:art
- QR-Wegweiser für digitale Nomaden | hypes are us / hypesrus.com
- QR Code Stencil Generator – screenshine.net
- QR Hobo Codes « lavaguy
- Daily Links for August 2nd through August 3rd | Akkam's Razor
- QR Code Stencil Generator (Updates) | F.A.T.
- Weekly Linkfest « Games Alfresco
- Graffiti Stencil QR Codes | QR Code Matrix
- 100 QR-Codes para espaços públicos | Cultura Digital
- QR_STENCILER and QR_HOBO_CODES | QRdressCode | Scoop.it
- QR_STENCILER and QR_HOBO_CODES | QR codes for learning | Scoop.it
- QR_STENCILER and QR_HOBO_CODES | qrcodes et R.A. | Scoop.it
- Beaded QR code | fio makes things
- Covert QR Codes | desktop
- PaulBailey.Me » Hobo Symbols QR Codes
- john locke » Blog Archive » AR on the cheap
- QR code stencils for digital nomads « eye like – Contemporary Design Blog
- QR_STENCILER and QR_HOBO_CODES | Outils de visibilité | Scoop.it
- Weekly Linkfest | neutriNEWS
- QR Codes For The Road | Diary of a Network Geek
- links for 2011-07-20 | A Blue Star
- Códigos QR para llevar « Imagina Cuervo
- QR_STENCILER and QR_HOBO_CODES - Golan Levin - F.A.T. Lab | Art en Réseau | Scoop.it
- Publicis — Lead the Change
- QR_STENCILER and QR_HOBO_CODES | Creative Cookie | Scoop.it
- QR_STENCILER and QR_HOBO_CODES | QR code readers and generators | Scoop.it
- QR codes for nonprofit PR are a terrible idea : Eyler-Werve
- QR_STENCILER and QR_HOBO_CODES « QR Code Artist
- T-shirt | Anu's Blog








































































































