Lars Muldjord의 Skyscraper
Linux 시스템 (MacOS 및 Windows도 공식적으로 지원되지는 않지만 공식적으로 지원되지 않음)에서 사용하기 위해 C ++로 작성된 강력하고 다재다능하지만 사용하기 쉬운 게임 스크레이퍼. 스크린 샷, 표지 및 비디오와 같은 미디어를 포함하여 다양한 스크래핑 소스의 다양한 게임 리소스를 긁어 모으고 캐시합니다. 그런 다음 캐시 된 모든 자원을 결합하여 선택한 프론트 엔드의 게임 목록과 아트 워크를 생성 할 수있는 옵션을 제공합니다.
모든 마천루 기능은 잘 문서화되어 있으며 문서를 읽은 후에도 여전히 궁금한 점이있는 경우 FAQ도 있습니다. Retropie Subreddit 또는 공식 Retropie Forums에서 물어보십시오. GitHub의 Issues
페이지는 버그 보고서 및 기능 요청에만 해당됩니다. 감사해요!
지원되는 플랫폼 ( '-p'로 설정) :
여기에서 플랫폼의 전체 목록을 확인하십시오.
지원되는 스크래핑 모듈 ( '-s'로 설정)
Skyscraper는 Scraping Modules 라는 다양한 스크래핑 소스를 지원합니다. 이를 사용하여 게임 데이터를 Skyscraper Resource 캐시에 수집하십시오. 여기에서 스크래핑 모듈의 전체 목록을 확인하고 자원 캐시에 대한 자세한 내용을 여기에서 읽으십시오.
지원되는 프론트 엔드 ( '-f'로 설정) :
코드 기여 및 포크
다른 프로젝트에 중점을두고 있기 때문에 풀 요청은 현재 허용되지 않습니다. 내가 여기에서 구현 한 것 이상으로 현재 기능 세트를 확장하려는 더 많은 커뮤니티 드라이브 포크를 찾고 있다면이 포크를 확인해야합니다.
Skyscraper를 설치하는 방법
최신 버전의 Skyscraper를 설치하려면 아래 단계를 따라하십시오. $
로 시작하는 줄은 설치하려는 컴퓨터의 터미널에서 실행 해야하는 명령을 나타냅니다.
메모! Retropie 분포를 사용하는 경우 Retropie-Setup 스크립트에서 Skyscraper를 직접 설치할 수있는 옵션이 있습니다 ( 설치하기 전에 스크립트를 업데이트해야합니다! ). 이 모든 것에 대해 자세히 알아보십시오. 그렇지 않다면 읽으십시오.
전제 조건을 설치하십시오
리눅스
초고층 빌딩은 컴파일을 위해 QT5.3 이상이 필요합니다. Retropie, Ubuntu 또는 기타 데비안 파생 배포판의 경우 다음 명령을 사용하여 QT5를 설치할 수 있습니다.
$ sudo apt update
$ sudo apt install build-essential qt5-default
Sudo 비밀번호를 요청받을 수 있습니다. Retropie에서 기본 비밀번호는 raspberry
입니다. 다른 Linux 배포판에 QT5를 설치하려면 문서를 참조하십시오.
메모! 우분투 21.04에서 qt5-default
Metapackage가 더 이상 존재하지 않습니다. 대신 위 명령과 동일하게 설치하는 sudo apt install build-essential qtbase5-dev qt5-qmake qtbase5-dev-tools
수행해야합니다.
마코스
Skyscraper는 MacOS에서도 완벽하게 작동하지만 Mac을 소유하지 않으므로 공식적으로 지원되지 않습니다. 그러나 Horaceandthepider와 Abritinthebay의 도움으로 다음은 QT5 및 기타 전제 조건을 설치하는 데 필요한 명령입니다.
$ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
$ brew install gnu-tar --with-default-names
$ brew install wget
$ brew install qt5
$ brew link qt5 --force
그것이 잘 진행되면 아래 기본 설치 지침으로 진행하십시오. 작동하고 마천루를 설치해야합니다.
참고 1! 사용자 'Davidmgrantham'은 위의 --with-default-names
일부 MACOS 설치에 대해 더 이상 사용되지 않을 수 있다고보고합니다. 제거하면 update_skyscraper.sh
를 다운로드하고 실행하기 전에 tar
명령을 gtar
로 편집해야합니다.
참고 2! 사용자 'TRVRPLK'는 MACOS 11.2+에서 수많은 문제를보고합니다. 잠재적 인 수정 사항을 여기에서 확인하십시오.
다운로드, 컴파일 및 설치
위에서 설명한대로 전제 조건을 설치하면 다음 명령을 입력하여 Skyscraper를 설치할 수 있습니다.
$ cd
$ mkdir skysource
$ cd skysource
$ wget -q -O - https://raw.githubusercontent.com/muldjord/skyscraper/master/update_skyscraper.sh | bash
마지막 명령은 GitHub에서 최신 업데이트 스크립트를 다운로드하여 실행합니다. 설치 중에 Sudo 비밀번호를 요청받을 수 있습니다. Retropie에서 기본 비밀번호는 raspberry
입니다.
스크립트가 완료되면 Skyscraper를 실행할 준비가되었습니다!
마천루 업데이트
Skyscraper 2.3.2 및 Newer에서 다음 명령을 실행하여 최신 버전으로 업데이트 할 수 있습니다.
$ cd
$ cd skysource
$ ./update_skyscraper.sh
업데이트 중에 Sudo 암호를 요청받을 수 있습니다. Retropie에서 기본 비밀번호는 raspberry
입니다. 버전이 2.3.2보다 오래된 경우 ( --help
로 확인) 대신 설치 지침을 따라야합니다.
마천루를 제거하는 방법
이 readme의 지침을 사용하여 Skyscraper를 설치 한 경우 다음 명령을 사용하여 제거 할 수 있습니다.
$ cd
$ cd skysource
$ sudo make uninstall
$ cd
$ rm -Rf skysource
$ rm -Rf .skyscraper
프로세스 중에 Sudo 비밀번호를 요청받을 수 있습니다. Retropie에서 기본 비밀번호는 raspberry
입니다.
창
현재 Windows는 공식적으로 지원되지 않습니다! 그러나 나는 반준적으로 컴파일하고 지원되지 않는 Windows 64 비트 버전을 릴리스하고 잘 작동합니다. 다운로드 된 파일에서 포함 된 readme를 읽으십시오. 그리고 분명히 :이 버전을 사용한다면 당신은 혼자 있습니다 - 그것에 대해 질문하지 마십시오. 여기에서 Windows 버전을 얻으십시오.
Skyscraper를 사용하는 방법
중요한!!! Skyscraper가 제대로 작동하려면 실행하기 전에 프론트 엔드를 종료해야합니다! EmulationStation을 실행중인 경우 F4를 누르면 종료 할 수 있습니다.
아트 워크 Skyscraper Secports를 완전히 사용자 정의 할 수 있습니다. 여기에서 문서를 확인하십시오. 기본 (예쁜 멋진) 아트 워크 Skyscraper를 사용하려면 계속 읽으십시오.
간단한 사용 사례
처음 사용자의 경우 짧은 및 지점 사용 사례를 읽는 것이 좋습니다. 그것을 읽고 당신이 그것의 요점을 얻었을 때 여기로 돌아가십시오.
마천루의 빠른 런 다운
Skyscraper는 명령 줄 도구이며, 많은 옵션이 있습니다. 나는 그들 모두를 살펴보면 가능성에 익숙해지는 것이 좋습니다.
$ Skyscraper --help
$ Skyscraper --flags help
$ Skyscraper --cache help
이것은 당신이 모험을 느끼면 마천루를 할 수있는 모든 것에 대한 설명을 제공합니다! 사용 가능한 모든 옵션에 대한 철저한 설명은 여기를 확인하십시오.
가장 중요한 것은 아마도 다음과 같습니다.
-
-p <PLATFORM>
-
-s <SCRAPING MODULE>
-
-u <USER:PASS>
또는 -u <KEY>
-
--cache refresh
-
--flags videos
비 디폴트 위치에 ROM이있는 경우 (Retropie 사용자의 기본값은 /home/<USER>/RetroPie/roms/<PLATFORM>
) 게임 목록 또는 아트 워크를 비 디펜트 위치로 내보내려면 이것들이 필요합니다 :
-
-i <PATH>
-
-g <PATH>
-
-o <PATH>
거의 모든 명령 줄 옵션의 경우 여기에 설명 된대로 /home/USER/.skyscraper/config.ini
파일에서 설정하십시오. 이렇게하면 옵션이 영구적으로 만들어 지므로 항상 입력 할 필요가 없습니다.
ROM의 하위 집합에 대한 데이터 수집
Skyscraper는 ROM의 하위 집합에 대한 데이터를 수집하는 몇 가지 방법을 제공합니다. 캐시에 데이터가없는 ROM을 긁어 내고 싶다면 --onlymissing
명령 줄 옵션으로 수행 할 수 있습니다. --startat FILENAME
및 --endat FILENAME
옵션을 확인할 수도 있습니다. 두 개의 ROM에 대한 데이터를 수집하려면 명령 줄 끝에 파일 이름을 추가 할 수 있습니다 (예 : Skyscraper -p amiga -s openretro "/path/to/rom name 1.lha" "/path/to/rom name 2.lha"
). 아마도 ROM의 서브 세트에 대한 데이터를 수집하는 가장 진보 된 (그리고 매우 편리한) 방법은 --cache report:missing=RESOURCE
옵션. 이는 특정 리소스가 누락 된 파일 이름이 포함 된 보고서를 생성 할 수 있습니다. 그런 다음 나중에 --fromfile REPORTFILE
사용하여 보고서를 Skyscraper로 다시 공급할 수 있습니다. Skyscraper는 보고서에 포함 된 파일 만 긁어냅니다.
config.ini
Skyscraper의 덜 알려져 있지만 매우 유용한 기능은 원하는 구성 변수를 /home/USER/.skyscraper/config.ini
에 추가하는 것입니다. 이 파일에 설정된 모든 옵션은 기본적으로 Skyscraper가 사용합니다. 예를 들어, 명령 줄에서 -i <SOME FOLDER>
항상 사용하는 경우 구성에서 일치하는 옵션 inputFolder="<SOME FOLDER>"
설정할 수 있습니다.
모든 availabe 구성 옵션에 대한 자세한 설명을 보려면 여기를 확인하십시오.
리소스 캐시
Skyscraper의 가장 강력한 기능 중 하나는 리소스 캐시입니다. Skyscraper를 최대한 활용하기 위해 이것이 어떻게 작동하는지 이해하는 것이 중요합니다. 그것에 대해 자세히 알아보십시오.
사용자 정의 데이터
Skyscraper를 사용하면 로컬 캐시 리소스에서 스크래핑을 허용하는 것과 함께 -s import
스크래핑 모듈을 사용하여 자체 데이터를 리소스 캐시로 가져올 수 있습니다. 캐시에서 기존 리소스를 편집하거나 --cache edit
명령으로 개별 user
리소스를 추가 할 수도 있습니다. 마지막으로, 필요한 경우 기존 EmulationStation 게임 목록 데이터를 Skyscraper Resource Cache로 가져올 수있는 옵션도 있습니다. -s esgamelist
스크래핑 모듈 로이 작업을 수행 할 수 있습니다.
위에서 설명한 기능에 대한 자세한 내용은 여기에서 모든 문서를 확인하십시오.
아트 워크 모양과 효과
여기에서 전체 아트 워크 문서를 확인하십시오
릴리스 노트
버전 XXX (고려중인 기능, 모든 구현되지 않은 기능)
- 특정 스크래핑 모듈에서 온 순수한 캐시 데이터에서 긁는 옵션 추가
- 검색어 기반 이름 대신 별명을 전역베이스 이름으로 표시하는 것을 고려하십시오. 이렇게하면 나중에 무시되는 별칭 이름의 누락 된 괄호가 고정됩니다.
- 모든 아트 워크 유형을 사용자 정의 의미로 사용하여 자신의 유형이 사용자가 원하는대로 될 수 있습니다. 소스는 '스크린 샷'및 '커버'와 같은 알려진 유형의 소스를 생성하지만 사용자는 '캐비닛'또는 다른 것과 같은 다른 유형을 가져올 수 있습니다. 그런 다음 GameEntry에서 4 개의 하드 코드 유형 대신 아트 워크 목록으로 내부 아트 워크를 처리합니다.
- Artwork.xml에서 'file = "somefolder/.png"'에서 사용할 수있는 기능을 소개하여 Game Basename.png와 함께 'Resources'에서 파일을 찾아 사용자 지정 아트 워크 데이터를 해결 방법으로 사용할 수 있습니다. 가져 오기에 새로운 유형을 추가하는 데 (이 제안에 대해 'Jueank'에게 감사합니다)
- 이미 기존 플랫폼에 별명으로 구성에서 구성하여 사용자 정의 플랫폼을 긁어내는 옵션을 추가하십시오. 예 : Scrape 'pcenginecd'는 PCENGINE 폴더 대신 'ROMS/PCENGINECD'폴더에 해당 파일이있는 경우 'PCENGINE'로 스크랩 할 수 있습니다. 여기에서 확인하십시오 : #136
- 아트 워크 XML에서 모든 것이 바로 설정되었는지 확인하기 위해 예제를 신속하게 렌더링 할 수있는 아트 워크 컴포 터에 대한 테스트 모드를 만듭니다.
- 'Region'이 'RegionPrios'와 유사한 목록이되도록하십시오. '지역'을 사용하면 기본 우선 순위 목록을 유지하고 '지역'에서 상단에 추가해야합니다. 'RegionPrios'는 여전히 전적으로 덮어 써야합니다. 이름 지정 변경은 아마도 '영역'을 '영역 준비'또는 무언가로 바꾸는 것과 같은 좋은 아이디어 일 것입니다. 'RegionPrios'는 아마도 '지역 오버 라이드'로 변경되어야합니다. (이것을 제안 해 주신 'Corezon'에게 감사합니다).
- 닫기 일치 파일 이름을 허용하기 위해 '가져 오기'모듈에 대한 덜 강성 파일 이름 일치를 구현하십시오.
- 멀티 디스크 게임 그룹화에 대한 지원을 추가하여 Gamelists에 하나의 항목 만 갖습니다. 문제/232를 참조하십시오 (이 제안에 대해 'INGO2K'에 감사드립니다)
버전 3.7.7 (2022 년 6 월 28 일)
- 'segacd'플랫폼에 '*.m3u'가 추가되었습니다 (제안해 주신 사용자에게 감사합니다)
버전 3.7.6 (2022 년 6 월 12 일)
- 'pico8'플랫폼이 추가되었습니다 (제안해 주신 '제로 제이'에 감사합니다)
버전 3.7.5 (2022 년 1 월 31 일)
버전 3.7.4 (2022 년 1 월 23 일)
- '-includefrom'및 '--excludefrom'은 이제 상대 경로와 함께 작동합니다 (이것을보고하려면 'sleve_mcdichael'을 사용해 주셔서 감사합니다.
- 건너 뛰는 파일 항목은 이제 'excludefrom'및 '-includefrom'을 사용하여 보고서 파일과 동일한 형식으로 부여합니다 (이를 제안 해 주신 'Tomfury'에 감사합니다).
버전 3.7.3 (2022 년 1 월 23 일)
- '스위치'플랫폼 추가 (정보 제공에 대한 'Redemp'에 감사합니다)
버전 3.7.2 (2022 년 1 월 20 일)
- Skyscraper는 이제 새 데이터를 긁을 때 '.skyscraperignore [tree] 파일을 사용할 때만 파일 만 무시합니다. 게임 목록을 생성 할 때 무시되지 않습니다
버전 3.7.1 (2022 년 1 월 19 일)
- Skyscraper는 이제 '.skyscraperignoretree'라는 파일이 발견되는 서브 폴더의 전체 트리를 무시합니다 (이를 제안 해 주신 'Sromeroi'에 감사합니다).
버전 3.7.0 (2022 년 1 월 17 일)
- '-fromfile'옵션으로 이동하여 '-includefrom'으로 이동했습니다. '-fromfile'은 여전히 작동하지만 더 이상 사용되지 않는 것으로 간주됩니다
- '-includefiles'옵션을 '-includepattern'으로 이동했습니다. '-includefiles'는 여전히 작동하지만 더 이상 사용되지 않는 것으로 간주됩니다
- '-excludefiles'옵션 '-excludepattern'으로 이동했습니다. '--excludefiles'는 여전히 작동하지만 더 이상 사용되지 않는 것으로 간주됩니다
- 추가 '-excludefrom'옵션과 유사한 '-includefrom'만 반대만으로도 (이를 제안 해 주신 'Tomfury'에 감사드립니다)
- Skyscraper는 이제 '.skyscraperignore'라는 파일이 발견 된 입력 폴더 내의 하위 폴더를 무시합니다 (이를 제안한 사용자 'Sromeroi'에 감사합니다).
- 'Screenscraper'스크래핑 모듈을 사용하여 사용할 수있는 플랫폼 'EasyRPG'추가 (이를 제안 해 주신 'ZeroJay'에 감사드립니다).
버전 3.6.16 (2021 년 11 월 9 일)
- 추가 플랫폼 'Moto'(제안해 주신 'Yserra'에 감사드립니다)
버전 3.6.15 (2021 년 8 월 25 일)
- 'Atomiswave'플랫폼에 'CHD'확장을 추가했습니다 (이 보고서에 대한 'Smeegoan'에 감사드립니다)
- ES Gamelists에서 항목을 건너 뛰면 'T000000'이 여러 번 추가 된 버그를 수정했습니다 (이 보고서를 위해 사용자 'sleve_mcdichael'에게 감사합니다).
버전 3.6.14 (2021 년 8 월 5 일)
- MobyGames Scraping Module에 별명으로 'Windows 3.x'를 추가했습니다 (이 보고서에 대해 사용자 'ecto'에게 감사합니다)
버전 3.6.13 (2021 년 6 월 2 일)
- MediafolderHidden 'EmulationStation 특정 구성 옵션이 추가되어 미디어 폴더를 TRUE로 설정할 때'Platform/.media '로 설정합니다. 이렇게하면 네트워크 파일 시스템과 같은 느린 스토리지를 사용할 때 EmulationStation 초기로드 속도가 빨라질 수 있습니다 (이를 제안 해 주신 'Xenuiswatching'에 감사합니다).
버전 3.6.12 (2021 년 5 월 15 일)
- '단순 모드'가 파손되고 더 이상 사용되지 않아 제거되었습니다. 대신 retropie 스크립트를 사용하십시오
- 더 이상 사용되지 않은 (그리고 숨겨진) CLI 옵션을 제거했습니다
버전 3.6.11 (2021 년 5 월 6 일)
- '-fromfile'은 이제 파일 이름에 대한 상대적 및 절대 경로를 모두 받아들입니다 (이것을보고 해 주신 'sleve_mcdichael'에 감사드립니다)
- 추가 플랫폼 'Atarijaguarcd', 'pcenginecd'및 'channelf'가 추가되었습니다 (정보 제공에 대한 사용자 'Xenuiswatching'에 감사드립니다)
버전 3.6.10 (2021 년 4 월 12 일)
- 플랫폼으로 '나오미'를 추가했습니다
- 플랫폼으로 'MSX2'를 추가했습니다
- 플랫폼으로 'Atomiswave'를 추가했습니다
버전 3.6.9 (2021 년 4 월 1 일)
- 아마도 고정
--flags unpack
- 더 이상 사용되지 않는 QT 기능 호출로 인해 3.6.8로 파산 한 고정 된 비디오 변환
버전 3.6.8 (2021 년 3 월 31 일)
- 'cacherefresh'config.ini 옵션을 추가하고 'esgamelist'모듈의 Default Config.ini에 추가했습니다 (이를 제안 해 주신 'Penx'에게 감사합니다).
- 'Screenscraper APIV2 returned allid / empy json'메시지 이제 64 바이트 길이가 넘지 않는 한 오류 json 파일을 첨부하는 메시지가 포함되지 않습니다.
- 지역 우선 순위 목록에 'CA'가 추가되었습니다 (이를 지적 해 주신 'Joaoluizcarvalho'사용자에게 감사합니다)
- 기본 언어 우선 순위 목록에 'de', 'fr'및 'es'가 추가되었습니다.
- '플레이어'리소스에 '-캐시 보고서 : 누락'CLI 옵션 (이것을 보고해 주신 'Peligwe'에 감사드립니다)
- 'TheInfront'config.ini 옵션 및 'TheInfront'Cli 플래그를 추가했습니다 (이를 제안 해 주신 Sleve_MCDICHALE에 감사합니다)
- config.ini의 스크래핑 모듈 섹션에서 'untend'및 'unattendskip'을 사용할 수 있습니다 (이것을보고 해 주신 'sleve_mcdichael'에 감사드립니다).
- 추가 QT 버전 사전 프로세서 추가 QT 설치에서 컴파일 경고를 피하기위한 감가 상각 된 QT 메서드 확인
버전 3.6.7 (2021 년 1 월 27 일)
- 'Wii'및 'GC'플랫폼에 대한 '*.rvz'확장자 추가
- '3DO'플랫폼의 '*.CHD'확장자 추가
- 'Openbor'플랫폼이 추가되었습니다. 실험 플랫폼으로 retropie에 존재합니다 (사용자 'hahnmt'가 요청한대로)
- 'Neogeo'플랫폼은 이제 Screenscraper 모듈로 긁을 때 'Flyer'대신 'Box-2D'를 표지로 사용합니다 (이를 제안 해 주신 'RetRo81'에게 감사합니다).
버전 3.6.6 (2020 년 12 월 21 일)
- 'esgamelist'모듈은 이제 '-g'으로 설정된 경로 대신 '-g'로 설정된 경로에서 'gamelist.xml'파일을 찾아서 '-i'로 설정된 경로 대신 (사용자 'c0d3h4x0r'에 감사하고 디버깅에 도움이된다. ))
버전 3.6.5 (2020 년 12 월 18 일)
- 이제 스레드 당 하나 대신 하나의 공유 네트워킹 인스턴스를 사용합니다.
- 'Daphne'플랫폼 항목은 이제 ''항목 대신``항목으로 추가되었습니다 (이것을 알아내는 데 도움을 주신 'Clyde'에게 감사합니다)
- 'Nocropblack'CLI 플래그 및 'cropblack = "bool"'config.ini 옵션이 추가되어 최종 게임리스트 아트 워크를 구성 할 때 스크린 샷 주위에 검은 색 테두리 자르기를 비활성화 할 수 있습니다 (이를 제안한 사용자 'Windywinston'에게 감사합니다).
버전 3.6.1 (2020 년 10 월 27 일)
- 'amigacd32'를 별도의 플랫폼으로 추가했습니다.
버전 3.6.0 (2020 년 10 월 25 일)
- Pre-5.8 QT 버전을 지원하기 위해 'SecsinceePich'를 'MSECSSINGEEPICH'로 변경했습니다 (이보고에 대해 사용자 'Hazza4569'에 감사드립니다)
구식 릴리스
이전 릴리스에 대한 릴리스 노트는 여기에서 찾을 수 있습니다.