Before you continue
Before submitting a bug report, please review our troubleshooting documentation at https://developer.amazon.com/docs/kepler-tv/troubleshoot-overview.html.
If you still want to file a bug report, please make sure to fill in all the details below and provide the necessary information.
NOTE: PLEASE ONLY REPORT A SINGLE BUG USING THIS TEMPLATE.
If you’re experiencing multiple issues, please file a separate report for each.
Bug Description
1. Summary
When adding recommendations to the RecommendationManager2.addRecommendations (same behaviour with RecommendationManager2.addRecommendations2) I get the error:
crashed with signal 6
App Name: ITVX
App Link on Amazon Appstore (found through Developer Console → Actions column in App List → View on Amazon.com): ITVX - 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
Add correct data to RecommendationsManager2.addRecommendations
3. Observed Behavior
Explain what actually happened, noting any discrepancies or malfunctions.
<!-- Answer here -->
The task crashes
4. Expected Behavior
Describe what you expected the SDK to do under normal operation.
<!-- Answer here -->
The task adds the recommendations
4.a Possible Root Cause & Temporary Workaround
Fill out anything you have tried. If you don’t know, N/A is acceptable
<!-- Answer here -->
N/A
5. Logs or crash report
(Please make sure to provide relevant logs as attachment and share VPKG file with your Amazon contact)
For crash issues, please refer this guide for faster troubleshooting: https://developer.amazon.com/docs/kepler-tv/detect-crash.html.
-
For issues with Kepler Studio Extension, please share log files from below folders:
Sep 10 13:14:22.761300 firestick-03553f51479a3613 local0.info *******[8487]: 4056721320 INFO com.amazon.keplerscript: [KeplerScript-JavaScript] PMR task starting... Sep 10 13:14:22.801761 firestick-03553f51479a3613 local0.info *******[8487]: 4056721320 INFO com.amazon.keplerscript: [KeplerScript-Native] [AutoLinkService] Successfully v1 auto-linked libkeplerscript-async-storage-lib-2.so.2 Sep 10 13:14:22.815874 firestick-03553f51479a3613 local0.info *******[8487]: 4056721320 INFO com.amazon.keplerscript: [KeplerScript-Native] [AutoLinkService] Successfully v2 auto-linked libkeplerscript-kepler-media-account-login-lib-1.so.1 Sep 10 13:14:22.857709 firestick-03553f51479a3613 local0.info *******[8487]: 4056721320 INFO com.amazon.keplerscript: [KeplerScript-Native] [AutoLinkService] Successfully v2 auto-linked libRecommendationManagerTurboModule.so Sep 10 13:14:22.905644 firestick-03553f51479a3613 local0.info *******[8487]: 4056721320 INFO com.amazon.keplerscript: [KeplerScript-Native] [AutoLinkService] Successfully v2 auto-linked libRecommendationManagerTurboModule.so Sep 10 13:14:23.120067 firestick-03553f51479a3613 local0.info lcm_service[977]: 977 I lcm-server:[Lcm.cpp:6559] Service Update - com.amazon.recommendation.service.main(pid=7904), client *******(pid=8487): 0 Sep 10 13:14:23.155761 firestick-03553f51479a3613 local0.info *******[8487]: 4056721320 INFO com.amazon.keplerscript: [KeplerScript-JavaScript] 'login status', true Sep 10 13:14:23.166807 firestick-03553f51479a3613 local0.info *******[8487]: 4056721320 INFO com.amazon.keplerscript: [KeplerScript-JavaScript] 'Loading PMR recommendations...' Sep 10 13:14:23.725064 firestick-03553f51479a3613 local0.info *******[8487]: 4056721320 INFO com.amazon.keplerscript: [KeplerScript-JavaScript] 'Fetched data:', 1 Sep 10 13:14:31.137336 firestick-03553f51479a3613 local0.warning lcm_service[977]: 1458 W resmgr-pss-logger:[AppPssLogger.cpp:792] rm_pss : [pid(8487), appName(*******), type(T), state(0), pss(50013kb), uss(43192kb), swapPss(0kb), mjrPgFlt(0), ion(0kb), drm(0kb), memBudgetOffset(0), pcpu(19.6%), cpuBudget(0%)] Sep 10 13:14:31.138259 firestick-03553f51479a3613 local0.info lcm_service[977]: 1458 I resmgr-pss-logger:[AppPssLogger.cpp:696] ******* app resource pss vital metric reported Sep 10 13:14:31.138483 firestick-03553f51479a3613 local0.info lcm_service[977]: 1458 I resmgr-pss-logger:[AppPssLogger.cpp:711] ******* app resource cpu vital metric reported Sep 10 13:14:32.221340 firestick-03553f51479a3613 local0.info ITVMobilePlayer[8487]: 4056721320 INFO com.amazon.keplerscript: [KeplerScript-JavaScript] 'Adding recommendations to Recommendation Manager...', 19 Sep 10 13:14:38.295680 firestick-03553f51479a3613 local1.info acr_core_dump[8600]: Process '*******' (PID=8487) crashed with signal 6 Sep 10 13:14:38.295906 firestick-03553f51479a3613 local1.err acr_core_dump[8600]: Cannot find library name for process ******* Sep 10 13:14:38.591297 firestick-03553f51479a3613 local0.err lcm_service[977]: 977 E lcm-server:[Lcm.cpp:4749] Deregistering application with clientPid 8487 and package id ******* after crash
6. Environment
Please fill out the fields related to your bug below:
-
SDK Version: 0.20.3443
-
App State:
Is a task (the app can be closed)
-
OS Information
Please ssh into the device viakepler exec vda shell
and copy the output fromcat /etc/os-release
into the answer section below. Note, if you don’t have a simulator running or device attachedkepler exec vda shell
will respond withvda: no devices/emulators found
NAME="OS" OE_VERSION="4.0.0" OS_MAJOR_VERSION="1" OS_MINOR_VERSION="1" RELEASE_ID="2" OS_VERSION="1.1" BRANCH_CODE="VegaMainlineTvIntegration" BUILD_DESC="OS 1.1 (VegaMainlineTvIntegration/4418)" BUILD_FINGERPRINT="4.0.155683.0(3072cab629675a74)/4418N:user-external/release-keys" BUILD_VARIANT="user-external" BUILD_TAGS="release-keys" BUILD_DATE="Wed Sep 03 05:40:19 UTC 2025" BUILD_TIMESTAMP="1756878019" VERSION_NUMBER="201010441850"
7. Example Code Snippet / Screenshots / Screengrabs
Include any relevant code or component setup in React Native that can help reproduce the bug.
import { RecommendationManager2, Category, DisplayAction, InvalidArgumentError, SecurityError } from '@amzn/recommendation-manager';
import type { Recommendation2 } from '@amzn/recommendation-manager';
import { PMR_URL, query, contentUri, contentImageUri, backgroundImageUri } from '../../constants/pmr';
import { getLoginStatus } from '../../services/AccountLoginWrapper';
import { encodeTrimmedQuery } from '../../utils/strings';
const setRecommendations = async (items: any) => {
const recommendations: Recommendation2[] = items.map(({ titleItem }: any) => {
const recommendation = {
title: 'Recommended film',
text: 'Check out this great film!',
contentImageUri: contentImageUri,
backgroundImageUri: backgroundImageUri,
contentUri: contentUri,
category: Category.HOME,
displayName: 'ITVX',
displayActionOption: DisplayAction.WATCH_WITH_APP_DISPLAY_NAME,
maturityRating: 'BBFCPG',
customerAggregateRating: Math.floor(Math.random() * 10) + 1,
customerRatingCount: Math.floor(Math.random() * 1000) + 1,
runningTime: 90 + Math.floor(Math.random() * 60),
releaseYear: Math.floor(Math.random() * (2024 - 1980 + 1)) + 1980,
isCaptionAvailable: true
};
console.log('Prepared recommendation:', JSON.stringify(recommendation));
return recommendation;
});
try {
console.log('Adding recommendations to Recommendation Manager...', recommendations.length);
const addedIds = RecommendationManager2.addRecommendations2(recommendations);
console.log('Added recommendations:', addedIds);
return addedIds;
} catch (error) {
if (error instanceof SecurityError) {
console.error('Security error:', error.message);
} else if (error instanceof InvalidArgumentError) {
console.error('Invalid argument error:', error.message, JSON.stringify(error));
} else {
console.error('Error adding recommendations:', error);
}
throw error;
}
};
const loadRecommendations = async (): Promise<number[] | undefined> => {
const urlToFetch = `${PMR_URL}?query=${encodeTrimmedQuery(query)}`;
console.log('Loading PMR recommendations...', urlToFetch);
try {
const res = await fetch(urlToFetch, {
method: 'GET'
});
const data = await res.json();
console.log('Fetched data:', data.data.collections?.length);
if (data.data?.collections?.length) {
return setRecommendations(data.data.collections[0].items);
}
} catch (error: any) {
console.error('Error fetching PMR data:', error);
}
};
const doTask = async (): Promise<void> => {
console.log('PMR task starting...');
const loginStatus = await getLoginStatus();
RecommendationManager2.removeAllRecommendations();
console.log('login status', loginStatus);
if (loginStatus) {
try {
await loadRecommendations();
} catch (error) {
console.error('Error loading recommendations:', error);
return Promise.reject(error);
}
}
console.log('PMR task completed successfully!.');
return Promise.resolve();
};
export default doTask;
Playback Issues
If this is a playback issue, please provide your VPKG and/or content URL, any pre-conditions (like geo-location) [Share privately with your Amazon contact] , and let us know if it’s x86 or arm7.
<!-- Describe your playback issue if applicable -->
Please share the following details in addition:_
- Player SDK:
[Bitmovin, Shaka, ...]
- Player SDK Version:
[e.g. 1.23]
- Audio Codecs:
[AAC, ...]
- Video Codecs:
[h.264, mp4]
- Manifest Types:
[m3u8, dash, etc ..]
- Audio Codecs:
Q: Would you like to be contacted to share your latest VPKG compiled with latest SDK:
[Y/N] [Share privately with your Amazon contact]
Q: VPN or Login needed to verify functionality in VPKG?
[Y/N] [Share privately with your Amazon contact]
Q: If applicable, please provide your media/content url
If this is created dynamically, tokenized, etc please provide a way for us to access it
[N/A or Content / Media Url for testing] [Share privately with your Amazon contact]
Q: Are there any special headers required to reproduce the issue you are facing?
[N/A or Insert Headers]
Additionally please provide the following if possible
Provide Screenshots / Screengrabs / Logs. Please include as much information as you can that will help debug.
<!-- Answer here if applicable -->
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.
<!-- Answer here if applicable -->