Manual Técnico

QR Code Customizado
Este manual visa explicar de forma simples o processo para criar QR Codes customizados, sejam eles
comuns ou artisticos, para leigos.

O que é um QR code afinal?

Um QR code é, grosseiramente falando, uma forma de transformar um texto em chuvisco de TV, para
que depois uma câmera transforme o chuvisco em texto denovo. Esse texto pode ser uma mensagem,
um site, uma chave PIX, a senha de uma rede WIFI, etc. Neste manual, além de criar chuviscos de TV,
abordaremos uma ferramenta que nos permite gravar este chuvisco em uma imagem mais
interessante.

O que você vai precisar?

1. Um computador (Windowns 10 ou mais recente, Linux ou Mac)
2. Python 3
3. amzqr
4. Algum texto.
5. Opcional - Uma imagem quadrada.

Instalando o Python 3
Se você tem um Linux ou um macbook, pode pular esta parte pois o Python 3 é nativo nesses
sistemas.

O Python é uma das linguagens de programação mais difundidas hoje em dia, mesmo assim não
possue intragração nativa com o sistema Windows. Ela pode ser usada pra criar e ler programas
escritas em Python e é uma excelente porta de entrada para aprender a programar. Ela também é um
requisito para usar o amazing-qr, o programa que de fato usaremos para criar o qr code.

A forma mais simples de instalar o Python 3 no Windows é pela Windows Store:

1. Abra o menu Inicial do Windows (o botão com o simbolo do Windows no teclado).

2. Procure por e clique em "Microsoft Store".
3. Procure "Python 3" na Microsoft Store. Prefira a versão mais recente que encontrar.
4. Clique em "Instalar".

Aguarde a conclusão da instalação. Isto deve ser o suficente para ter o Python 3 intalado, junto com o
PIP e o IDLE, que servem para instalar programas feitos no Python e para programar seus próprios
programas, respectivamente.
Intalando o amzqr
O amzqr (https://github.com/x-hw/amazing-qr) é o programa que de fato usaremos para criar os qr
codes. Ele pode ser um pouco diferente do que você espera, pois é um programa com interface de
linha de comando, isto é, não tem nenhuma janela ou botões para clicar. Ao invés disso, você escreve
instruções de como o programa deve funcionar na linha de comando. Se você sabe o que é DOS, sabe
o que isto significa. Por hora, vamos apenas instalá-lo:

Windows

1. Pressione Win+R no teclado (Win é a tecla com a bandeira do Windows).

2. Na janela aberta, digite cmd e aperte Enter no teclado. Se uma tela preta apareceu, está dando
tudo certo, esta é a linha de comando.
3. Na linha de comando, digite pip install amzqr e aperte Enter. Aguarde até que o processo
conclua.

Mac

1. Abra o Spotlight apertando Comando+Barra de espaço.

2. No Spotlight, digite "terminal" e aperte Enter.
3. No Terminal, digite pip install amzqr e aperte Enter. Aguarde até que o processo conclua.

Linux

1. Se você usa um Linux, deveria saber como se faz isso.

2. Abra o terminal. Cada sabor de Linux tem seu modo de fazê-lo, geralmente com Super+T ou
procurando no menu equivalente ao inical do Windows.
3. No Terminal, digite pip install amzqr e aperte Enter. Aguarde até que o processo conclua.

Utilizando a linha de comando

Se é a sua primeira vez usando a linha de comando, aqui vai umas dicas:

Windows

1. Use o comando cd nomaDaPasta para entrar numa subpasta.

2. Use o comando cd %HOME%/Desktop para sempre retornar à Área de Trabalho.
3. Use o comando dir para listar os arquivos e pastas dentro da pasta em que você está.
4. Use o comando cd .. para voltar à pasta superior.
Por exemplo, se está em "C:\Users\seuNome" e usar cd .. verá que mudará para "C:\Users\".

Mac & Linux

1. Use o comando cd nomaDaPasta para entrar numa subpasta.

2. Use o comando cd $HOME/Desktop para sempre retornar à Área de Trabalho.
3. Use o comando ls para listar os arquivos e pastas dentro da pasta em que você está.
4. Use o comando cd .. para voltar à pasta superior.
Por exemplo, se está em "~/Música/Summer Eletrohits Vol.5 2008/" e usar cd .. verá que
mudará para "~/Música/".

Utilizando o amzqr
Independentemente do sistema que usar, o amzqr funciona da mesma forma. Para os exemplos à
seguir, usaremos como exemplo a seguinte chave PIX:

01234578901234BR.GOV.BCB.PIX012345678901-0123-0123-0123-0123
456789012345678901234567890BR0123Teste Teste Teste Teste0123SAO
PAULO01234567890123456789Bxz0p6Q7HOGMUXB5l2mu6304EF60

Como ela é muito extensa, será representada como $PIX nos comandos abaixo. Atenção à aspas. O
novo QR Code será criado na pasta em que você executar o comando.

Para criar um QR Code simples, use o comando amzqr "$PIX" .

Para criar QR Codes com imagens, use o comando amzqr "$PIX" -p "arquivoDaImage.jpg" .
Ou amzqr "$PIX" -c -p "arquivoDaImage.jpg" para uma versão colorida.

Pode ser um pouco díficil ler estes exemplos pois a redução da imagem pode borrar o QR Code.