set_video_frame_rate
Change the frame rate of a video while preserving the audio stream. Specify input/output paths and target frame rate to adjust playback speed or compatibility.
Instructions
Sets the frame rate of a video, attempting to copy the audio stream. Args: input_video_path: Path to the source video file. output_video_path: Path to save the video with the new frame rate. frame_rate: Target video frame rate (e.g., 24, 30, 60). Returns: A status message indicating success or failure.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| frame_rate | Yes | ||
| input_video_path | Yes | ||
| output_video_path | Yes |
Implementation Reference
- server.py:413-425 (handler)The handler function that executes the set_video_frame_rate tool logic, using ffmpeg to set the video frame rate while attempting to copy the audio stream, with a fallback to re-encoding if necessary.
@mcp.tool() def set_video_frame_rate(input_video_path: str, output_video_path: str, frame_rate: int) -> str: """Sets the frame rate of a video, attempting to copy the audio stream. Args: input_video_path: Path to the source video file. output_video_path: Path to save the video with the new frame rate. frame_rate: Target video frame rate (e.g., 24, 30, 60). Returns: A status message indicating success or failure. """ primary_kwargs = {'r': frame_rate, 'acodec': 'copy'} fallback_kwargs = {'r': frame_rate} # Re-encode audio return _run_ffmpeg_with_fallback(input_video_path, output_video_path, primary_kwargs, fallback_kwargs) - server.py:332-349 (helper)Supporting helper utility function used by the set_video_frame_rate handler (and other similar tools) to execute ffmpeg operations with a primary set of parameters and a fallback set.
def _run_ffmpeg_with_fallback(input_path: str, output_path: str, primary_kwargs: dict, fallback_kwargs: dict) -> str: """Helper to run ffmpeg command with primary kwargs, falling back to other kwargs on ffmpeg.Error.""" try: ffmpeg.input(input_path).output(output_path, **primary_kwargs).run(capture_stdout=True, capture_stderr=True) return f"Operation successful (primary method) and saved to {output_path}" except ffmpeg.Error as e_primary: try: ffmpeg.input(input_path).output(output_path, **fallback_kwargs).run(capture_stdout=True, capture_stderr=True) return f"Operation successful (fallback method) and saved to {output_path}" except ffmpeg.Error as e_fallback: err_primary_msg = e_primary.stderr.decode('utf8') if e_primary.stderr else str(e_primary) err_fallback_msg = e_fallback.stderr.decode('utf8') if e_fallback.stderr else str(e_fallback) return f"Error. Primary method failed: {err_primary_msg}. Fallback method also failed: {err_fallback_msg}" except FileNotFoundError: return f"Error: Input file not found at {input_path}" except Exception as e: return f"An unexpected error occurred: {str(e)}"