Splash screen animation ignores COUNT parameter in desc.txt — always loops infinitely


:backhand_index_pointing_right: Bug Description

We’re trying to have a non-repeating splash screen frames and updating the desc.txt in the splashScreenManager zip file to c 1 0 _loop is not respected and loops multiple times


1. Summary

Provide a brief description of the bug in the SDK and its impact on app functionality.

App Name: Philo
App Link on Amazon Appstore (found through Developer Console → Actions column in App List → View on Amazon.com): Philo: Live TV, Movies, Shows and Free Channels - App on Amazon Appstore

Bug Severity
Select one that applies

  • Impacts operation of app
  • Blocks current development
  • Improvement suggestion
  • Issue with documentation (If selected, please share the doc link and describe the issue)
  • Other

2. Steps to Reproduce

  1. update the splashScreen Manager with a zip file with the desc.txt using
1920 1080 24
c 1 0 _loop
  1. build and start the app

3. Observed Behavior

The Splash screen frames runs once completely and starts over a second time, the app starts in the middle of the second loop

4. Expected Behavior

Describe what you expected the SDK to do under normal operation.

The App splash screen should play exactly 1 time and hold the last frame until the app starts

4.a Possible Root Cause & Temporary Workaround

Fill out anything you have tried. If you don’t know, N/A is acceptable

  Also tested (not supported):
  - Multi-part desc.txt (p 1 0 _anim + c 0 0 _hold) — caused frantic flickering, Vega does not appear to support multiple animation parts
  - PAUSE parameter (e.g., c 0 200 _loop) — no effect, as documented

  Splash screen dismissal:
  Using usePreventHideSplashScreen() and useHideSplashScreenCallback() — dismissal works correctly. The issue is solely that the animation cannot be configured to play only once before being dismissed.

  Workaround attempted:
  Adding duplicate hold frames (copies of the final frame) to extend the cycle duration. This partially works but increases bundle size and decode time, and the loop count still varies with app load time.

5. Logs or crash report

N / A 

6. Environment

Please fill out the fields related to your bug below:

  • **SDK Version:0.22.6620
  • App State: Foreground
  • OS Information:

NAME=“OS”
OE_VERSION=“4.0.0”
OS_MAJOR_VERSION=“1”
OS_MINOR_VERSION=“2”
RELEASE_ID=“21”
OS_VERSION=“1.2”
BRANCH_CODE=“TV Ship”
BUILD_DESC=“OS 1.2 (TV Ship/547)”
BUILD_FINGERPRINT=“4.0.378951.0(3072cab629675a74)/547N:user/release-keys”
BUILD_VARIANT=“user”
BUILD_TAGS=“release-keys”
BUILD_DATE=“Tue Jul 14 08:13:13 UTC 2026”
BUILD_TIMESTAMP=“1784016793”
VERSION_NUMBER=“2101020054720”


## 👉 Additional Context

---

**Any Additional Context you would like to provide?**
*Add any other relevant information, such as recent updates to the SDK, dependencies, or device OS that may affect the bug.*

Saw the same bug here https://community.amazondeveloper.com/t/splashscreen-loop-without-repeat/5150

Hi @Tony,

Thank you for the detailed bug report on the splash screen animation loop issue.

I’ll check with our team on whether finite loop counts are supported for the splash screen desc.txt configuration.

In the meantime, the documented approach is to use c 0 0 _loop (infinite loop) and control splash screen dismissal programmatically using usePreventHideSplashScreen() and useHideSplashScreenCallback() to dismiss the splash screen when needed.

For reference: SplashScreenManager | React Native Vega Reference

Thanks for helping us improve the Vega platform.

Warm regards,
Aishwarya