Actions25
- Sound Actions
- Speech Actions
- File Actions
- Transcription Actions
- Video Actions
- Add Audio to a Video
- Add Audio with Subtitles to a Video
- Add Subtitles to a Video
- Add Subtitles to a Video From a File
- Add Watermark to a Video
- Blur a Video
- Clip a Video
- Create a Slideshow
- Crop a Video
- Extract Audio From a Video
- Frame a Video
- Generate a Video
- Get a Specific Video
- Mute a Video
- Rotate a Video
- Split a Video Into Scenes
Overview
This node integrates with the Bookoly API to add audio tracks to existing video files. It allows users to specify a video by URL and overlay an audio file from another URL, optionally muting the original video's sound or adjusting the added audio's volume and length. This is useful for enhancing videos with background music, voiceovers, or sound effects without needing manual video editing software.
Practical examples:
- Adding a podcast episode's intro music to a recorded video.
- Overlaying narration audio onto a silent video clip.
- Replacing or muting the original audio track of a video while adding new audio content.
Properties
| Name | Meaning |
|---|---|
| Name | The name to assign to the resulting video after processing. |
| Video URL | Publicly accessible and downloadable URL of the source video file to which audio will be added. |
| Mute Video | Whether to mute the original audio track of the video (true/false). |
| Audio URL | Publicly accessible and downloadable URL of the audio file to overlay on the video. |
| Trim Audio | Whether to trim the audio to match the video length if the audio is longer than the video (true/false). |
| Volume | Volume level for the added audio, from 1% to 100%, where 100% is the original volume. |
| Wait for Completion | If true, the node waits until the video processing is complete and returns full video details; otherwise, it returns only the ID and creation timestamp immediately. |
| Webhook URL | A URL to receive webhook notifications about the video processing status, including video ID and URL. |
Output
The node outputs JSON data representing the processed video object. When waiting for completion, this includes detailed information such as the final video URL, metadata, and processing status. If not waiting, it returns minimal data like the video ID and creation timestamp.
If the node supports binary output (not explicitly shown here), it would typically represent the processed video file itself or related media content.
Dependencies
- Requires access to the Bookoly API service at
https://bookoly.com/api/v1. - Needs an API authentication token configured in n8n credentials to authorize requests.
- Internet access to download the input video and audio files from their provided URLs.
- Optional: A publicly accessible webhook endpoint if webhook notifications are used.
Troubleshooting
Common issues:
- Invalid or inaccessible video/audio URLs can cause failures in downloading media.
- Muting the video but not providing an audio URL may result in silent output.
- Setting volume outside the allowed range (1-100) might cause errors.
- Not waiting for completion may lead to incomplete data if subsequent workflow steps depend on the finished video.
Error messages:
"No handler found for video.addAudioToVideo": Indicates the operation is not implemented or incorrectly referenced."Failed to execute addAudioToVideo: <error message>": General failure during processing, often due to network issues, invalid inputs, or API errors.
Resolutions:
- Verify URLs are correct and publicly accessible.
- Ensure the API key credential is valid and has necessary permissions.
- Use the "Wait for Completion" option when downstream steps require the completed video.
- Check webhook URL correctness if using webhook notifications.
Links and References
- Bookoly API Documentation (hypothetical link based on base URL)
- n8n Documentation on Creating Custom Nodes
- General guide on Working with Media Files in n8n