Como ler códigos QR em um computador Linux

O CoBang permite que você escaneie um código QR em um desktop Linux usando uma webcam ou um arquivo de imagem. Instale-o a partir do Flathub com o Flatpak, abra o aplicativo, escolha o modo de câmera ou imagem e leia o resultado decodificado no próprio aplicativo. Se sua webcam não estiver disponível, verifique as permissões da câmera no seu sistema operacional ou tente usar o pacote fornecido para a sua distribuição.

Instalar CoBang no Linux

O CoBang é um leitor de QR Code e código de barras nativo para Linux. Seu mantenedor lista pacotes para Ubuntu através de um PPA, para Arch Linux através do AUR, para Fedora através do COPR e para Flatpak através do Flathub. O mantenedor observa que a versão do Flathub pode estar desatualizada em relação aos pacotes tradicionais das distribuições. Para a maioria dos usuários, o Flatpak é uma opção conveniente para diferentes distribuições; se você preferir o gerenciador de pacotes da sua distribuição, siga as instruções atuais do mantenedor para a sua versão específica.

Instale com o Flatpak

Se o Flatpak já estiver instalado e o Flathub configurado, abra um terminal e execute:

flatpak install flathub vn.hoabinh.quan.CoBang

Confirme a solicitação de instalação. Se o Flatpak informar que não consegue encontrar o repositório remoto do Flathub, adicione o repositório oficial e tente novamente.

flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
flatpak install flathub vn.hoabinh.quan.CoBang

A configuração do Flatpak varia de acordo com a distribuição, portanto, use as instruções de configuração do Flathub para instalar o Flatpak e habilitar o Flathub no Ubuntu, Fedora, Arch, Linux Mint ou outra distribuição compatível. Quando solicitado, revise os detalhes do aplicativo e do ambiente de execução antes de confirmar.

Use um pacote nativo da distribuição.

Ubuntu e derivados podem usar o PPA do mantenedor; o projeto observa que o CoBang versão 1 e posteriores requerem uma distribuição tão recente quanto o Ubuntu 24.10. O mantenedor também fornece um caminho AUR para Arch e um caminho COPR para Fedora. A disponibilidade de pacotes e comandos pode mudar, portanto, consulte as notas de instalação atuais do CoBang antes de adicionar um repositório ou criar um pacote AUR. Evite copiar um comando de pacote antigo se ele não corresponder à sua versão.

Escaneie um código QR com sua webcam.

1. Conecte ou ative uma câmera. Certifique-se de que a webcam funcione na sua sessão de desktop e não esteja sendo usada exclusivamente por outro aplicativo.
2. Inicie o CoBang. Encontre-o no menu de aplicativos. Você também pode iniciar a compilação do Flatpak a partir de um terminal com o comando ` flatpak run vn.hoabinh.quan.CoBang.
3. Selecione o modo de câmera. No aplicativo, escolha a visualização da câmera caso ela não tenha aberto automaticamente. Se o Linux solicitar acesso à câmera, permita apenas para o CoBang se desejar digitalizar com essa câmera.
4. Enquadre o código. Segure o código impresso firme na pré-visualização, mantenha o quadrado inteiro visível e evite reflexos ou desfoque excessivo. Aguarde alguns instantes para que o aplicativo o decodifice.
5. Analise o resultado. O CoBang exibe o conteúdo decodificado na área de resultados. Leia-o antes de abrir um link, conectar-se a uma rede Wi-Fi ou copiar outro conteúdo. Um código QR pode conter um URL ou dados inesperados.

Escaneie um código QR salvo como imagem.

1. Abra o CoBang e alterne da visualização da câmera para o modo de imagem ou fotografia.
2. Escolha o controle de abertura da imagem e, em seguida, selecione a imagem do código QR salva no seletor de arquivos. A interface do CoBang pode variar ligeiramente de acordo com a versão e o ambiente de desktop.
3. Aguarde a decodificação e, em seguida, verifique o resultado no aplicativo. O projeto oferece suporte à leitura de códigos QR e de barras a partir de imagens estáticas, incluindo fontes de imagem locais ou remotas, quando compatíveis com o aplicativo.

Use uma imagem nítida, sem cortes e com bom contraste. Se o código estiver incorporado em uma captura de tela, recorte o conteúdo irrelevante apenas se o quadrado do QR Code permanecer intacto. Um código distorcido, pequeno, com baixo contraste ou parcialmente coberto pode não ser decodificado.

Se CoBang não conseguir acessar a webcam

O Flatpak executa aplicativos em um ambiente isolado (sandbox). O mantenedor do CoBang afirma que o acesso à webcam em sandbox utiliza xdg-desktop-portal[alguma outra opção]; a visibilidade da câmera pode depender do suporte a portais no seu ambiente de desktop. Verifique as configurações de privacidade ou da câmera do seu desktop, feche outros aplicativos de câmera e reinicie o CoBang após alterar as permissões. Confirme também se a câmera está visível para o sistema operacional e se sua sessão possui um serviço de portal funcionando.

Se a câmera ainda não aparecer, tente o método de pacote da distribuição descrito pelo projeto. O CoBang acessa dispositivos V4L2 diretamente quando executado fora do ambiente isolado do Flatpak, enquanto a versão Flatpak utiliza o portal. Essa é uma diferença útil para solucionar problemas, mas não garante que a alteração do formato do pacote resolverá todos os problemas de câmera ou driver.

Para uma alternativa rápida quando uma câmera não estiver disponível, use o modo de imagem com uma captura de tela de um QR Code ou uma foto. O repositório oficial do projeto e a listagem no Flathub fornecem detalhes atualizados sobre o projeto e o pacote.