Package: dolbyio-rest-apis-cli
Dolby.io REST APIs Client for Python - CLICommand Line Interface utility for the dolby.io RESTCommunicationsandMediaAPIs.Install this projectCheck thedolbyio-rest-apis-clipackage on PyPI. To install the latest stable python package run the following command:python3-mpipinstalldolbyio-rest-apis-cliUpgrade your package to the latest version:python3-mpipinstall--upgradedolbyio-rest-apis-cliCommunications CommandsDisplay the help and version of the command line:communications--help
communications--versionAuthenticationGet your app key and secret from the dolby.io dashboard and run the following command to get the access token as a json payload:communicationsauth-k"APP_KEY"-s"APP_SECRET"--outputjsonAdd the flag--apito get an access token that you can use to query the REST APIs.Change the output to--output textto get a text format for the output.Use--output access_tokento retrieve only the access token so you can easily assign it to a variable:ACCESS_TOKEN=$(communicationsauth-k"APP_KEY"-s"APP_SECRET"--api--outputaccess_token2>/dev/null)RemixUsing the access token you've retrieved using theauthcommand, you can start a remix for a specific conference:communicationsremix\--access_token"ACCESS_TOKEN"\--cid"00000000-0000-0000-0000-000000000000"\--start\--outputjsonOr simply check the status of a remix:communicationsremix\--access_token"ACCESS_TOKEN"\--cid"00000000-0000-0000-0000-000000000000"\--outputjsonStreamingStart the streaming to an RTMP endpoint for a specific conference:communicationsstreaming\--access_token"ACCESS_TOKEN"\--cid"00000000-0000-0000-0000-000000000000"\--actionstart\--targetrtmp\--outputjson\--urls"rtmp://a.rtmp.youtube.com/live2/{streaming_key}"Stop the RTMP streaming for a specific conference:communicationsstreaming\--access_token"ACCESS_TOKEN"\--cid"00000000-0000-0000-0000-000000000000"\--actionstop\--targetrtmp\--outputjsonMedia CommandsDisplay the help and version of the command line:media--help
media--versionAuthenticationGet your app key and secret from the dolby.io dashboard and run the following command to get the access token as a json payload:mediaauth-k"APP_KEY"-s"APP_SECRET"--outputjsonChange the output to--output textto get a text format for the output.Use--output access_tokento retrieve only the access token so you can easily assign it to a variable:ACCESS_TOKEN=$(mediaauth-k"APP_KEY"-s"APP_SECRET"--outputaccess_token2>/dev/null)Input / OutputUpload a file to Dolby.io temporary storage:mediaio\--access_token"<ACCESS_TOKEN>"\--dlb_url"dlb://in/file.mp4"\--file"/path/to/file.mp4"\uploadDownload a file from Dolby.io temporary storage:mediaio\--access_token"<ACCESS_TOKEN>"\--dlb_url"dlb://out/processed_file.mp4"\--file"/path/to/processed_file.mp4"\downloadEnhanceStart enhancing a media:mediaenhance--access_token"<ACCESS_TOKEN>"\start\--file"/path/to/job_description.json"The result is the job identifier.Get the result from a enhancement job:mediaenhance--access_token"<ACCESS_TOKEN>"\result\--job_id"00000000-0000-0000-0000-000000000000"Music MasteringStart mastering a music:mediamastering--access_token"<ACCESS_TOKEN>"\start\--file"/path/to/job_description.json"The result is the job identifier.Get the result from a music mastering job:mediamastering--access_token"<ACCESS_TOKEN>"\result\--job_id"00000000-0000-0000-0000-000000000000"