Home / Blog / Como criar Interfaces Gráficas (GUI) com Tkinter e Python

Como criar Interfaces Gráficas (GUI) com Tkinter e Python

Yuri Henrique • 20/01/2023
Atualizado em: 26/02/2023

Cansado(a) de quebrar a cabeça para aprender a programar Python de verdade?

Conheça a melhor e mais completa formação de Python e Django e sinta-se um programador verdadeiramente competente. Além de Python e Django, você também vai aprender Banco de Dados, SQL, HTML, CSS, Javascript, Bootstrap e muito mais!

Quero aprender Python e Django de Verdade! Quero aprender!

Tire suas dúvidas diretamente com o professor

Projetos práticos voltados para o mercado de trabalho

Formação moderna com foco na prática profissional

Salve salve Pythonista!

Hoje vamos abordar um tema bastante interessante: a criação de interfaces gráficas com Python e Tkinter.

Não só isso, mas vamos criar um executável que gera QR Codes!

O Tkinter é uma ferramenta comumente usada com interface gráfica para programas em Python.

Esta ferramenta é muito útil para a criação de interfaces das mais simples às mais complexas.

E de bônus, você ainda vai aprender a empacotar sua interface em um executável para Windows!

Sem enrolação, vamos ao conteúdo!

Vá Direto ao Assunto…

Instalação das dependências
Desenvolvimento do Código
Resultado
BÔNUS: Criando um executável para Windows

Instalação das dependências

O primeiro passo (sei que vocês já estão antenados, mas não custa lembrar) é instalar as dependências do projeto.

O Tkinter faz parte da biblioteca padrão do Python, portanto não precisamos instalá-lo via pip.

As outras dependências são: qrcode (para fazer a geração do QR Code) e a biblioteca de manipulação de imagens pillow.

Antes de fazer a instalação, crie e ative um ambiente virtual para não bagunçar as bibliotecas em seu computador.

Se ainda não sabe como criar um ambiente virtual, clique aqui e aprenda a criar ambientes virtuais utilizando o Virtualenv!

Com o ambiente virtual criado e ativado, instale as dependências com o seguinte comando pip:


1

pip install qrcode pillow

Desenvolvimento do Código

Agora, abra sua IDE ou editor de código e crie um arquivo chamado main.py.

Vamos começar o código importando todos os módulos necessários, que já foram instalados via pip:


1
2
3
4

from tkinter import *
import qrcode
from PIL import Image, ImageDraw
from tkinter import messagebox

Agora vamos escrever a função que vai salvar o Código QR em uma imagem (caso contrário o Código QR será gerado, mas sem ser salvo no HD):


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

def gera_qr_code():
  url = website_entry.get()

  if len(url) == 0:
    messagebox.showinfo(
      title="Erro!",
      message="Favor insira uma URL válida")
  else:
    opcao_escolhida = messagebox.askokcancel(
      title=url,
      message=f"O endereço URL é: \n "
              f"Endereço: {url} \n "
              f"Pronto para salvar?")

    if opcao_escolhida:
      qr = qrcode.QRCode(version=1, box_size=10, border=5)
      qr.add_data(url)
      qr.make(fit=True)
      img = qr.make_image(fill_color='black', back_color='white')
      img.save('qrExport.png')

A lógica dessa função é a seguinte:

Primeiramente o código checa se o input do usuário (website_entry) tem ao menos um caracter para continuar.
Se o input contiver dados, o programa vai mandar uma mensagem ao usuário confirmando o input e pede confirmação se é para salvar ou não.

Confirmado que é para salvar, o programa vai continuar gerando um Código QR com tamanhos específicos (você pode fazer outros tamanhos ou até mesmo diversas opções), e em seguida irá salvar a imagem do QR code no seu HD (na mesma pasta do script main.py).

O nome do arquivo será qrExport.png.

Agora que temos a lógica pronta para a entrada de input e a geração de Códigos QR, só falta criarmos uma interface de usuário e está tudo pronto!


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

window = Tk()
window.title("Gerador de Código QR")
window.config(padx=10, pady=100)

# Labels
website_label = Label(text="URL:")
website_label.grid(row=2, column=0)

# Entries
website_entry = Entry(width=35)
website_entry.grid(row=2, column=1, columnspan=2)
website_entry.focus()
add_button = Button(text="Gerar QR Code", width=36, command=gera_qr_code)
add_button.grid(row=4, column=1, columnspan=2)

window.mainloop()

Aqui nós criamos um programa com o título “Gerador de Código QR” e colocamos espaçamentos.

Em seguida, adicionamos o título e a janela de input (Classe Entry).

Note que a lógica aqui é a formatação em grade, onde temos fileiras e colunas.

Então o título do input e o campo do input vão estar na mesma fileira (row=2).

E decidimos alinhar o botão na mesma coluna que o input (column=1).

Peraí… Está curtindo esse conteúdo?

Que tal receber 30 dias de conteúdo direto na sua Caixa de Entrada?

Sua assinatura não pôde ser validada.

Você fez sua assinatura com sucesso.

Assine as PyDicas e receba 30 dias do melhor conteúdo Python na sua Caixa de Entrada: direto e sem enrolação!

Seu nome

Seu e-mail

Portanto, o código completo é o seguinte:


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

import qrcode
from tkinter import messagebox, Tk, Label, Entry, Button


def gera_qr_code():
    url = website_entry.get()

    if len(url) == 0:
        messagebox.showinfo(
            title="Erro!",
            message="Favor insira uma URL válida")
    else:
        opcao_escolhida = messagebox.askokcancel(
            title=url,
            message=f"O endereço URL é: \n "
                    f"Endereço: {url} \n "
                    f"Pronto para salvar?")

        if opcao_escolhida:
            qr = qrcode.QRCode(version=1, box_size=10, border=5)
            qr.add_data(url)
            qr.make(fit=True)
            img = qr.make_image(fill_color='black', back_color='white')
            img.save('qrExport.png')


if __name__ == '__main__':
    window = Tk()
    window.title("Gerador de Código QR")
    window.config(padx=10, pady=100)

    # Labels
    website_label = Label(text="URL:")
    website_label.grid(row=2, column=0)

    # Entries
    website_entry = Entry(width=35)
    website_entry.grid(row=2, column=1, columnspan=2)
    website_entry.focus()
    add_button = Button(text="Gerar QR Code", width=36, command=gera_qr_code)
    add_button.grid(row=4, column=1, columnspan=2)

    window.mainloop()

Resultado

Após colocar o código em execução, deverá aparecer a seguinte tela:

Adicionando uma URL e clicando em “Gerar QR Code”, a seguinte tela de confirmação deverá aparecer:

Ao clicar em “Ok”, o arquivo qrExport.png será criado na mesma pasta onde o script main.py foi executado e terá o seguinte conteúdo:

Agora basta apontar a câmera do seu celular pra ele e…

Voilá! Você fez sua primeira interface gráfica com tkinter!

E aí, tá curtindo? Que tal aprender Python e Django DE VERDADE em um curso prático, voltado pro mercado?!

BÔNUS: Criando um executável para Windows

Agora que nosso programa está funcionando corretamente, vamos transformá-lo em um executável do Windows (.exe).

Para isto, nós vamos usar uma ferramenta chamada auto-py-to-exe.

Primeiro, instale-a com o comando pip install auto-py-to-exe.

Após instalada, vamos rodar o seguinte comando no terminal:


1

python -m auto_py_to_exe

Se tudo funcionar direitinho você verá a interface a seguir:

Nesta interface, você pode explorar diferentes possibilidades e configurações de arquivos a serem gerados, mas no nosso caso, nós optamos por copiar o endereço (“path”) do nosso arquivo main.py no campo Script Location e selecionamos os botões: One Directory, Windows Based e selecionamos todas as opções como visto na imagem acima.

Em seguida, simplesmente clicamos em Convert .PY to .EXE e pronto!