Building videos using GitHub actions
For users that want to keep video scripts and assets on GitHub, we support directly building videos using GitHub actions.
Getting your API Key
To use the GitHub action, you will need a Narakeet API key.
For information on how to get a key, check out our guide on Managing API Keys.
We strongly suggest storing your API key as an encrypted secret
Configuring the GitHub action
Use the action narakeet/build-video-github-action
step with the following three parameters:
source-path
: the path to the main video script file in your repositoryapi-key
: your API key.github-token
: set to$
(GitHub will automatically assign it)
The action has two outputs:
video-file
: the resulting video file, ready for uploading to GitHub action artifacts or further processing.video-url
: Temporary secure (signed) video URL - valid for 10 minutes - which can be used to download the video.
An example
The following workflow will generate a video and upload it to the workflow artifacts. You can then pass it on to the next action, or download directly from the workflow artifact page.
name: Make videos
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: narakeet/build-video-github-action@v1.0.3
id: video
with:
source-path: hello-world/script/script.md
github-token: $
api-key: $
- uses: actions/upload-artifact@v1
with:
name: video
path: "$"
More information
- For general API limitations and pricing, see Automating video production.
- For more information on the GitHub action, check out the Narakeet GitHub action page on GitHub Marketplace.
- For more information on GitHub Actions workflow artifacts, see Persisting Workflow Data from GitHib action documentation.