Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,22 @@ All notable changes are documented here. Versions follow the Playnite extension

## [Unreleased]

## [0.7.0] - 2026-09-11

### Added

- The configured boot screen can now cover Playnite's built-in Desktop-to-Fullscreen transition; the option is enabled by default and can be disabled in settings.
- A lightweight on-demand bootstrap cover bridges the Desktop window closing to the existing boot overlay without keeping a helper process resident.

### Changed

- Managed runtime files are now synchronized by content on Playnite startup, so runtime updates and repairs no longer depend only on `VERSION.txt`.
- Runtime updated to 1.0.7.

### Compatibility

- Desktop-to-Fullscreen interception fails open: if the bootstrap cover cannot be armed, Playnite continues its native transition normally.

## [0.6.2] - 2026-09-02

### Fixed
Expand Down
4 changes: 2 additions & 2 deletions PlayniteBoot/Properties/AssemblyInfo.cs
Original file line number Diff line number Diff line change
Expand Up @@ -8,5 +8,5 @@
[assembly: AssemblyCopyright("Copyright © VirtualGIT20 2026")]
[assembly: ComVisible(false)]
[assembly: Guid("29f3bcc1-12ed-423e-8c61-d0eb0218eec3")]
[assembly: AssemblyVersion("0.6.2.0")]
[assembly: AssemblyFileVersion("0.6.2.0")]
[assembly: AssemblyVersion("0.7.0.0")]
[assembly: AssemblyFileVersion("0.7.0.0")]
2 changes: 1 addition & 1 deletion PlayniteBoot/extension.yaml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
Id: PlayniteBoot_71b5c099-3c25-4fe7-b26f-1262c7f0e138
Name: Playnite Boot Screen
Author: VirtualGIT20
Version: 0.6.2
Version: 0.7.0
Module: PlayniteBoot.dll
Type: GenericPlugin
Icon: icon.png
Expand Down
4 changes: 3 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

![Playnite Boot Screen preview](docs/assets/boot-screen.png)

Playnite Boot Screen is a Playnite Generic Plugin that displays a configurable fullscreen boot video while Playnite Fullscreen starts in the background.
Playnite Boot Screen is a Playnite Generic Plugin that displays a configurable fullscreen boot video while Playnite Fullscreen starts in the background and can also cover Playnite's built-in Desktop-to-Fullscreen transition.

## Demo

Expand All @@ -16,6 +16,7 @@ https://github.com/user-attachments/assets/6d77a081-9165-4f0f-a6bb-785642ced0e7
- Follow Playnite's Fullscreen display setting or choose a monitor manually, with safe multi-monitor readiness detection.
- Configurable scaling, fades, mute, and volume from 0 to 100.
- Reveal Playnite as soon as it is ready, or wait for the video to end naturally.
- Cover Playnite's built-in Desktop-to-Fullscreen transition with the configured boot video; enabled by default and optional in settings.
- Managed runtime stored outside the replaceable extension installation directory.
- Configurable Desktop and Start menu shortcut name.
- Streaming Preload and Continue commands shown directly in the settings page.
Expand Down Expand Up @@ -84,6 +85,7 @@ Persistent files are stored under Playnite's extension data directory:
```

The extension installation directory can be safely replaced during updates without deleting custom media, configuration, or logs.
Managed runtime files are synchronized by content when Playnite starts, while custom media, configuration, and logs remain untouched.

Place `.mp4`, `.mkv`, `.webm`, `.avi`, or `.mov` files directly in `Runtime\media`, then use **Refresh list** in the settings page. Files outside this folder can still be selected with **Browse external…**.

Expand Down
4 changes: 3 additions & 1 deletion README_IT.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

![Anteprima di Playnite Boot Screen](docs/assets/boot-screen.png)

Playnite Boot Screen è un'estensione Generic Plugin per Playnite che mostra un video di avvio a schermo intero mentre Playnite Fullscreen viene caricato in background.
Playnite Boot Screen è un'estensione Generic Plugin per Playnite che mostra un video di avvio a schermo intero mentre Playnite Fullscreen viene caricato in background e può coprire anche la transizione integrata di Playnite da Desktop a Fullscreen.

## Demo

Expand All @@ -16,6 +16,7 @@ https://github.com/user-attachments/assets/fc1d7d9a-7a05-4b44-a43e-959a9b4a4fad
- Possibilità di seguire il display Fullscreen scelto da Playnite oppure selezionare manualmente il monitor, con rilevamento sicuro in configurazioni multi-monitor.
- Adattamento, fade, mute e volume da 0 a 100 configurabili.
- Possibilità di mostrare Playnite appena pronto oppure attendere la fine naturale del video.
- Copertura della transizione integrata Desktop → Fullscreen con il video configurato, attiva di default e disattivabile dalle impostazioni.
- Runtime gestito fuori dalla directory sostituita durante gli aggiornamenti dell'estensione.
- Nome personalizzabile per i collegamenti Desktop e menu Start.
- Comandi Preload e Continue nella schermata Streaming.
Expand Down Expand Up @@ -78,6 +79,7 @@ I file persistenti vengono salvati nella directory dati dell’estensione:
```

La directory di installazione dell’estensione può essere sostituita senza eliminare video personalizzati, configurazione o log.
I file runtime gestiti vengono sincronizzati in base al contenuto all’avvio di Playnite, mentre video personalizzati, configurazione e log restano intatti.

Copia i file `.mp4`, `.mkv`, `.webm`, `.avi` o `.mov` direttamente in `Runtime\media`, quindi usa **Aggiorna elenco** nelle impostazioni. I file esterni alla cartella restano selezionabili tramite **Sfoglia esterno…**.

Expand Down
19 changes: 10 additions & 9 deletions RELEASE_NOTES.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,14 @@
# Playnite Boot Screen 0.6.2
# Playnite Boot Screen 0.7.0

This maintenance release hardens streaming foreground handling for the rare case where Playnite Fullscreen replaces its initially launched process during startup.
This feature release extends Playnite Boot Screen to Playnite's native Desktop-to-Fullscreen transition and hardens runtime updates.

Highlights:
- Detached/Continue delegates foreground permission to the preload Host before exiting;
- the Host keeps tracking Playnite if the initially launched PID is replaced during startup;
- the final Playnite window receives foreground handoff attempts immediately before and after the boot-overlay fade;
- explicit Alt+Tab/yield behavior is preserved, so the launcher does not reclaim focus after the user intentionally switches away;
- existing Prep and Detached command strings remain unchanged;
- runtime updated to 1.0.6.
- the configured boot video can cover Playnite's built-in Desktop-to-Fullscreen switch;
- the new switch integration is enabled by default and can be disabled from the extension settings;
- a lightweight on-demand black bootstrap cover bridges the Desktop closing phase to the existing WPF boot overlay, with no resident helper process;
- Playnite still owns and performs its native Desktop-to-Fullscreen transition; if the cover cannot be armed, the integration fails open and Playnite continues normally;
- the existing monitor selection, video playback, readiness detection, fade, cancellation, and foreground handling are reused for the switch path;
- managed runtime files are synchronized by content on Playnite startup, so an outdated or modified managed file is repaired even if the runtime version marker was not changed;
- runtime updated to 1.0.7.

Existing shortcuts, custom media, settings, and streaming configuration remain compatible.
Existing shortcuts, custom media, settings, and Sunshine/Apollo streaming configuration remain compatible.
8 changes: 8 additions & 0 deletions distribution/installer.yaml
Original file line number Diff line number Diff line change
@@ -1,5 +1,13 @@
AddonId: PlayniteBoot_71b5c099-3c25-4fe7-b26f-1262c7f0e138
Packages:
- Version: 0.7.0
RequiredApiVersion: 6.16.0
ReleaseDate: 2026-09-11
PackageUrl: https://github.com/VirtualGIT20/Playnite-Boot-Screen/releases/download/v0.7.0/Playnite-Boot-Screen-v0.7.0.pext
Changelog:
- Show the configured boot screen during Playnite's native Desktop-to-Fullscreen transition.
- Add a lightweight on-demand handoff cover with a safe fail-open fallback and no resident helper.
- Synchronize managed runtime files by content so updates no longer depend only on the runtime version marker.
- Version: 0.6.2
RequiredApiVersion: 6.16.0
ReleaseDate: 2026-09-02
Expand Down
17 changes: 12 additions & 5 deletions docs/RELEASE_CHECKLIST.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Release checklist — 0.6.1
# Release checklist — 0.7.0

## Code and behavior

Expand All @@ -7,6 +7,10 @@
- [ ] Settings save and cancel correctly.
- [ ] Direct cold launch succeeds.
- [ ] Launch while Playnite Desktop is already open switches to Fullscreen successfully.
- [ ] Playnite's built-in Desktop → Fullscreen command shows the configured boot screen when the new option is enabled.
- [ ] Fullscreen → Desktop → Fullscreen can be repeated and the boot transition still works.
- [ ] Disabling the Desktop → Fullscreen option leaves Playnite's native switch untouched.
- [ ] Normal Playnite Desktop exit does not trigger the switch overlay.
- [ ] Wait-for-video-end mode succeeds.
- [ ] Alt+F4 closes the overlay and stops the Playnite Fullscreen process started by the boot sequence.
- [ ] Alt+F4 during Preload prevents a later Continue command from using the standalone fallback.
Expand All @@ -22,6 +26,7 @@
- [ ] Desktop and Start shortcuts can be created, renamed, and removed.
- [ ] Invalid or modified shortcut state cannot escape the Desktop or Start menu directories.
- [ ] Runtime log rotates to `PlayniteBoot.log.1` after 2 MiB.
- [ ] With `VERSION.txt` unchanged at `1.0.7`, modifying a managed installed runtime file is repaired automatically on the next Playnite start.

## Display matrix

Expand All @@ -33,24 +38,26 @@

## Packaging

- [ ] `scripts/verify-release.ps1 -Version 0.6.1` succeeds.
- [ ] `scripts/verify-release.ps1 -Version 0.7.0` succeeds.
- [ ] `scripts/pack.ps1 -Configuration Release` creates exactly one expected `.pext`.
- [ ] Build output and `.pext` both contain `RuntimeTemplate\SwitchBootstrap.ps1`.
- [ ] Build and package contain no `.pdb`, source, temporary, or stale files.
- [ ] SHA-256 file matches the package.
- [ ] The `.pext` installs on a clean Playnite profile.
- [ ] The `.pext` installs over the maintainer's local development installation without losing settings or custom media.
- [ ] Updating an existing installation synchronizes managed runtime files and preserves custom media/configuration.

## GitHub

- [ ] Repository description, topics, and license are set.
- [ ] Private vulnerability reporting is enabled.
- [ ] CI workflow succeeds.
- [ ] Tag `v0.6.1` creates a release with `.pext` and checksum.
- [ ] Release notes describe the streaming foreground fix and confirm that existing Prep/Detached command strings remain valid.
- [ ] Tag `v0.7.0` creates a release with `.pext` and checksum.
- [ ] Release notes describe the Desktop → Fullscreen transition, fail-open behavior, and content-aware runtime synchronization.

## Playnite add-on database

- [ ] GitHub release asset URL is live.
- [ ] `distribution/installer.yaml` verifies with Toolbox.
- [ ] `distribution/addon.yaml` verifies with Toolbox.
- [ ] Published store entry resolves `distribution/installer.yaml` and exposes version `0.6.1`; no database pull request is needed unless central metadata changes.
- [ ] Published store entry resolves `distribution/installer.yaml` and exposes version `0.7.0`; no database pull request is needed unless central metadata changes.
2 changes: 1 addition & 1 deletion docs/RELEASING.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Update all version references:

- `PlayniteBoot/extension.yaml`
- `PlayniteBoot/Properties/AssemblyInfo.cs`
- `PlayniteBoot/RuntimeTemplate/VERSION.txt` only when managed runtime files change
- `PlayniteBoot/RuntimeTemplate/VERSION.txt` when managed runtime files change (diagnostic metadata; managed files are synchronized by content)
- `CHANGELOG.md`
- `RELEASE_NOTES.md`
- `distribution/installer.yaml`
Expand Down
1 change: 1 addition & 0 deletions scripts/pack.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,7 @@ $requiredFiles = @(
'Localization\en_US.xaml',
'Localization\it_IT.xaml',
'RuntimeTemplate\PlayniteBoot.ps1',
'RuntimeTemplate\SwitchBootstrap.ps1',
'RuntimeTemplate\Launch-PlayniteBoot.vbs',
'RuntimeTemplate\Install-Shortcut.ps1',
'RuntimeTemplate\Test-Configuration.ps1',
Expand Down
21 changes: 21 additions & 0 deletions scripts/verify-source.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -87,6 +87,27 @@ if ($failedRuntimeBehaviorChecks.Count -gt 0) {
throw 'Required runtime behavior is missing from the runtime script.'
}

Write-Host 'Checking Desktop-to-Fullscreen integration...'
$switchBootstrapPath = Join-Path $root 'PlayniteBoot\RuntimeTemplate\SwitchBootstrap.ps1'
$switchServicePath = Join-Path $root 'PlayniteBoot\Services\DesktopFullscreenSwitchService.cs'
$runtimeInstallerPath = Join-Path $root 'PlayniteBoot\Services\RuntimeInstaller.cs'
foreach ($requiredPath in @($switchBootstrapPath, $switchServicePath, $runtimeInstallerPath)) {
if (-not (Test-Path -LiteralPath $requiredPath -PathType Leaf)) {
throw "Required Desktop-to-Fullscreen integration file not found: $requiredPath"
}
}
$switchBootstrapSource = Get-Content -LiteralPath $switchBootstrapPath -Raw -Encoding UTF8
$switchServiceSource = Get-Content -LiteralPath $switchServicePath -Raw -Encoding UTF8
$runtimeInstallerSource = Get-Content -LiteralPath $runtimeInstallerPath -Raw -Encoding UTF8
if ($runtimeScript -notmatch "ValidateSet\('Standalone', 'Preload', 'Continue', 'Host', 'Switch'\)" -or
$runtimeScript -notmatch 'SwitchBootstrapActive' -or
$switchBootstrapSource -notmatch 'SwitchBootstrapActive' -or
$switchServiceSource -notmatch 'SwitchToFullscreenMode' -or
$runtimeInstallerSource -notmatch 'FilesHaveSameContent' -or
$runtimeInstallerSource -notmatch 'SwitchBootstrap\.ps1') {
throw 'Desktop-to-Fullscreen integration or content-aware runtime synchronization is incomplete.'
}
Write-Host 'Desktop-to-Fullscreen integration: OK'
Write-Host 'Checking managed video library integration...'
$videoLibraryPath = Join-Path $root 'PlayniteBoot\Services\VideoLibraryService.cs'
$configWriterPath = Join-Path $root 'PlayniteBoot\Services\RuntimeConfigWriter.cs'
Expand Down