QR Code and 2D Code Generator

This page is an online two dimensional code generator which is written in PHP. It can generate QR Code, Data Matrix, Aztec Code and Micro QR Code for the time being. Because QR Code is much more popular than the other code formats, it is separately named in the page title. If you need more information on two dimensional bar code systems, I suggest that you take a look at Roger Smolski’s comprehensive blog on QR Code and two dimensional bar codes.

Using the form on this page, you can create two dimensional code images that trigger various actions on the reader device. You can use this form on both your desktop browser or your new generation mobile device (like iPhone). You can find the explanations under the form. If you like this page and you have ideas to implement, please give feedback, so that I can improve the page. So far, this page created 49462 codes since I started counting in January, 2010. Seems like especially QR Codes are getting more and more popular outside the far east.

Please be sure to read the Notes section below, if you encounter any problems with code generation (Especially for Micro QR Codes!).

If this generator has somehow been useful to your commercial business, perhaps you would consider contributing by clicking the PayPal button below.

Notes:

The generator tweets (does not tweet your input!) as @qrcodegen on Twitter with every new generated 50th 2D code. Also, you can follow me on Twitter through @kerem_erkan. If you liked this generator, I would really appreciate it if you could recommend it on Facebook by clicking the “Recommend” button on top of the page, or tweet about it by clicking this link.

Data Matrix and Aztec Code have significantly lower capacity (4096 alphanumeric characters for QR Code, 3067 for Aztec Code and 2335 for Data Matrix), so if you would like to encode a lot of text, select QR Code. Be aware that, although you give an input consisting of only alphanumeric characters (i.e. lowercase and uppercase ASCII characters and numeric digits only), the maximum capacity strongly changes with the density of letters vs digits. So it is impossible to guarantee that your input will successfully be encoded before trying to encode it. If it cannot be encoded, the generator will give a warning. In that case, lower the character count in your input and try again.

To create the best readable code for long URLs, use one of the URL shortening services so that the resulting code is as small as possible. I personally prefer bit.ly over TinyURL.

Micro QR Code cannot hold more than 35 numeric and 21 alphanumeric characters, and it can hold even less characters when you add non-alphanumeric characters like “/” to your input. So it can only be used for very small URLs or text input (It cannot even hold a bit.ly URL when you prefix it with “http://”). But it is more efficient than QR Code when you use it with very small inputs.

If your device cannot interpret the encoded 2D Code properly, it probably means your reader program is written poorly or does not have the capability of decoding that particular code format; or your device does not accept that action, because all codes created by this script and the content within them are compliant to all necessary published standards (vCard standards, URL encoding schemes, NTT DoCoMo standards, etc.).

While we are talking on standards, let me open the topic up a little bit more. Sadly most readers out there do not follow special character escaping standards. Characters like “:” or “;” are special characters in vCard, meCard or vEvent specifications, and they should be properly escaped for the input to be interpreted correctly. This generator follows these standards correctly, and so a URL field like “http://example.com” becomes “http\://example.com” after escaping. The problem is, readers like QuickMark do not know how to handle this escaped character and break altogether. If you encounter such problem, select No for Escape Special Characters in vCard, meCard or vEvent creation. But while you will be able to read those QR Codes in broken readers, be aware that, your 2D Code will not be standards compliant and you may not be able to add a URL that includes a second colon (for example as a port number separator) or semicolon when you do that.

Aztec Code may not support UTF-8 characters for the time being, so if you encounter such a problem try QR Code or Data Matrix. Another caveat of Aztec Code is that, it is not supported by most of the reader programs out there. As for Kanji and Cyrillic characters, only QR Code should support them, but I don’t have feedback for those yet (Can anyone who can read Kanji or Cyrillic characters confirm that?).

Always use dark colors for foreground color and light colors for background color. If there is not enough contrast between foreground and background colors, your device will most probably fail to decode the code.

A note on vCard coordinates: Neither vCard 2.1 nor vCard 3.0 specification does accept parameters for coordinates like “Home Address Coordinates” or “Work Address Coordinates”, etc. So the coordinates represent the vCard itself, not any of the addresses you provide in the vCard. In vCard 4.0 spec, you will probably be able to bind geographical coordinates to your addresses.

Currently you can do the following with this form:

• You can browse to a website.
• You can bookmark a website.
• You can make a phone call.
• You can send a short message.
• You can send an e-mail.
• You can create a vCard (v2.1 or v3.0) with coordinates to add a contact to your device.
• You can create a meCard to add a contact to your device.
• You can create a vCalendar event to add to your calendar.
• You can open location coordinates in Google Maps on your device (works on iPhone and Android).
• You can create market:// URLs for searching for publishers or packages on Market app for Android.
• You can create special youtube:// URLs for YouTube app on iPhone.
• You can fetch and encode the latest tweet of a Twitter user.
• You can create a mobile URL to tweet on Twitter.
• You can create a mobile URL to update your Facebook status (UPDATE: Does not work for the time being. I am searching for a workaround.).
• You can read plain or free formatted text on your device.

You can change the block size of the generated image to make it bigger or smaller. Also, you can change the margin size of the image to add more quiet zone if your decoder cannot decode it (Especially Data Matrix seems to need bigger margin sizes). Error correction level for QR Code (ignored for other code types) can be set to 4 different values and higher values may cause the image to be decoded slightly slower. The 4 values can be explained like this:

• Low (L): Up to 7% of errors can be corrected.
• Medium-Low (M): Up to 15% of errors can be corrected.
• Medium-High (Q): Up to 25% of errors can be corrected.
• High (H): Up to 30% of errors can be corrected.

You can choose PNG, PDF, SVG or EPS outputs. SVG will output a vector image XML file, and you can edit it in applications like Adobe Illustrator or Inkscape.

Please be aware that while I make checks for illegal characters to protect my server, I do not check your input for a meaningful value. For example, if you enter letters for phone number in “Make a Phone Call” action, and your device initiates a nuclear launch sequence in a forgotten former U.S.S.R. rocket silo, it will be your problem, not mine.

The image generation is done using third party encoders. I have only written a handy PHP front end that formats your input and passes it to these encoders.

You will need some 2D code decoder software on your mobile device to be able to read these codes. If a decoder is not preinstalled, you may find one, suitable for your device from Kaywa or QuickMark. I haven’t been able to find a good decoder supporting all formats and all actions on iPhone yet.