The Vega Seek Bar Sample App demonstrates how to implement advanced seek bar functionality for TV apps with comprehensive examples and TV-optimized interactions.
Key features
- Basic playback controls for tracking video progress.
- Advanced seek bar features with trickplay images, Live TV support, and dynamic seeking limits.
- Seeking controls for fast forward, rewind, and long press.
- Visual markers for advertising and video segments.
- Optimized TV remote control navigation for seeking.
- Custom disabling configurations.
- Speed acceleration and skip controls.
Note: Although this app contains recommendations, you can take different approaches to building components, screens, or using libraries. This guide serves as a starting point, but we encourage you to explore and adopt best practices that suit your specific project requirements.
Compatibility
| Dependency | Version |
|---|---|
| React Native | 0.83.0 |
| React | 19.2.0 |
| Kepler UI Components | 3.1.0+ |
| React Native Kepler | 4.0.0 |
| React Navigation | 8.0.x |
| Node.js | 22.14+ |
| Vega SDK | 2.0+ |
| Vega OS | 2.0+ |
Heads up:
maintargets Vega OS 2.0 (Vega SDK 2.0). Older Vega branches target OS 1.2. Check the branch you're on before you build, because the Vega SDK and OS versions must match.
| Branch | React Native | Vega OS | Use when |
|---|---|---|---|
main |
0.83 | 2.0 (min and target in manifest) |
You're building for Vega OS 2.0 (the default) |
release-rn-83 |
0.83 | 1.2 (min and target in manifest) |
You need Vega OS 1.2 with React Native 0.83 |
release-rn-72 |
0.72 | Not set in manifest | You need the older React Native 0.72 setup |
Before you launch the sample app, make sure that you have:
- Vega Developer Tools (Vega SDK 2.0+)
- Python v3.x
- Java Runtime Environment v21 or later
- NodeJS v22.14 or later
Note: Building this app requires Vega SDK 2.0 or later. The app targets Vega OS 2.0 (min and target in the [os.version] section of manifest.toml). To support OS 1.2 devices, you can set min = "1.2", but then guard any API added after OS 1.2. See Target OS versions.
Check the branch first.
mainneeds Vega SDK 2.0. Install a 2.0.x SDK and set it as the default withvega sdk use <version>(Vega 2.0 Get Started guide). Other branches target an older OS. See Branches, and confirm with[os.version]inmanifest.toml.
After you download the source code from GitHub, you can build the Vega Seek Bar Sample App from the command line to generate VPKG files. The VPKG files run on the Vega Virtual Device and Vega OS Fire TV Stick.
You can also use Vega Studio with Visual Studio Code to build the app.
-
At the command prompt, navigate to the Vega Seek Bar Sample App source code directory.
-
To install the app dependencies, run the following command. The installation can take several minutes to complete.
npm install -
To build the app to generate .vpkg files, run the following command.
npm run build:app -
At the command prompt, in the build folder, verify that you generated the VPKG files for your device's architecture.
- armv7-release/vegaseekbarapp_armv7.vpkg—generated on x86_64 and Mac M-series devices to run on the Vega OS Fire TV Stick.
- x86_64-release/vegaseekbarapp_x86_64.vpkg—generated on an x86_64 device to run on the VVD.
- aarch64-release/vegaseekbarapp_aarch64.vpkg—generated on a Mac M-series device to run on the VVD.
-
To start the Vega Virtual Device, at the command prompt, run the following command.
vega virtual-device start -
To install and launch the app on the Vega Virtual Device, run the following command, depending on your device architecture.
-
On Mac M-series-based devices.
vega run-app build/aarch64-release/vegaseekbarapp_aarch64.vpkg -
On x86_64-based devices.
vega run-app build/x86_64-release/vegaseekbarapp_x86_64.vpkg
-
-
Turn on your Vega OS Fire TV Stick.
-
To install and launch the app on your Vega OS Fire TV Stick, run the following command.
vega run-app build/armv7-release/vegaseekbarapp_armv7.vpkg
The app includes comprehensive seek bar examples accessible from the home screen. Each example corresponds to a complete implementation in the src/screens folder, providing ready-to-use code snippets that you can integrate into your own apps.
-
Basic usage—Simple SeekBar with essential navigation and styling, demonstrating fundamental implementation with custom thumb icons and TV-optimized focus management.
-
Markers—SeekBar with custom tick marks and positioning, showing how to add visual markers and arrow indicators for precise positioning.
-
Break Markers & Segments—Advanced marker system with break points, segment coloring, and smooth animations for content with ad breaks or chapters.
-
Seeking Limits—SeekBar with restricted upper and lower limits to restrict user navigation within specific time ranges.
-
Long Press—Progressive speed acceleration on button hold using D-pad buttons with configurable acceleration intervals and multipliers.
-
Fast Forward / Rewind—Skip controls with visual feedback labels implementing fast forward and rewind functionality with speed indicators.
-
Thumbnail Images—Video preview images during seek interactions with custom labels and formatting for enhanced user experience.
-
Custom Disabling Configuration—Granular control over interaction types and states with selective enabling/disabling of controls based on focus state.
-
Live TV—Dynamic limits for live streaming content with real-time updates and live point indicators.
-
Advanced Usage—Comprehensive example showcasing all SeekBar features including thumbnails, markers, animations, and complete event handling.
If you encounter unexpected issues when you build and run the app (for example, the build fails randomly, the app doesn't start, or the app crashes randomly), try the following solutions:
-
To remove the node_modules folder, the package-lock.json file and other files related to your previous builds, run the following command.
npm run clean -
To clear the cache when you work in debug mode, run the following command.
npm run start -- --reset-cache
All screenshots, images, and icons in the ./docs/images/, ./src/assets/ directories were created internally by Amazon and are included under the same license as this project.
See LICENSE file.
- Targets Vega OS 2.0 and requires Vega SDK 2.0.
- Updated the
@amazon-devices/*dependency ranges for OS 2.0.
Migrated to React Native 0.83 and Vega SDK 0.24.
Platform Updates
- React Native 0.83—Upgraded from 0.72 with React 19, new Yoga layout engine, and updated TV focus system.
- React Navigation 8—Upgraded from v7, with React Native Screens v3.
- Kepler UI Components 3.1—Upgraded from v2, with updated SeekBar API.
- Node.js 22.14+—Required by the new toolchain (previously v18-v20).
- Build command—
build-keplerreplaced bybuild-vega.
Migration Notes
Pressablefrom@amazon-devices/react-native-keplernow requiresdisabled !== trueto be focusable. Components usingpartialDisablingConfigurationwithselect: !focusedshould be reviewed.TouchableOpacityrequiresonPress(oronPressIn/onPressOut) to participate in TV focus traversal.- Default
borderColoris now'black'instead of transparent—add explicitborderColor: 'transparent'where borders are used only for focus state styling. react-linear-gradientreplaced by nativeexperimental_backgroundImagestyle prop.
Welcome to the first release of the Vega Seek Bar Sample App! This sample app provides you with everything needed to implement professional-grade seek bar functionality in Fire TV apps.
Core Features
- 10 Complete Seek Bar Examples—From basic usage to advanced implementations with live TV support.
- TV-First Design—Built specifically for Fire TV with optimized remote control interactions and focus management.
- Production-Ready Components—Professional seek bar implementations ready for integration into your apps.
Example Library
- Basic Usage—Basic seek bar with essential controls.
- Visual Markers—Custom tick marks and positioning indicators.
- Break Markers & Segments—Advanced marker system with animations and segment coloring.
- Seeking Limits—Limit restrictions for controlled navigation.
- Long Press Controls—Progressive speed acceleration with configurable intervals.
- Fast Forward/Rewind—Skip functionality with visual feedback.
- Thumbnail Previews—Video frame thumbnails during seeking.
- Custom Disabling—Detailed control over interaction states.
- Live TV Support—Dynamic limits for streaming content.
- Advanced Integration—Complete feature showcase with professional implementation control over interaction states.










