Repository navigation
Releases: matsuotakeshi/RetroNativeSaver
Release list
RetroNativeSaver v0.21.26
English
RetroNativeSaver v0.21.26 adds a configuration dialog with per-system settings and English/Japanese language selection. Existing JSON settings, favorites, saves and states remain compatible.
Changes
- Open settings from Windows screensaver settings, RandomSaver's configuration command, or
configure_saver.bat. General, Title Display and Grouped Display tabs cover common settings; management buttons open favorites/startup input, blacklist/whitelist, and ROM catalog tools. - Select a system in the Systems tab to edit its core DLL, ROM/BIOS/save paths, rotation time, resource limits, renderer, disk startup settings and core options. Unedited and unknown JSON fields are preserved. Saves create per-file backups and check for external edits.
- Set the RetroArch executable in General. A blank path preserves existing automatic detection.
- Choose General → Language / 言語 → Automatic (Windows), English or 日本語. Save with Apply / OK, then reopen the window. Favorites, startup input, ROM selection and list management use the same saved language. Automatic is the default: Japanese for Japanese Windows display language, English otherwise. Windows standard dialogs/buttons and OS error details may follow the Windows language.
- Application logging is now off by default, including existing configurations without
log_output_enabled. Enable General → Write logs or set"log_output_enabled": trueto save monitoring/error logs. Safety monitoring and cleanup remain active when logging is off.
Download and update
Download RetroNativeSaver-v0.21.26-update-windows-x64.zip, exit the saver, and copy its RetroNativeSaver folder contents into your existing writable installation. Update EXE, SCR and _internal together. Keep your configuration, systems, favorites, cores, ROMs, BIOS, saves and states. A ROM catalog rebuild is needed only if you change ROM search settings.
This is an update package, not a complete fresh-install kit. It includes corresponding source and license notices, but no ROMs, BIOS files or emulator cores. The separate source ZIP and SHA-256 checksum files are also attached. See the English README for setup and source builds.
Verification
- 766 source tests and 512 bundled-module tests passed, plus 16 executable checks and 14 configuration/management window checks covering English, Japanese, automatic selection and external window ownership.
- The user confirmed normal operation, including English/Japanese switching. This does not establish compatibility with every game, machine or startup route; development checks did not include full-screen endurance runs or manual operation through Windows Settings/RandomSaver itself.
- The released EXE/SCR and runtime files are the same confirmed build. Only the bundled update notice was refreshed for publication. Source is checked against the release commit, and uploaded asset hashes are verified.
Original project code is GPL-3.0-only. Third-party components retain their separate licenses, as listed in THIRD_PARTY_NOTICES.md.
日本語
v0.21.26では、機種別設定と日英切り替えに対応した設定ダイアログを追加しました。既存のJSON設定・お気に入り・save・stateの互換性を維持しています。
変更内容
- Windowsのスクリーンセーバー設定、RandomSaverの設定呼び出し、
configure_saver.batから設定画面を開けます。「全般・タイトル表示・グループ表示」に加え、お気に入り/自動入力、ブラック/ホワイトリスト、ROM一覧更新への入口を用意しました。 - 「機種別」で機種を選び、コアDLL、ROM・BIOS・セーブ先、表示時間、負荷制限、描画方式、ディスク起動、コアオプションなどを編集できます。未編集項目・未知のJSONキーを保持し、保存時はファイル単位のバックアップと外部変更の確認を行います。
- 「全般」でRetroArchの実行ファイルを指定できます。空欄では従来の自動検出を維持します。
- 全般 → Language / 言語で自動・English・日本語を選べます。「適用/OK」で保存し、画面を開き直すと反映されます。管理画面も同じ保存済み言語を使用します。初期値は自動で、Windowsの表示言語が日本語なら日本語、それ以外は英語です。Windows標準画面のボタンやOSのエラー詳細はWindows側の言語になる場合があります。
- アプリのログ出力は初期値オフです。
log_output_enabledがない既存設定もオフになります。「全般 → ログを出力する」または"log_output_enabled": trueで保存を再開できます。ログをオフにしても異常監視・安全な終了・回収処理は維持します。
ダウンロードと更新
RetroNativeSaver-v0.21.26-update-windows-x64.zipを取得し、セーバー終了後にZIP内のRetroNativeSaverフォルダーの中身を既存の書き込み可能な設置先へコピーしてください。EXE・SCR・_internalをまとめて更新します。既存の設定・systems・お気に入り・コア・ROM・BIOS・save・stateは保持してください。ROM一覧の再作成は、ROM検索条件を変更した場合だけ必要です。
このZIPは更新専用です。対応ソースとライセンスを同梱しますが、ROM・BIOS・エミュレーターコアは含みません。単独のソースZIPとSHA-256確認用ファイルも添付しています。導入とソースビルドは日本語READMEを参照してください。
確認範囲
- ソース766件・組込モジュール512件のテスト、実行ファイル16件、英語・日本語・自動判定・親ウィンドウとの関連付けを含む設定/管理画面14件の確認が成功しています。
- ユーザー環境で日英切り替えを含め動作確認済みです。全機種・全ROM・全起動経路の確認を意味するものではありません。開発時の確認では、全画面での長時間動作やWindows設定/RandomSaver本体からの手操作は実施していません。
- EXE・SCRと実行に必要なファイルは動作確認済みビルドと同一です。同梱の更新案内だけを公開用に更新しました。ソースを公開コミットと照合し、添付ファイルのハッシュも確認します。
本体独自コードはGPL-3.0-onlyです。第三者コードにはTHIRD_PARTY_NOTICES.mdに記載した個別ライセンスが適用されます。
RetroNativeSaver v0.21.24
English
Fixes Enter-to-RetroArch handoff failing with “normal desktop shell” when RetroNativeSaver runs on a separate Windows desktop. This is a shared launcher fix; the failure was observed with SNES and GBA.
Changes
- When the saver cannot find the desktop shell, look up the normal
Defaultdesktop on a dedicated thread in the same interactive window station. - Preserve saver cleanup and launch RetroArch outside the saver Job, so closing the saver does not terminate the game.
- Check the input desktop before and during the fallback. Locked, authentication-required, inaccessible or unrecognized desktops stop the handoff. No visible-desktop switch, Windows unlock or security-setting change is performed.
- Release desktop and process handles on failure, including interrupted lookups, and log the desktop context when the fallback is used.
Download and update
Download RetroNativeSaver-v0.21.24-update-windows-x64.zip, exit the screensaver, and copy the contents of its RetroNativeSaver folder into your existing writable installation. Update EXE, SCR and _internal together. Keep your configuration, systems, favorites, cores, saves and state. No configuration change or ROM catalog rebuild is required for this fix.
This is an update package, not a fresh-install kit. It includes corresponding source and license notices, but no ROMs, BIOS files or emulator cores. The separate RetroNativeSaver-v0.21.24-source.zip and SHA-256 checksum files are also attached. See the English README for source builds.
Verification
- 701 source regression tests and 447 bundled-module tests passed.
- A real hidden Windows desktop and restricted Job reproduced the old error. Both source and bundled fixes launched a diagnostic application on the normal desktop, outside the saver Job; it survived Job termination and exited normally. The normal-desktop launch path was also checked.
- EXE/SCR preview exit, invalid configuration handling and ROM catalog updates were checked. Locked-desktop and API-failure cases were covered by mocked Win32 tests; an actual locked Windows session was not tested.
- After installing this build, the user confirmed that RetroArch handoff worked. This does not establish compatibility with every game, startup route or hardware configuration.
The downloadable binaries are the same build the user confirmed. Original project code is GPL-3.0-only; third-party components retain their separate licenses, as listed in THIRD_PARTY_NOTICES.md.
日本語
セーバーが通常とは別のWindowsデスクトップで動いている場合に、EnterでのRetroArch引き継ぎが「normal desktop shell」エラーで中止される問題を修正しました。SNES・GBAで記録された失敗に対応する、全機種共通の起動処理の修正です。
変更内容
- 通常のシェルが見つからない場合、専用スレッドで同じWindowsセッションの
Defaultデスクトップを参照します。 - 既存のセーバー終了・回収処理を維持し、RetroArchがセーバーの終了に巻き込まれない起動方法を保ちます。
- 引き継ぎ前と処理中に入力先を確認します。ロック画面・認証が必要な状態・参照できない状態・未知のデスクトップでは中止します。表示画面の強制切り替え、Windowsのロック解除、セキュリティ設定の変更は行いません。
- 失敗・中断時もデスクトップとプロセスのハンドルを回収し、追加の引き継ぎ処理を使用した場合はデスクトップ情報をログへ記録します。
ダウンロードと更新
RetroNativeSaver-v0.21.24-update-windows-x64.zipを取得し、スクリーンセーバーを終了してから、ZIP内のRetroNativeSaverフォルダーの中身を既存の書き込み可能な設置先へコピーしてください。EXE・SCR・_internalをまとめて更新し、設定・systems・お気に入り・コア・save・stateは既存のものを保持します。今回の修正に設定変更やROM一覧の再作成は不要です。
Windows用ZIPは更新専用で、新規インストール用の一式ではありません。対応ソースとライセンス文書を同梱しています。ROM・BIOS・エミュレーターコアは含みません。単独のRetroNativeSaver-v0.21.24-source.zipとSHA-256確認用ファイルも添付しています。ソースからのビルドは日本語READMEを参照してください。
確認範囲
- 全701回帰テストと組込モジュールの447テストが成功しています。
- Windows上の非表示の別デスクトップと制約付きJobで旧版のエラーを再現しました。修正版のソース・組込コードでは、通常デスクトップ上にテストアプリを起動でき、セーバー側Jobの終了後も生存して正常終了することを確認しました。通常デスクトップからの既存経路も確認しています。
- EXE/SCRのプレビュー終了・不正設定時の処理・ROM一覧更新を確認しました。ロック状態やAPI失敗時の中止・回収は模擬APIによるテストで確認しており、実際にWindowsをロックした状態の試験は未実施です。
- 差し替え後、ユーザー環境でRetroArchへの引き継ぎが動作したと確認されています。すべてのゲーム・起動経路・機器構成を検証済みとするものではありません。
配布する実行ファイルは、ユーザーが動作確認したものと同じビルドです。本体独自コードはGPL-3.0-onlyです。第三者コードにはTHIRD_PARTY_NOTICES.md記載の個別ライセンスが適用されます。
RetroNativeSaver v0.21.23
English
This release combines the one-line scrolling labels introduced in v0.21.22 with PC-FX support in the PC Engine / CD-ROM² group.
Changes
- Display
System / Gameon one line at the upper left of each tile. Both parts use the system-label font and size, retain their existing colors, and scroll from right to left within the tile. Titles pause at the left edge before continuing; short titles also scroll. Keyboard selection/help messages remain stationary. - Add PC-FX to the default PC Engine / CD-ROM² group:
["pcengine", "pcenginecd", "pcfx"]. Each tile can select games from those systems using the existing grouped scheduler. PC-FX retains its existing core, BIOS, ROM handling andheavy_cdresource weight of 1. No automatic startup button input is added, and normal-mode limits are unchanged. - Include
enable_pcfx_group.batto add PC-FX to an existing explicit NEC group. It backs upconfig.json, preserves other setting values, and does nothing if PC-FX is already in that group. Existingdisabled_systemssettings are respected.
Downloads and updating
- Download RetroNativeSaver-v0.21.23-update-windows-x64.zip and exit the screensaver.
- Copy the contents of its
RetroNativeSaverfolder into your existing writable installation folder, including EXE, SCR,_internalandenable_pcfx_group.bat. Keep your existing configuration, systems, favorites, cores, saves and state. - To add PC-FX to an existing explicit group list, run enable_pcfx_group.bat from the installation folder, or add
"pcfx"to that group manually. Existing explicit lists are not expanded automatically.
Scrolling is enabled by default without changing existing settings. Optional settings under overlay are scroll_speed (default 24 pixels/second), scroll_pause_seconds (default 2), and scroll_gap (minimum gap, default 48 pixels). Set scroll_speed to 0 for a stationary single line, or scroll_enabled to false to restore the previous two-line display. No ROM catalog rebuild is needed.
The Windows ZIP is an update package, not a fresh-install kit. For a source build, download RetroNativeSaver-v0.21.23-source.zip or GitHub's source archive and follow the English README. The update also contains its corresponding source archive and license notices. SHA-256 checksum files are attached. ROMs, BIOS files and emulator cores are not included in the update.
Verification
All 684 source regression tests and 430 bundled-module tests passed. EXE/SCR preview exit, configuration-error handling, ROM catalog updates and the configuration batch were checked. The unchanged scrolling renderer was checked with actual offscreen Windows GDI rendering in v0.21.22, including clipping across 64 sample tiles and resource release. The user confirmed the scrolling display and reported practical operation of the mixed PC Engine / CD-ROM² / PC-FX group on their system. This does not establish compatibility or long-term performance for every game and hardware configuration.
Original project code is GPL-3.0-only. Third-party components retain their separate licenses; see THIRD_PARTY_NOTICES.md.
日本語
v0.21.22の1行スクロール表示と、v0.21.23のPC-FXグループ対応をまとめたリリースです。
変更内容
- 各枠の左上に「機種名 / ソフト名」を1行で表示します。両方とも機種名と同じフォント・文字サイズを使い、色は従来の設定を維持します。左端で停止してから右から左へ繰り返し流れ、隣の枠にはみ出しません。短い名前もスクロールします。キー操作の案内・結果表示は静止したままです。
- PC Engine/CD-ROM²グループにPC-FXを追加しました。設定例は
["pcengine", "pcenginecd", "pcfx"]で、既存のグループ表示の仕組みで各枠のソフトを抽選します。PC-FXのコア・BIOS・ROMの扱いとheavy_cd・resource_weight=1は維持し、自動ボタン入力は追加していません。通常表示の上限も変更しません。 - 既存の明示的なグループ一覧へPC-FXを追加する
enable_pcfx_group.batを同梱しました。config.jsonをバックアップし、他の設定値を保持して更新します。追加済みなら変更しません。disabled_systemsによる停止設定も保持します。
ダウンロードと更新
- RetroNativeSaver-v0.21.23-update-windows-x64.zipを取得し、スクリーンセーバーを終了します。
- ZIP内の
RetroNativeSaverフォルダーの中身を、既存の書き込み可能な設置先へコピーします。EXE・SCR・_internal・enable_pcfx_group.batを含めて更新し、設定・systems・お気に入り・コア・save・stateは既存のものを保持してください。 - 既存のグループ一覧にPC-FXを追加する場合は、設置先のenable_pcfx_group.batを実行するか、同じグループの配列に
"pcfx"を追記してください。明記済みのグループ構成は自動では変更しません。
スクロールは設定変更なしで有効になります。overlay内のscroll_speed(初期値24ピクセル/秒)、scroll_pause_seconds(初期値2秒)、scroll_gap(最小間隔、初期値48ピクセル)で調整できます。scroll_speedを0にすると1行の静止表示、scroll_enabledをfalseにすると従来の2行表示へ戻せます。ROM一覧の再作成は不要です。
Windows用ZIPは更新専用で、新規インストール用の一式ではありません。ソースからビルドする場合はRetroNativeSaver-v0.21.23-source.zipまたはGitHubのソースアーカイブを取得し、日本語READMEを参照してください。更新ZIPにも対応ソースとライセンス文書を同梱しています。SHA-256確認用ファイルも添付しています。ROM・BIOS・エミュレーターコアは今回の更新ZIPに含めていません。
確認範囲
全684回帰テストと組込モジュールの430テストが成功しています。EXE/SCRのプレビュー終了・不正設定時の処理・ROM一覧更新・設定更新バッチも確認しました。スクロール描画はv0.21.22から変更しておらず、同版でWindows GDIによる64枠分の画面外描画、枠内への切り取り、資源解放を確認しています。ユーザー環境ではスクロールの見え方と、PC Engine/CD-ROM²/PC-FX混在グループの実用的な動作が確認されています。すべてのゲーム・機器構成・長時間稼働条件を検証済みとするものではありません。
本体独自コードはGPL-3.0-onlyです。第三者コードには個別のライセンスが適用されます。THIRD_PARTY_NOTICES.mdを参照してください。
RetroNativeSaver v0.21.21
English
This release includes the disk-selection fix from v0.21.20 and the overlay improvements in v0.21.21.
Changes
- Fix disk selection for PC-98, X1, X68000 and FM-7 using
computer_two_drives: an explicitDisk N of Mlabel takes priority over a secondary label such as(Disk 1). Numbered sets with a separate(System)disk now select the first and second disks correctly. PlainDisk 1/Disk 2andDisk A/Disk Bkeep their existing behavior; ambiguous sets and missing boot disks remain rejected. - Reduce the space between the system and game labels by removing duplicate inner padding. Outer padding, font size, colors, transparency and the
overlay.line_gapsetting are preserved. - Omit the known core-name suffixes from on-screen system labels. Configured names, logs and persistent state keys are unchanged.
- English and Japanese READMEs include the supported-systems table and explain the need for a writable installation folder.
Downloads and updating
Existing installations: download RetroNativeSaver-v0.21.21-update-windows-x64.zip. Exit the screensaver, then copy its RetroNativeSaver folder contents into the existing writable installation folder, including both EXE/SCR and _internal. Keep your existing configuration, systems, favorites, cores, saves and state. Active settings are not included, and no ROM catalog rebuild is needed.
This ZIP is an update package, not a fresh-install kit. For a source build, use RetroNativeSaver-v0.21.21-source.zip or GitHub's source archives and follow the English README. The update also includes its corresponding source archive and license notices. SHA-256 checksum files are attached. ROMs, BIOS files and emulator cores are not included in this update.
Verification
The packaged source passed all 667 regression tests; checks against bundled modules passed 413 tests. EXE/SCR preview exit, configuration-error handling, ROM catalog updates and offscreen Windows GDI rendering were also checked. The user confirmed normal operation and visually confirmed X68000 Signatory starting through the targeted disk-selection check. This does not establish compatibility with every game, system or long-running configuration.
Original project code is GPL-3.0-only. Third-party components retain their separate licenses; see THIRD_PARTY_NOTICES.md.
日本語
v0.21.20のディスク選択修正と、v0.21.21の画面表示改善をまとめたリリースです。
変更内容
- PC-98・X1・X68000・FM-7の
computer_two_drivesで、補足の(Disk 1)などよりDisk N of Mの全体番号を優先するよう修正しました。(System)が別ディスクになっている組でも、全体の1枚目・2枚目を選択します。従来のDisk 1/Disk 2やDisk A/Disk Bの扱いと、曖昧な組・起動ディスク欠落時の拒否は維持します。 - 機種名とソフト名の間の二重余白を取り除き、間隔を詰めました。外周の余白・文字サイズ・色・透過率・
overlay.line_gapの設定は維持します。 - 画面上の機種名から既知のコア名の補足を省きました。設定上の名前・ログ・履歴のキーは変更しません。
- 英語・日本語READMEに対応機種一覧と、書き込み可能なフォルダーへの配置についての説明を収録しました。
ダウンロードと更新
既存環境の更新: RetroNativeSaver-v0.21.21-update-windows-x64.zipを使用してください。スクリーンセーバーを終了し、ZIP内のRetroNativeSaverフォルダーの中身を既存の書き込み可能な配置先へコピーします。EXE・SCR・_internalをそろえて更新し、設定・systems・お気に入り・コア・save・stateは既存のものを保持してください。運用設定は同梱していません。ROM一覧の再作成も不要です。
このZIPは更新専用で、新規インストール用の一式ではありません。ソースからビルドする場合はRetroNativeSaver-v0.21.21-source.zipまたはGitHubのソースアーカイブを取得し、日本語READMEを参照してください。更新ZIPにも対応ソースとライセンス文書を同梱しています。SHA-256確認用ファイルを添付しています。ROM・BIOS・エミュレーターコアは今回の更新ZIPに含めていません。
確認範囲
配布ソースの全667回帰テスト、組込モジュールの413テストが成功しています。EXE/SCRのプレビュー終了・不正設定時の処理・ROM一覧更新・Windows GDIでの画面外描画も確認しました。ユーザー環境では通常動作と、専用の確認用バッチによるX68000 Signatoryの起動が目視確認されています。すべてのゲーム・機種・長時間稼働条件を検証済みとするものではありません。
本体独自コードはGPL-3.0-onlyです。第三者コードには個別のライセンスが適用されます。THIRD_PARTY_NOTICES.mdを参照してください。
RetroNativeSaver v0.21.19
English
First GitHub release of RetroNativeSaver, a Windows screensaver that runs libretro games in tiled layouts. This release packages the existing v0.21.19 application with licensing documents and English/Japanese READMEs.
Highlights
- Up to 64 simultaneous game tiles across multiple monitors: 28 tiles on 1920×1080 and 36 on 2560×1080. The FBNeo-only group uses 32 tiles across two monitors.
- Independent game processes, ROM selection, fades, and asynchronous rotation, with per-system timing settings.
- Normal and grouped display modes, a favorites tile, configurable input sequences, and blacklist/whitelist management.
- Original project code under GPL-3.0-only. X1/libretro components retain their separate licenses and notices.
Download and build
- Windows x64 binaries: RetroNativeSaver-v0.21.19-windows-x64.zip (17.7 MB). Includes EXE/SCR, the required application runtime files, public configuration defaults, the custom X1 two-drive core, license notices, and the matching application source archive.
- Source: Source code (zip) or Source code (tar.gz) below. Follow the English README to build it yourself.
- A
.sha256checksum file is also attached.
Extract the entire binary ZIP and read BINARY_README.txt. Keep _internal and all accompanying folders beside the EXE/SCR. Configure your ROM, BIOS, and core paths, run update_rom_catalog.bat, and then use test_saver.bat or install_saver.bat. Other libretro cores, ROMs, BIOS files, and personal data are not included. Existing installations should retain their configuration, favorites, saves, and state when updating.
Binary validation: 390 tests using bundled Python modules passed; EXE/SCR preview dispatch and exit, configuration-error handling, catalog updates, and X1 DLL loading/libretro API were checked. No new full-screen or real-ROM endurance test was performed for this binary package.
日本語
RetroNativeSaverの初回GitHubリリースです。既存のv0.21.19に、ライセンス文書と英語・日本語のREADMEを揃えました。
主な機能
- 複数モニターで最大64画面を同時表示。1920×1080に28枠、2560×1080に36枠を配置します。FBNeo単独グループは2台で32枠です。
- 各枠で独立したゲーム実行・ROM抽選・フェード・非同期ローテーション。機種ごとの表示時間も設定できます。
- 通常表示/グループ表示、お気に入り枠、連続キー入力、ブラックリスト/ホワイトリスト管理。
- 本体独自コードはGPL-3.0-only。X1/libretroなどの第三者コードには、それぞれのライセンスと著作権表示が適用されます。
ダウンロードとビルド
- Windows x64ビルド済み版: RetroNativeSaver-v0.21.19-windows-x64.zip(約17.7MB)。EXE/SCR、必要な実行用ファイル、公開用初期設定、X1の2ドライブ対応専用コア、ライセンス文書、対応する本体ソースZIPを同梱しています。
- ソース: 下の Source code (zip) または Source code (tar.gz)。日本語READMEにビルド手順があります。
- 確認用の
.sha256ファイルも添付しています。
ビルド済みZIPは全体を展開し、BINARY_README.txtを参照してください。_internalなどの同梱フォルダーはEXE/SCRと同じ場所に保持します。ROM・BIOS・コアのパスを設定し、update_rom_catalog.bat実行後、test_saver.batで確認、install_saver.batで登録できます。X1以外のlibretroコア、ROM、BIOS、個人データは含めていません。既存環境の設定・お気に入り・save・stateは上書きせず保持してください。
検証済み: 梱包したPythonモジュールを使う390テスト、EXE/SCRのプレビュー起動経路・終了、不正設定時の処理、ROM一覧更新、X1 DLLの読込とlibretro API。今回のビルドでの全画面・実ROMによる長時間試験は未実施です。