{"id":10086,"date":"2022-06-21T09:10:47","date_gmt":"2022-06-21T09:10:47","guid":{"rendered":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/documentation\/rdk_video_documentation\/components\/open-sourced_components\/advanced_adaptive_media_player_aamp\/aamp_simulator_build_linux_instructions\/"},"modified":"2025-03-25T05:18:35","modified_gmt":"2025-03-25T05:18:35","slug":"aamp_simulator_build_linux_instructions","status":"publish","type":"page","link":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/aamp_simulator_build_linux_instructions\/","title":{"rendered":"AAMP Simulator Build (Linux) Instructions"},"content":{"rendered":"\n

Dependencies\/Pre-requisites<\/h3>

a) CMake, uuid and SSL:<\/h5>
\n
sudo apt-get update\nsudo apt-get -y install cmake\nsudo apt-get -y install uuid-dev\nsudo apt-get -y install libssl-dev<\/pre>\n<\/div><\/div>
b) Gstreamer:<\/h5>
Below gstreamer packages with version = 1.16.2 are required (hard dependency on gst version is due to the prebuilt qtdemux library provided)<\/p>
\n
sudo apt-get -y install libgstreamer1.0-dev\nsudo apt-get -y install libgstreamer-plugins-base1.0-dev\nsudo apt-get -y install libgstreamer-plugins-good1.0-dev\nsudo apt-get -y install libgstreamer-plugins-bad1.0-dev\nsudo apt-get -y install gstreamer1.0-libav\nsudo apt-get -y install gstreamer1.0-tools<\/pre>\n<\/div><\/div>

c) Git, XML and Curl<\/p>
\n
sudo apt-get -y install git\nsudo apt-get -y install libxml2-dev\nsudo apt-get -y install libcurl4-openssl-dev<\/pre>\n<\/div><\/div>

<\/p>
1.Clone aamp and dependent components in a new directory<\/p>
\n
git clone -b dev_sprint https:\/\/code.rdkcentral.com\/r\/rdk\/components\/generic\/aamp\ngit clone -b dev_sprint https:\/\/code.rdkcentral.com\/r\/rdk\/components\/generic\/aampabr\ngit clone -b dev_sprint https:\/\/code.rdkcentral.com\/r\/rdk\/components\/generic\/gst-plugins-rdk-aamp\ngit clone -b dev_sprint https:\/\/code.rdkcentral.com\/r\/rdk\/components\/generic\/aampmetrics\ngit clone git:\/\/github.com\/DaveGamble\/cJSON.git<\/pre>\n<\/div><\/div>
2. Build the components in the following order –
a) aampabr<\/p>
\n
cd aampabr\nmkdir build\ncd build\ncmake ..\/ -DCMAKE_BUILD_TYPE=Debug\nmake\nsudo make install\ncd ..\/..<\/pre>\n<\/div><\/div>
b) cJSON<\/p>
\n
cd cJSON\nmkdir build\ncd build\ncmake ..\/\nmake\nsudo make install\ncd ..\/..<\/pre>\n<\/div><\/div>
c) aampmetrics:<\/p>
\n
cd aampmetrics\nmkdir build\ncd build\ncmake ..\/ -DCMAKE_BUILD_TYPE=Debug\nmake\nsudo make install\ncd ..\/..<\/pre>\n<\/div><\/div>
d) libdash<\/p>
For Ubuntu, reference <\/span>https:\/\/github.com\/bitmovin\/libdash#ubuntu-1204<\/a><\/p>
\n
git clone git:\/\/github.com\/bitmovin\/libdash.git\ncd libdash\/libdash\ngit checkout stable_3_0<\/pre>\n<\/div><\/div>
Apply patches downloaded from (patch -p1 < file.patch): https:\/\/code.rdkcentral.com\/r\/plugins\/gitiles\/components\/generic\/rdk-oe\/meta-rdk-ext\/+\/rdk-next\/recipes-multimedia\/libdash\/libdash\/<\/a><\/p>
\n
mkdir build\ncd build\ncmake ..\nmake\nsudo make install<\/pre>\n<\/div><\/div>
Install:<\/p>
\n
cp bin\/libdash.so \/usr\/local\/lib\/\nsudo mkdir -p \/usr\/local\/include\nsudo mkdir -p \/usr\/local\/include\/libdash\nsudo mkdir -p \/usr\/local\/include\/libdash\/xml\nsudo mkdir -p \/usr\/local\/include\/libdash\/mpd\nsudo mkdir -p \/usr\/local\/include\/libdash\/helpers\nsudo mkdir -p \/usr\/local\/include\/libdash\/network\nsudo mkdir -p \/usr\/local\/include\/libdash\/portable\nsudo mkdir -p \/usr\/local\/include\/libdash\/metrics\nsudo cp -pr ..\/libdash\/include\/*.h \/usr\/local\/include\/libdash\nsudo cp -pr ..\/libdash\/source\/xml\/*.h \/usr\/local\/include\/libdash\/xml\nsudo cp -pr ..\/libdash\/source\/mpd\/*.h \/usr\/local\/include\/libdash\/mpd\nsudo cp -pr ..\/libdash\/source\/network\/*.h \/usr\/local\/include\/libdash\/network\nsudo cp -pr ..\/libdash\/source\/portable\/*.h \/usr\/local\/include\/libdash\/portable\nsudo cp -pr ..\/libdash\/source\/helpers\/*.h \/usr\/local\/include\/libdash\/helpers\nsudo cp -pr ..\/libdash\/source\/metrics\/*.h \/usr\/local\/include\/libdash\/metrics\n\necho -e 'prefix=\/usr\/local nexec_prefix=${prefix} nlibdir=${exec_prefix}\/lib nincludedir=${prefix}\/include\/libdash n nName: libdash nDescription: ISO\/IEC MPEG-DASH library nVersion: 3.0 nRequires: libxml-2.0 nLibs: -L${libdir} -ldash nLibs.private: -lxml2 nCflags: -I${includedir}' > libdash.pc\nsudo mv libdash.pc \/usr\/lib\/pkgconfig\/.\n\ncd ..\/..\/..\n(OR)\n\ncd aamp\n.\/install_libdash.sh<\/pre>\n<\/div><\/div>
e) aamp:<\/p>
\n
cd aamp\nmkdir build\ncd build\ncmake ..\/ -DCMAKE_BUILD_TYPE=Debug -DCMAKE_PLATFORM_UBUNTU=1\nmake\nsudo make install\ncd ..\/..\/<\/pre>\n<\/div><\/div>
f) gst-plugins-rdk-aamp:<\/p>
\n
cd gst-plugins-rdk-aamp\nmkdir build\ncd build\ncmake ..\/ -DCMAKE_BUILD_TYPE=Debug\nmake\nsudo make install\ncd ..\/..\/<\/pre>\n<\/div><\/div>
3. Copy the prebuilt qtdemux library with AAMP patches. Prebuilt qtdemux library is available in tar file attached to this doc – <\/p>
override-libs.tgz<\/a>Download<\/a><\/div>

Run the following commands in a new folder
\n
tar -xzf override_libs.tgz<\/pre>\n<\/div><\/div>

Update the environment variable with the new location so that custom qtdemux plugin will be picked<\/pre>
\n
export GST_PLUGIN_PATH=`pwd`\/override-libs:$GST_PLUGIN_PATH<\/pre>\n<\/div><\/div>
To verify, run gst-inspect-1.0 qtdemux and confirm the Filename value under Plugin Details is same as the override library location

4. optionally create \/opt\/aamp.cfg – supports local configuration overrides<\/p>
5. Create \/opt\/aampcli.cfg with below content for a virtual channel list of assets that could be loaded in aamp-cli

*1 HOSTED_FRAGMP4 https:\/\/bitmovin-a.akamaihd.net\/content\/MI201109210084_1\/m3u8s-fmp4\/f08e80da-bf1d-4e3d-8899-f0f6155f6efa.m3u8<\/a>
*2 HOSTED_HLS http:\/\/devimages.apple.com\/iphone\/samples\/bipbop\/bipbopall.m3u8<\/a>
*3 HOSTED_DASH https:\/\/bitmovin-a.akamaihd.net\/content\/MI201109210084_1\/mpds\/f08e80da-bf1d-4e3d-8899-f0f6155f6efa.mpd<\/a><\/p>

6. Execute binaries<\/p>
\n
.\/aamp-cli \/\/ for full featured command line interface to aamp\nor\n.\/playbintest <url> \/\/ to exercise aamp as a plugin<\/pre>\n<\/div><\/div>



<\/p><\/body><\/html>\n","protected":false},"excerpt":{"rendered":"
Dependencies\/Pre-requisites a) CMake, uuid and SSL: sudo apt-get update sudo apt-get -y install cmake sudo […]<\/p>\n","protected":false},"author":28,"featured_media":0,"parent":10015,"menu_order":19,"comment_status":"open","ping_status":"closed","template":"","meta":{"_bbp_topic_count":0,"_bbp_reply_count":0,"_bbp_total_topic_count":0,"_bbp_total_reply_count":0,"_bbp_voice_count":0,"_bbp_anonymous_reply_count":0,"_bbp_topic_count_hidden":0,"_bbp_reply_count_hidden":0,"_bbp_forum_subforum_count":0,"footnotes":""},"class_list":["post-10086","page","type-page","status-publish","hentry"],"yoast_head":"\nAAMP Simulator Build (Linux) Instructions - RDK Documentation Portal | Documentation<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/aamp_simulator_build_linux_instructions\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"AAMP Simulator Build (Linux) Instructions - RDK Documentation Portal | Documentation\" \/>\n<meta property=\"og:description\" content=\"Dependencies\/Pre-requisites a) CMake, uuid and SSL: sudo apt-get update sudo apt-get -y install cmake sudo […]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/aamp_simulator_build_linux_instructions\/\" \/>\n<meta property=\"og:site_name\" content=\"RDK Documentation Portal | Documentation\" \/>\n<meta property=\"article:modified_time\" content=\"2025-03-25T05:18:35+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/aamp_simulator_build_linux_instructions\/\",\"url\":\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/aamp_simulator_build_linux_instructions\/\",\"name\":\"AAMP Simulator Build (Linux) Instructions - RDK Documentation Portal | Documentation\",\"isPartOf\":{\"@id\":\"https:\/\/developer.rdkcentral.com\/documentation\/#website\"},\"datePublished\":\"2022-06-21T09:10:47+00:00\",\"dateModified\":\"2025-03-25T05:18:35+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/aamp_simulator_build_linux_instructions\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/aamp_simulator_build_linux_instructions\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/aamp_simulator_build_linux_instructions\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/developer.rdkcentral.com\/documentation\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Documentation\",\"item\":\"https:\/\/developer.rdkcentral.com\/documentation\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"RDK Entertainment\",\"item\":\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Components\",\"item\":\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/\"},{\"@type\":\"ListItem\",\"position\":5,\"name\":\"Advanced Adaptive Media Player (AAMP)\",\"item\":\"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/\"},{\"@type\":\"ListItem\",\"position\":6,\"name\":\"AAMP Simulator Build (Linux) Instructions\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/developer.rdkcentral.com\/documentation\/#website\",\"url\":\"https:\/\/developer.rdkcentral.com\/documentation\/\",\"name\":\"RDK Documentation Portal | Documentation\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/developer.rdkcentral.com\/documentation\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"AAMP Simulator Build (Linux) Instructions - RDK Documentation Portal | Documentation","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/aamp_simulator_build_linux_instructions\/","og_locale":"en_US","og_type":"article","og_title":"AAMP Simulator Build (Linux) Instructions - RDK Documentation Portal | Documentation","og_description":"Dependencies\/Pre-requisites a) CMake, uuid and SSL: sudo apt-get update sudo apt-get -y install cmake sudo […]","og_url":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/aamp_simulator_build_linux_instructions\/","og_site_name":"RDK Documentation Portal | Documentation","article_modified_time":"2025-03-25T05:18:35+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/aamp_simulator_build_linux_instructions\/","url":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/aamp_simulator_build_linux_instructions\/","name":"AAMP Simulator Build (Linux) Instructions - RDK Documentation Portal | Documentation","isPartOf":{"@id":"https:\/\/developer.rdkcentral.com\/documentation\/#website"},"datePublished":"2022-06-21T09:10:47+00:00","dateModified":"2025-03-25T05:18:35+00:00","breadcrumb":{"@id":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/aamp_simulator_build_linux_instructions\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/aamp_simulator_build_linux_instructions\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/aamp_simulator_build_linux_instructions\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/developer.rdkcentral.com\/documentation\/"},{"@type":"ListItem","position":2,"name":"Documentation","item":"https:\/\/developer.rdkcentral.com\/documentation\/"},{"@type":"ListItem","position":3,"name":"RDK Entertainment","item":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/"},{"@type":"ListItem","position":4,"name":"Components","item":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/"},{"@type":"ListItem","position":5,"name":"Advanced Adaptive Media Player (AAMP)","item":"https:\/\/developer.rdkcentral.com\/documentation\/documentation\/rdk_video_documentation\/components\/advanced_adaptive_media_player_aamp\/"},{"@type":"ListItem","position":6,"name":"AAMP Simulator Build (Linux) Instructions"}]},{"@type":"WebSite","@id":"https:\/\/developer.rdkcentral.com\/documentation\/#website","url":"https:\/\/developer.rdkcentral.com\/documentation\/","name":"RDK Documentation Portal | Documentation","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/developer.rdkcentral.com\/documentation\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/pages\/10086","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/users\/28"}],"replies":[{"embeddable":true,"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/comments?post=10086"}],"version-history":[{"count":1,"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/pages\/10086\/revisions"}],"predecessor-version":[{"id":10088,"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/pages\/10086\/revisions\/10088"}],"up":[{"embeddable":true,"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/pages\/10015"}],"wp:attachment":[{"href":"https:\/\/developer.rdkcentral.com\/documentation\/wp-json\/wp\/v2\/media?parent=10086"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}