리눅스 데스크톱에서 QR 코드를 스캔하는 방법

CoBang은 웹캠이나 이미지 파일을 사용하여 Linux 데스크톱에서 QR 코드를 스캔할 수 있는 프로그램입니다. Flatpak을 이용해 Flathub에서 설치하고, 앱을 실행한 후 카메라 또는 이미지 모드를 선택하면 앱에서 디코딩된 결과를 확인할 수 있습니다. 웹캠을 사용할 수 없는 경우, 데스크톱의 카메라 권한 설정을 확인하거나 사용 중인 배포판에 포함된 패키지를 사용해 보세요.

Linux에 CoBang 설치하기

CoBang은 Linux 기반 QR 및 바코드 스캐너입니다. 관리자는 Ubuntu 패키지를 PPA를 통해, Arch Linux 패키지를 AUR을 통해, Fedora 패키지를 COPR을 통해, 그리고 Flatpak 패키지를 Flathub을 통해 제공합니다. 관리자는 Flathub 릴리스가 기존 배포판 패키지보다 지연될 수 있다고 언급합니다. 대부분의 사용자에게 Flatpak은 배포판 간 편리한 연결 수단입니다. 만약 사용하는 배포판의 패키지 관리자를 선호한다면, 해당 배포판에 맞는 관리자의 최신 설치 지침을 따르세요.

Flatpak을 사용하여 설치하세요

Flatpak이 이미 설치되어 있고 Flathub가 구성되어 있다면 터미널을 열고 다음 명령을 실행하세요.

flatpak install flathub vn.hoabinh.quan.CoBang

설치 프롬프트가 나타나면 확인하십시오. Flatpak에서 Flathub 원격 저장소를 찾을 수 없다는 오류가 발생하면 공식 저장소를 추가하고 다시 시도하십시오.

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

Flatpak 설정 방법은 배포판에 따라 다르므로, Flathub의 설정 지침을 참조하여 Ubuntu, Fedora, Arch, Linux Mint 또는 기타 지원되는 배포판에 Flatpak을 설치하고 Flathub를 활성화하십시오. 메시지가 표시되면 앱 및 런타임 세부 정보를 검토한 후 확인하십시오.

네이티브 배포판 패키지를 사용하세요

Ubuntu 및 파생 배포판은 관리자의 PPA를 사용할 수 있습니다. 프로젝트 설명에 따르면 CoBang 버전 1 이상은 Ubuntu 24.10 이상의 최신 배포판이 필요합니다. 관리자는 Arch Linux용 AUR 경로와 Fedora용 COPR 경로도 제공합니다. 패키지 가용성 및 명령어는 변경될 수 있으므로 저장소를 추가하거나 AUR 패키지를 빌드하기 전에 최신 CoBang 설치 안내를 참조하십시오 . 사용 중인 릴리스와 일치하지 않는 이전 패키지 명령어를 복사하지 마십시오.

웹캠으로 QR 코드를 스캔하세요

1. 카메라를 연결하거나 활성화하세요. 웹캠이 데스크톱 세션에서 정상적으로 작동하는지, 다른 앱에서 독점적으로 사용되고 있지 않은지 확인하십시오.
2. CoBang을 실행하세요. 응용 프로그램 메뉴에서 찾을 수 있습니다. 터미널에서 다음 명령어를 사용하여 Flatpak 빌드를 시작할 수도 있습니다 flatpak run vn.hoabinh.quan.CoBang.
3. 카메라 모드를 선택하세요. 앱에서 카메라 뷰가 자동으로 열리지 않으면 선택하세요. Linux에서 카메라 접근 권한을 요청하면, 해당 카메라로 스캔하려는 경우에만 CoBang에 대한 접근 권한을 허용하세요.
4. 코드를 화면에 담으세요. 인쇄된 코드를 미리 보기 화면에서 움직이지 않게 고정하고, 정사각형 전체가 보이도록 하며, 빛 반사나 심한 흐림 현상을 피하세요. 앱이 코드를 해독하는 데 잠시 시간이 걸릴 수 있습니다.
5. 결과를 확인하세요. CoBang은 결과 영역에 디코딩된 콘텐츠를 표시합니다. 링크를 열거나, Wi-Fi 네트워크에 연결하거나, 다른 콘텐츠를 복사하기 전에 결과를 읽어보세요. QR 코드에는 예상치 못한 URL이나 데이터가 포함될 수 있습니다.

이미지 파일로 저장된 QR 코드를 스캔하세요

1. CoBang을 실행하고 카메라 보기에서 이미지 또는 사진 모드로 전환하세요.
2. 이미지 열기 컨트롤을 선택한 다음 파일 선택기에서 저장된 QR 코드 이미지를 선택하십시오. CoBang의 인터페이스는 버전 및 데스크톱 환경에 따라 약간씩 다를 수 있습니다.
3. 디코딩이 완료될 때까지 기다린 후 앱에서 결과를 확인하세요. 이 프로젝트는 앱에서 지원하는 경우 로컬 또는 원격 이미지 소스를 포함한 정적 이미지에서 QR 코드 및 바코드 스캔을 지원합니다.

선명하고 잘리지 않은, 명암 대비가 좋은 이미지를 사용하세요. QR 코드가 스크린샷에 포함된 경우, QR 코드 사각형 전체가 손상되지 않는 한 관련 없는 부분만 잘라내세요. 왜곡되거나, 너무 작거나, 명암 대비가 낮거나, 일부가 가려진 코드는 해독되지 않을 수 있습니다.

CoBang이 웹캠에 접근할 수 없는 경우

Flatpak은 샌드박스 환경에서 앱을 실행합니다. CoBang 개발자에 따르면 샌드박스 환경에서 웹캠에 접근하는 경우 xdg-desktop-portal카메라 가시성은 데스크톱 환경의 포털 지원 여부에 따라 달라질 수 있습니다. 데스크톱의 개인 정보 보호 또는 카메라 설정을 확인하고, 다른 카메라 앱을 종료한 후 권한을 변경하고 CoBang을 다시 시작하십시오. 또한 카메라가 운영 체제에 인식되는지, 그리고 세션에서 포털 서비스가 정상적으로 작동하는지 확인하십시오.

카메라가 여전히 나타나지 않으면 프로젝트에서 설명하는 배포판 패키지 경로를 시도해 보세요. CoBang은 Flatpak 샌드박스 외부에서 실행될 때 V4L2 장치에 직접 접근하는 반면, Flatpak 빌드는 포털을 사용합니다. 이는 문제 해결에 유용한 차이점이지만, 패키지 형식을 변경한다고 모든 카메라 또는 드라이버 문제가 해결되는 것은 아닙니다.

카메라를 사용할 수 없을 때 빠른 대안으로 QR 코드 스크린샷 또는 사진을 사용하는 이미지 모드를 활용하세요. 프로젝트 공식 저장소 와 Flathub 목록에서 최신 프로젝트 및 패키지 정보를 확인할 수 있습니다.