Lars Muldjordによる超高層ビル
Linuxシステム(Macos and Windowsも正式にサポートされていない)で実行されている複数のフロントエンドで使用するために、C ++で作成された強力で用途の広いゲームスクレーパー。スクリーンショット、カバー、ビデオなどのメディアを含む、さまざまなスクレイピングソースからさまざまなゲームリソースをこすり、キャッシュします。次に、キャッシュされたすべてのリソースを組み合わせて、選択したフロントエンドのゲームリストとアートワークを生成するオプションを提供します。
すべての高層ビルの機能は十分に文書化されており、ドキュメントを読んだ後も質問がある場合はFAQもあります。RetropieSubredDitまたは公式のRetropieフォーラムで尋ねることを検討してください。 GitHubのIssues
ページは、バグレポートと機能リクエストのみです。ありがとう!
サポートされているプラットフォーム( '-P'で設定):
ここでプラットフォームの完全なリストを確認してください。
サポートされているスクレイピングモジュール(「-s」で設定)
Suswyscraperは、スクレイピングモジュールと呼ばれるさまざまな擦り源をサポートしています。これらを使用して、ゲームデータを超高層ビルリソースキャッシュに収集します。こちらのスクレイピングモジュールの完全なリストをご覧ください。リソースキャッシュの詳細については、こちらをご覧ください。
サポートされているフロントエンド( '-f'で設定):
- EmulationStation
- アトラクションモード
- ペガサス
コードの貢献とフォーク
私は他のプロジェクトに焦点を当てているため、プルリクエストは現在受け入れられていません。ここで実装したものを超えて現在の機能セットを拡張しようとするコミュニティ主導のフォークを探している場合は、このフォークをチェックする必要があります。
高層ビルの設置方法
以下の手順に従って、Susyscraperの最新バージョンをインストールしてください。 $
で始まる行は、インストールしたいマシンの端末で実行する必要があるコマンドを意味します。
注記! Retropie Distributionを使用している場合は、Retropie-Setupスクリプトから超高層ビルを直接インストールするオプションがあります(スクリプトをインストールする前に更新する必要があります! )。そのすべての詳細については、こちらをご覧ください。そうでない場合は、読んでください。
前提条件をインストールします
Linux
高層ビルにはQT5.3以降が必要です。 Retropie、Ubuntu、またはその他のDebian派生ディストリビューションの場合、次のコマンドを使用してQT5をインストールできます。
$ sudo apt update
$ sudo apt install build-essential qt5-default
Sudoパスワードを求められるかもしれません。 Retropieでは、デフォルトのパスワードはraspberry
です。 QT5を他のLinuxディストリビューションにインストールするには、ドキュメントを参照してください。
注記! Ubuntu 21.04から、 qt5-default
メタパッケージは存在しなくなりました。代わりに、上記のコマンドと同じインストールをインストールするsudo apt install build-essential qtbase5-dev qt5-qmake qtbase5-dev-tools
実行する必要があります。
macos
SkyscraperはMacOSでも完全に機能しますが、Macを所有していないため、公式にはサポートされていません。しかし、HoraceandtheSpiderと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」は、一部のMacOSインストールでは、上記の--with-default-names
が非推奨であると報告しています。削除する場合は、 update_skyscraper.sh
をダウンロードし、実行する前にtar
コマンドをgtar
に編集する必要があります。
ノート2!ユーザー「TRVRPLK」は、MACOS 11.2+に関する多くの問題を報告しています。潜在的な修正については、こちらをご覧ください。
ダウンロード、コンパイル、インストール
上記のように前提条件をインストールした場合、次のコマンドを入力して高層ビルをインストールできます。
$ cd
$ mkdir skysource
$ cd skysource
$ wget -q -O - https://raw.githubusercontent.com/muldjord/skyscraper/master/update_skyscraper.sh | bash
最後のコマンドは、GitHubから最新の更新スクリプトをダウンロードして実行します。インストール中に、sudoパスワードを求められる場合があります。 Retropieでは、デフォルトのパスワードはraspberry
です。
スクリプトが完成したら、高層ビルを実行する準備ができています!
高層ビルの更新
Skyscraper 2.3.2以降から、次のコマンドを実行するだけで最新バージョンに更新できます。
$ cd
$ cd skysource
$ ./update_skyscraper.sh
更新中にSudoパスワードを求められる場合があります。 Retropieでは、デフォルトのパスワードはraspberry
です。バージョンが2.3.2より古い場合( --help
で確認)、代わりにインストール手順に従う必要があります。
高層ビルをアンインストールする方法
このREADMEの手順を使用して高層ビルをインストールした場合、次のコマンドを使用してアンインストールできます。
$ cd
$ cd skysource
$ sudo make uninstall
$ cd
$ rm -Rf skysource
$ rm -Rf .skyscraper
プロセス中にsudoパスワードを求められる場合があります。 Retropieでは、デフォルトのパスワードはraspberry
です。
Windows
現時点ではWindowsは正式にサポートされていません!しかし、私は半定期的にコンパイルし、サポートされていないWindows 64ビットバージョンをリリースします。使用する前に、ダウンロードしたファイルから含まれているreadmeを必ず読んでください!明確にするために:あなたがこのバージョンを使用している場合、あなたはあなた自身にいます - それについて私に質問しないでください。ここでWindowsバージョンを入手してください。
高層ビルの使用方法
重要!!!高層ビルが適切に機能するためには、実行する前にフロントエンドをやめる必要があります! EmulationStationを実行している場合は、F4を押すことで終了できます。
アートワークの超高層ビルの輸出を完全にカスタマイズできることを忘れないでください。こちらのドキュメントをご覧ください。 Default(かなりクールに見える)Artwork Susyscraperが提供するだけの場合は、読んでください。
単純なユースケース
初めてのユーザーの場合は、短いユースケースとポイントユースケースを読むことをお勧めします。それを読んで、あなたがそれの要点を手に入れたらここに戻ってください。
高層ビルの素早い荒廃
Skyscraperはコマンドラインツールであり、あなたがいろいるために多くの多くのオプションがあります。それらのすべてを見て、可能性のある人に慣れることをお勧めします。
$ Skyscraper --help
$ Skyscraper --flags help
$ Skyscraper --cache help
これにより、冒険心を感じた場合、超高層ビルができるすべての説明が得られます!利用可能なすべてのオプションを徹底的に説明するには、こちらをご覧ください。
最も重要なものはおそらく次のとおりです。
-
-p <PLATFORM>
-
-s <SCRAPING MODULE>
-
-u <USER:PASS>
または-u <KEY>
-
--cache refresh
-
--flags videos
Default以外の場所にROMがあります(Retropieユーザーのデフォルトは/home/<USER>/RetroPie/roms/<PLATFORM>
)またはゲームリストやアートワークを非デフォルトの場所にエクスポートしたい場合は、これらが必要です:
-
-i <PATH>
-
-g <PATH>
-
-o <PATH>
ほぼすべてのコマンドラインオプションについては、ここで説明するように、 /home/USER/.skyscraper/config.ini
ファイルにそれらを設定することを検討してください。これにより、オプションが永続的になりますので、常に入力する必要はありません。
ROMのサブセットのデータを収集します
Susyscraperは、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
で高層ビルに送り返すことができます。その後、超高層ビルは、レポートに含まれるファイルのみをこすります。
config.ini
あまり知られていないが非常に有用な高層ビルの特徴は、希望する構成変数を/home/USER/.skyscraper/config.ini
に追加することです。このファイルに設定されたオプションは、デフォルトでSkyscraperによって使用されます。したがって、たとえば、コマンドラインで-i <SOME FOLDER>
を常に使用する場合、configで一致するオプションinputFolder="<SOME FOLDER>"
を設定できます。
すべてのavailabe構成オプションの完全な説明については、こちらをご覧ください。
リソースキャッシュ
超高強力な機能の1つは、リソースキャッシュです。高層ビルを最大限に活用するために、これがどのように機能するかを理解することが重要です。詳細については、こちらをご覧ください。
カスタムデータ
地元のキャッシュされたリソースからのスクレイピングを可能にすることに加えて、Skyscraperを使用すると、 -s import
スクレーピングモジュールで独自のデータをリソースキャッシュにインポートすることもできます。また、キャッシュ内の既存のリソースを編集したり、 --cache edit
コマンドで個々のuser
リソースを追加したりすることもできます。最後に、必要に応じて、既存のEmulationStationゲームリストデータを超高層ビルリソースキャッシュにインポートするオプションもあります。 -s esgamelist
スクレイピングモジュールでこれを行うことができます。
上記の機能の詳細については、こちらのすべてのドキュメントをご覧ください。
アートワークの外観とエフェクト
ここで完全なアートワークのドキュメントを確認してください
ノートをリリースします
バージョンXXX(検討中の機能、すべてが実装されていない)
- 特定のスクレイピングモジュールから純粋に発信されたキャッシュデータからスクレイプするオプションを追加する
- AliASMAPを検索用語の基本名のみではなく、グローバルベースネームにすることを検討してください。これにより、後で無視されるエイリアス名の欠落しているブラケットが修正されます
- すべてのアートワークタイプをカスタムにして、そのタイプがユーザーが望むものにすることができることを意味します。ソースは、「スクリーンショット」や「カバー」などの既知のタイプを持つものを作成しますが、ユーザーは「キャビネット」など、自分自身を定義する他のタイプをインポートできます。内部的にアートワークは、GameEntryの4つのハードコードされたタイプではなく、アートワークのリストによって処理されます
- Artwork.xmlの「file = "somefolder/.png" '」で使用する機能を紹介します。これにより、ゲームbasename.pngで「リソース」のファイルを探します。インポートに新しいタイプを追加すること(これを提案してくれた「Jueank」に感謝します)
- すでに既存のプラットフォームにエイリアスを使用して、カスタムプラットフォームを構成で構成して、カスタムプラットフォームをスクレイピングするオプションを追加します。例:Scrape 'pcenginecd'は、PCENGINEフォルダーの代わりに「ROMS/PCENGINECD」フォルダーにそれらのファイルがある場合に備えて、「PCENGINE」として削ることができます。ここで確認してください:#136
- アートワークコンポジタのテストモードを作成して、アートワークXMLですべてをセットアップしたかどうかを確認するために例をすばやくレンダリングしてください
- 「領域」が「RegionPrios」に似たリストになるようにします。 「リージョン」を使用する場合、デフォルトの優先順位リストを保持し、「リージョン」からトップに追加するだけです。 「RegionPrios」はまだ完全に上書きする必要があります。命名の変更は、おそらく「領域」を「regionsprefer」などに変更するなど、おそらく良いアイデアです。 「RegionPrios」も「Regionsoverride」に変更する必要があります。 (これを提案してくれた「Corezon」に感謝します)。
- 「Import」モジュールに剛性の低いファイル名マッチを実装して、緊密な一致ファイル名を可能にします
- マルチディスクゲームのグループ化のサポートを追加して、ゲームエントリに1つのエントリしかないようにします。問題/232を参照してください(これを提案してくれた「Ingo2k」に感謝します)
バージョン3.7.7(2022年6月28日)
- 「SEGACD」プラットフォームに「*.M3U」を追加しました(ユーザー「BMN001」に感謝します)
バージョン3.7.6(2022年6月12日)
- 「Pico8」プラットフォームを追加しました(ユーザー「Zerojay」を提案してくれてありがとう)
バージョン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' optionに移動しました。 ' - FromFile」はまだ機能しますが、非推奨と見なされます
- '-includefiles'オプションを ' - includepattern'に移動しました。 '-ludefiles'はまだ機能しますが、非推奨と見なされます
- ' - excludefiles'オプションを ' - excludepattern'に移動しました。 '-excludefiles'は引き続き機能しますが、非推奨と見なされます
- '-excludefrom'オプションに類似した ' - includefrom'のみを追加しました(これを提案してくれたユーザー「Tomfury」に感謝します)
- Skyscraperは、「.skyscraperignore」と呼ばれるファイルが見つかった入力フォルダー内のサブフォルダーを無視します(これを提案してくれたユーザーのsromeroiに感謝します)
- プラットフォーム「EasyRPG」を追加しました。「Screenscraper」スクレイピングモジュールを使用してのみ使用できます(これを提案してくれたユーザー「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スクレイピングモジュールのエイリアスとして「Windows3.x」を追加しました(これを報告してくれたユーザー「Ecto」に感謝します)
バージョン3.6.13(2021年6月2日)
- Media Folderをtrueに設定したときに「Platform/.media」に設定する「MediaFolderHidden」エミュレーション固有の構成オプションを追加しました。これにより、ネットワークファイルシステムなどのスローストレージを使用する場合、エミュレーションの初期読み込みをスピードアップできます(これを提案してくれたユーザー「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日)
- プラットフォームとして「Naomi」を追加しました
- プラットフォームとして「MSX2」を追加しました
- プラットフォームとして「AtomisWave」を追加しました
バージョン3.6.9(2021年4月1日)
- おそらく修正された
--flags unpack
- おそらく、QT関数呼び出しが拒否されたために3.6.8で壊れたビデオ変換を固定した
バージョン3.6.8(2021年3月31日)
- 「cacherefresh」config.iniオプションを追加し、「esgameList」モジュールのデフォルトconfig.iniに追加しました(これを提案してくれたユーザー「penx」に感謝します)
- 'Screenscraper APIV2は無効 /空のJSONのメッセージを返しました'長さが64バイトを超えない限り、エラーJSONファイルを添付するメッセージが含まれなくなりました
- 地域の優先リストに「Ca」を追加しました(これを指摘してくれたユーザー「Joaoluizcarvalho」に感謝します)
- デフォルト言語の優先順位リストに「de」、 'fr'、および「es」を追加しました
- 「プレーヤー」リソースを追加しました ' - キャッシュレポート:' CLIオプションがありません(これを報告してくれたユーザー「Peligwe」に感謝します)
- 「theinfront」config.iniオプションと「theinfront」cliフラグを追加しました(これを提案してくれたユーザー 'sleve_mcdichaelに感謝します)
- config.iniのスクレイピングモジュールセクションで「Unatdend」と「Unattendskip」を使用できるようになりました(これを報告してくれたユーザー 'sleve_mcdichaelに感謝します)
- 新しいQTインストールでの編集警告を回避するために、QTバージョンの事前プロセッサチェックが廃止されたQTメソッドをチェックしました
バージョン3.6.7(2021年1月27日)
- 「Wii」および「GC」プラットフォームの「*.RVZ」拡張機能を追加しました(これを報告してくれたユーザー「TCAMARGO」に感謝します)
- 「3DO」プラットフォームの「*.CHD」拡張機能を追加しました(これを報告してくれたユーザー「Roudaku」に感謝します)
- 「Openbor」プラットフォームを追加しました。 Retropieには実験プラットフォームとして存在します(ユーザー「hahnmt」が要求します)
- 「neogeo」プラットフォームは、スクリーンスクレーパーモジュールで削ったときに「チラシ」の代わりに「チラシ」の代わりに「Box-2D」を使用するようになりました(これを提案してくれたユーザー「Retro81」に感謝します)
バージョン3.6.6(2020年12月21日)
- 「esgameList」モジュールは、パスを「-i」で設定するパスセットの代わりに「-g」で設定されたパスで「gameList.xml」ファイルを探すようになりました(これを報告してくれたユーザー 'c0d3h4x0r'に感謝し、デバッグを手伝ってくれます))
バージョン3.6.5(2020年12月18日)
- スレッドごとに1つではなく、1つの共有ネットワークインスタンスを使用するようになりました
- 「Daphne」プラットフォームエントリは、「エントリの代わりに「エントリ」として追加されました(これを理解してくれたユーザー「Clyde」に感謝します)
- 'nocropblack' cliフラグと「cropblack = "bool" 'config.iniオプションが追加されました。これにより、ユーザーは最終的なゲームリストのアートワークを構成するときにスクリーンショットの周りに黒い境界線のトリミングを無効にします(これを提案してくれたユーザー「WindyWinston」に感謝します)
バージョン3.6.1(2020年10月27日)
- 別のプラットフォームとして「amigacd32」を追加しました(ユーザーに感謝します。「horaceandtheSpider」をリセットしてくれてありがとう)
バージョン3.6.0(2020年10月25日)
- 5.8 QTバージョンをサポートするために、「SecssincePich」を「MSECSSSINCEPICH」に変更しました(これを報告してくれたユーザー 'hazza4569'に感謝します)
古いリリース
古いリリースのリリースノートはこちらにあります。