소개
GOGDL은 Heroic Games Launcher 프로젝트에서 개발한 오픈소스 GOG 다운로드 모듈입니다. GOG 계정의 게임 목록을 가져오고 선택한 게임의 파일을 내려받을 수 있도록 CLI 형태의 인터페이스를 제공하며, 인증 토큰 관리 및 클라우드 세이브 관리, 게임 실행 지원 기능도 포함됩니다. GPL-3.0 라이선스로 공개되어 소스 코드를 자유롭게 확인하고 빌드할 수 있습니다.
상세정보
게임 다운로드 지원
GOG 계정의 게임 목록을 가져오고 사용자가 선택한 게임의 파일을 내려받을 수 있습니다. bin/gogdl 스크립트는 소스 코드를 편하게 실행하기 위한 Python 래퍼 역할을 합니다.
인증 토큰 관리
모듈 내부에서 GOG 인증을 처리하며, 더 이상 –token 매개변수를 직접 전달하지 않고 JSON 파일 경로를 지정해 토큰을 저장·재사용하는 방식을 사용합니다. Heroic Games Launcher는 $XDG_CONFIG_HOME/heroic/gog_store/auth.json 경로를 사용합니다.
클라우드 세이브 및 게임 실행 지원
다운로드뿐 아니라 클라우드 세이브 관리와 게임 실행을 위한 편의 기능도 모듈의 역할에 포함되어 있습니다. v1.2.2에서는 –debug 로그 출력이 보강되어 인증과 다운로드 흐름의 문제를 추적하기 쉬워졌습니다.
설치·시작·기본 사용
Windows에서는 winget install –id HeroicGamesLauncher.GOGDL –exact 명령으로 설치할 수 있습니다. Linux에서는 저장소를 클론해 pip install . 후 gogdl –help를 실행하거나, README 안내에 따라 zipapp 실행 파일을 빌드해 사용할 수 있습니다. 인증은 Heroic Games Launcher가 사용하는 $XDG_CONFIG_HOME/heroic/gog_store/auth.json 경로의 JSON 파일을 통해 처리됩니다.
버전·업데이트
v1.3.0에서는 .netrc 자격 증명이 GOG 인증에 주입되는 것을 방지하고, –debug 로그 출력을 강화하여 인증 및 다운로드 흐름 문제 추적을 개선했으며, 여러 CLI 충돌을 방지하고 오류 처리를 향상시켰습니다. 또한 리눅스에서 zipapp 형식으로 패키징하도록 CI를 업데이트했습니다. 자세한 변경 사항은 GitHub 릴리스 노트를 참조하십시오.
제한·라이선스·확인사항
본 모듈은 GPL-3.0 라이선스로 배포되며, LICENSE 파일은 GitHub 저장소에서 직접 확인할 수 있습니다. 이 모듈은 다른 애플리케이션에서 사용하기 위한 라이브러리로 설계되었으며, 사용자 친화적인 CLI를 제공하지는 않습니다. 문의 사항은 GitHub Issue 또는 Heroic Games Launcher의 Discord 서버를 통해 남길 수 있습니다.
시스템 요구사항
Python 3.x 및 requests 라이브러리가 필요합니다. Linux에서는 저장소를 클론해 pip install . 후 gogdl --help를 실행하거나, README 안내에 따라 zipapp 실행 파일을 빌드해 사용할 수 있습니다. Windows에서는 winget install --id HeroicGamesLauncher.GOGDL --exact 명령으로 설치할 수 있습니다.