fixes

app.py

@@ -1,3 +1,13 @@
+"""
+VideoCraft MCP Server - AI-Powered Video Editing Interface
+
+This module provides a Gradio-based web interface for the VideoCraft MCP Server,
+offering a comprehensive suite of video editing tools powered by AI and advanced processing.
+
+Each interface is designed to be intuitive and user-friendly, with clear descriptions
+and helpful tooltips to guide users through the video editing process.
+"""
+
 import gradio as gr
 import os
 from dotenv import load_dotenv
@@ -7,7 +17,6 @@ from tools.video_tools import (
     add_text_overlay,
     change_speed,
     extract_audio,
-    add_image_overlay,
     apply_color_filter,
     merge_videos,
     edit_video_segment,
@@ -48,12 +57,16 @@ demo = gr.TabbedInterface(
             ),
             title="File Upload",
             description="""
-            **Upload your media files to get started**
+            **Start Your Video Editing Journey Here! 🚀**
             
-            This tool allows you to upload video or audio files to get a URL that can be used with all other tools in this app.
-            Supports various video and audio formats including MP4, MOV, AVI, MP3, WAV, etc.
+            Upload your media files to get started with VideoCraft's powerful editing tools.
+            We support a wide range of formats:
             
-            Simply drag and drop your file or click to browse, then use the generated URL with other tools.
+            📹 Videos: MP4, MOV, AVI, MKV, WebM
+            🎵 Audio: MP3, WAV, AAC, OGG, FLAC
+            
+            Simply drag and drop your file or click to browse. Once uploaded, you'll receive a URL
+            that you can use with all other tools in this suite.
             """,
             api_name="upload_file"
         ),
@@ -65,24 +78,38 @@ demo = gr.TabbedInterface(
                     ["9:16", "16:9", "1:1"], 
                     label="Target Ratio", 
                     value="9:16",
-                    
                 ),
                 gr.Dropdown(
-                    ["pad", "stretch"], 
+                    ["pad"], 
                     label="Method", 
                     value="pad",
                 )
             ],
             outputs=gr.Textbox(label="Result URL"),
             description="""
-            **Convert video to standard aspect ratios with high quality**
+            **Transform Your Videos for Any Platform 🎯**
+            
+            Optimize your videos for different social media platforms with our high-quality aspect ratio converter:
+            
+            📱 9:16 (1080x1920) - Perfect for:
+               - Instagram Reels
+               - TikTok
+               - YouTube Shorts
+               - Snapchat
             
-            This tool converts videos to common aspect ratios using standard dimensions:
-            - 9:16 (1080x1920) - Perfect for vertical videos (Instagram Reels, TikTok)
-            - 16:9 (1920x1080) - Standard widescreen format (YouTube, TV)
-            - 1:1 (1080x1080) - Square format (Instagram posts)
+            🖥️ 16:9 (1920x1080) - Ideal for:
+               - YouTube
+               - Vimeo
+               - TV broadcasts
+               - Professional presentations
             
-            Choose 'pad' to maintain video quality with black bars, or 'stretch' to fill the entire frame.
+            ⬛ 1:1 (1080x1080) - Great for:
+               - Instagram posts
+               - Facebook posts
+               - LinkedIn content
+               - Profile videos
+            
+            Our 'pad' method ensures your video maintains its quality while fitting perfectly into the new aspect ratio.
             """,
             api_name="change_aspect_ratio"
         ),
@@ -103,6 +130,23 @@ demo = gr.TabbedInterface(
                 gr.Textbox(label="Custom Font File (Optional)", value=None, placeholder="Path to custom font file")
             ],
             outputs=gr.Textbox(label="Result URL"),
+            description="""
+            **Add Professional Text Overlays to Your Videos ✨**
+            
+            Create engaging text overlays with precise control over:
+            
+            🕒 Timing: Set exact start and end times
+            🎨 Styling: Choose from multiple colors and sizes
+            📍 Positioning: Place text anywhere on screen
+            🎯 Background: Add optional background boxes for better readability
+            
+            Perfect for:
+            - Adding captions and subtitles
+            - Creating title cards
+            - Highlighting key points
+            - Adding watermarks
+            - Creating call-to-action text
+            """,
             api_name="add_text_overlay"
         ),
         gr.Interface(
@@ -112,6 +156,23 @@ demo = gr.TabbedInterface(
                 gr.Slider(0.25, 4, value=1.0, label="Speed Factor")
             ],
             outputs=gr.Textbox(label="Result URL"),
+            description="""
+            **Control Your Video's Pace 🎬**
+            
+            Adjust video speed while maintaining perfect audio synchronization:
+            
+            ⏩ Speed Up (1.0x - 4.0x):
+               - Create engaging highlights
+               - Show fast-paced action
+               - Make tutorials more concise
+            
+            ⏪ Slow Down (0.25x - 1.0x):
+               - Emphasize important moments
+               - Create dramatic effects
+               - Show detailed movements
+            
+            Our advanced processing ensures smooth playback and crystal-clear audio at any speed.
+            """,
             api_name="change_speed"
         ),
         gr.Interface(
@@ -121,43 +182,69 @@ demo = gr.TabbedInterface(
                 gr.Dropdown(["mp3", "aac", "wav", "ogg", "flac"], label="Audio Format", value="mp3")
             ],
             outputs=gr.Textbox(label="Result URL"),
-            api_name="extract_audio"
-        ),
-        gr.Interface(
-            fn=add_image_overlay,
-            inputs=[
-                gr.Textbox(label="Video URL"),
-                gr.Textbox(label="Image Path"),
-                gr.Dropdown(
-                    ["top_left", "top_right", "bottom_left", "bottom_right", "center"], 
-                    label="Position", 
-                    value="top_right"
-                ),
-                gr.Slider(0, 1, value=1.0, label="Opacity"),
-                gr.Slider(
-                    1, 50, 
-                    value=15, 
-                    step=1, 
-                    label="Size (%)",
-                    info="Size of image as percentage of video width (1-50%)"
-                ),
-                gr.Number(label="Start Time (seconds, optional)", value=None),
-                gr.Number(label="End Time (seconds, optional)", value=None)
-            ],
-            outputs=gr.Textbox(label="Result URL"),
             description="""
-            **Add an image overlay to your video**
+            **Extract High-Quality Audio from Videos 🎵**
             
-            This tool adds an image (like a logo or watermark) to your video with precise control over:
-            - Size: Set as percentage of video width (1-50%)
-            - Position: Choose from 5 preset positions
-            - Opacity: Adjust transparency (0-100%)
-            - Timing: Optional start and end times
+            Convert your video's audio track into various formats:
             
-            The image will maintain its aspect ratio while being resized to your specified percentage of the video width.
+            🎧 MP3: Universal format, great for most uses
+            🎼 AAC: High quality, smaller file size
+            🎹 WAV: Uncompressed, perfect for editing
+            🎺 OGG: Open format, good quality
+            🎻 FLAC: Lossless, best for archiving
+            
+            Perfect for:
+            - Creating podcasts
+            - Extracting music
+            - Saving voice recordings
+            - Archiving audio content
             """,
-            api_name="add_image_overlay"
+            api_name="extract_audio"
         ),
+        # gr.Interface(
+        #     fn=add_image_overlay,
+        #     inputs=[
+        #         gr.Textbox(label="Video URL"),
+        #         gr.Textbox(label="Image Path"),
+        #         gr.Dropdown(
+        #             ["top_left", "top_right", "bottom_left", "bottom_right", "center"], 
+        #             label="Position", 
+        #             value="top_right"
+        #         ),
+        #         gr.Slider(0, 1, value=1.0, label="Opacity"),
+        #         gr.Slider(
+        #             1, 50, 
+        #             value=15, 
+        #             step=1, 
+        #             label="Size (%)",
+        #             info="Size of image as percentage of video width (1-50%)"
+        #         ),
+        #         gr.Number(label="Start Time (seconds, optional)", value=None),
+        #         gr.Number(label="End Time (seconds, optional)", value=None)
+        #     ],
+        #     outputs=gr.Textbox(label="Result URL"),
+        #     description="""
+        #     **Add Professional Image Overlays to Your Videos 🖼️**
+            
+        #     Enhance your videos with images, logos, or watermarks:
+            
+        #     📐 Precise Control:
+        #        - Choose from 5 preset positions
+        #        - Adjust size (1-50% of video width)
+        #        - Set opacity (0-100%)
+        #        - Control timing (optional)
+            
+        #     Perfect for:
+        #     - Adding brand logos
+        #     - Including watermarks
+        #     - Displaying QR codes
+        #     - Showing additional graphics
+        #     - Creating picture-in-picture effects
+            
+        #     Images maintain their aspect ratio while being resized to your specifications.
+        #     """,
+        #     api_name="add_image_overlay"
+        # ),
         gr.Interface(
             fn=apply_color_filter,
             inputs=[
@@ -166,6 +253,20 @@ demo = gr.TabbedInterface(
                 gr.Slider(0, 1, value=1.0, label="Intensity")
             ],
             outputs=gr.Textbox(label="Result URL"),
+            description="""
+            **Apply Professional Color Filters 🎨**
+            
+            Transform your video's look with our curated collection of filters:
+            
+            🟤 Sepia: Classic, nostalgic look
+            ⚫ Grayscale: Timeless black and white
+            🔥 Warm: Cozy, inviting atmosphere
+            ❄️ Cool: Modern, crisp appearance
+            🕰️ Vintage: Retro, film-like quality
+            
+            Each filter includes intensity control for perfect customization.
+            Perfect for creating mood, establishing brand identity, or adding artistic flair.
+            """,
             api_name="apply_color_filter"
         ),
         gr.Interface(
@@ -175,12 +276,28 @@ demo = gr.TabbedInterface(
                     label="Video URLs (Python list format)", 
                     placeholder='["https://url1.com", "https://url2.com"]',
                     lines=4,
-                    info="Enter a list of video URLs to merge with transitions"
+                    info="Enter a list of video URLs to merge"
                 )
             ],
             outputs=gr.Textbox(label="Result URL"),
             title="Merge Videos",
-            description="Combine multiple videos",
+            description="""
+            **Combine Multiple Videos Seamlessly 🎬**
+            
+            Create longer videos by merging multiple clips:
+            
+            ✨ Features:
+            - Maintains original quality
+            - Preserves audio from all videos
+            - Handles various formats
+            - Seamless transitions
+            
+            Perfect for:
+            - Creating compilations
+            - Combining multiple takes
+            - Making longer videos
+            - Merging different angles
+            """,
             api_name="merge_videos"
         ),
         gr.Interface(
@@ -193,6 +310,24 @@ demo = gr.TabbedInterface(
                 gr.Radio(["true", "false"], label="Keep Original Audio", value="true")
             ],
             outputs=gr.Textbox(label="Result URL"),
+            description="""
+            **Add Background Music or Sound Effects 🎵**
+            
+            Enhance your videos with audio:
+            
+            🎼 Features:
+            - Add background music
+            - Include sound effects
+            - Control start time
+            - Adjust volume
+            - Mix with original audio
+            
+            Perfect for:
+            - Adding mood music
+            - Including sound effects
+            - Creating atmosphere
+            - Enhancing engagement
+            """,
             api_name="add_audio"
         ),
         gr.Interface(
@@ -202,6 +337,25 @@ demo = gr.TabbedInterface(
                 gr.Textbox(label="Analysis Task", value="Describe what's happening in this video")
             ],
             outputs=gr.Textbox(label="Analysis Result"),
+            description="""
+            **AI-Powered Video Analysis 🤖**
+            
+            Let our AI analyze your video content:
+            
+            🎯 Capabilities:
+            - Scene description
+            - Key moment detection
+            - Content summarization
+            - Timestamp identification
+            - Action recognition
+            
+            Perfect for:
+            - Content planning
+            - Video editing decisions
+            - Content optimization
+            - Quick video understanding
+            - Finding important moments
+            """,
             api_name="analyze_video"
         ),
         gr.Interface(
@@ -213,66 +367,116 @@ demo = gr.TabbedInterface(
                 gr.Radio(["cut", "keep"], label="Action", value="keep")
             ],
             outputs=gr.Textbox(label="Result URL"),
+            description="""
+            **Precise Video Segment Editing ✂️**
+            
+            Edit your video with frame-accurate precision:
+            
+            ✨ Features:
+            - Cut out unwanted segments
+            - Keep only specific parts
+            - Frame-accurate timing
+            - Smooth transitions
+            
+            Perfect for:
+            - Removing mistakes
+            - Creating highlights
+            - Extracting clips
+            - Trimming videos
+            - Creating shorter versions
+            """,
             api_name="edit_video_segment"
         ),
         gr.Interface(
-        fn=generate_word_level_subtitles_from_url,
-        inputs=[
-            gr.Textbox(
-                label="Video URL", 
-                placeholder="Enter the video URL to add word-level subtitles",
-                lines=1,
-                info="Required: Direct URL to the video file"
-            ),
+            fn=generate_word_level_subtitles_from_url,
+            inputs=[
+                gr.Textbox(
+                    label="Video URL", 
+                    placeholder="Enter the video URL to add word-level subtitles",
+                    lines=1,
+                    info="Required: Direct URL to the video file"
+                ),
                 gr.Slider(12, 72, value=38, step=2, label="Font Size"),
-                gr.Dropdown(["white", "yellow", "red", "green", "blue", "black"], value="white", label="Font Color"),
+                gr.Dropdown(["white", "yellow", "red", "green", "blue", "black", "cyan", "magenta"], value="white", label="Font Color"),
                 gr.Dropdown(["bottom-center", "top-center", "middle", "bottom-left", "bottom-right"], value="bottom-center", label="Position"),
                 gr.Textbox(label="Font Name", value="Arial", placeholder="Enter font name (e.g., Arial, Helvetica)"),
-                gr.Dropdown(["black", "white", "red", "green", "blue"], value="black", label="Outline Color"),
+                gr.Dropdown(["black", "white", "red", "green", "blue", "yellow", "cyan", "magenta"], value="black", label="Outline Color"),
                 gr.Slider(0, 5, value=2, step=1, label="Outline Width")
-        ],
-        outputs=gr.Textbox(
-            label="Result", 
-            placeholder="Processing status and download URL will appear here...",
-            lines=3,
-            info="Check here for the final video URL or any error messages"
-        ),
-        title="Word-Level Subtitle Generator",
-        description="""
-        **MCP Server Tool: Add word-by-word subtitles to videos**
-        
-        This tool processes videos to add precise word-level subtitles where each word appears exactly when spoken.
-        Perfect for creating engaging content with synchronized text overlay.
-        
-        Simply paste your video URL and click Submit. Processing typically takes 1-3 minutes.
-        """,
-        examples=[
-            ["https://example.com/sample-video.mp4", ""],
-            ["https://example.com/another-video.mp4", "https://custom-api.com/transcribe"]
-        ],
-            api_name="word_level_subtitles"
-    ),
-    gr.Interface(
-        fn=search_audio_from_envato,
-        inputs=[
-            gr.Textbox(label="Search Query"),
-            gr.Slider(1, 50, value=10, step=1, label="Limit"),
-            gr.Dropdown(
-                ["music", "effects"], 
-                label="Category", 
-                value=None, 
-                multiselect=False
+            ],
+            outputs=gr.Textbox(
+                label="Result", 
+                placeholder="Processing status and download URL will appear here...",
+                lines=3,
+                info="Check here for the final video URL or any error messages"
             ),
-            gr.Number(label="Min Length (seconds)", value=None),
-            gr.Number(label="Max Length (seconds)", value=None),
-            gr.Textbox(label="Tags (comma-separated)", value=None),
-            gr.Checkbox(label="Free Only", value=False)
-        ],
-        outputs=gr.JSON(label="Sound Effects"),
-        title="Sound Effect Search",
-        description="Search for royalty-free sound effects using Envato API",
-        api_name="search_audio_from_envato"
-    )
+            title="Word-Level Subtitle Generator",
+            description="""
+            **Create Perfect Word-Level Subtitles 🎯**
+            
+            Generate precise, word-by-word subtitles with perfect timing:
+            
+            ✨ Features:
+            - Word-level synchronization
+            - Multiple color options
+            - Customizable positioning
+            - Adjustable font size
+            - Outline control
+            
+            Perfect for:
+            - Social media content
+            - Educational videos
+            - International audiences
+            - Accessibility
+            - Engagement enhancement
+            
+            Processing typically takes 1-3 minutes depending on video length.
+            """,
+            api_name="word_level_subtitles"
+        ),
+        gr.Interface(
+            fn=search_audio_from_envato,
+            inputs=[
+                gr.Textbox(label="Search Query"),
+                gr.Slider(1, 50, value=10, step=1, label="Limit"),
+                gr.Dropdown(
+                    ["music", "effects"], 
+                    label="Category", 
+                    value=None, 
+                    multiselect=False
+                ),
+                gr.Number(label="Min Length (seconds)", value=None),
+                gr.Number(label="Max Length (seconds)", value=None),
+                gr.Textbox(label="Tags (comma-separated)", value=None),
+                gr.Checkbox(label="Free Only", value=False)
+            ],
+            outputs=gr.JSON(label="Sound Effects"),
+            title="Sound Effect Search",
+            description="""
+            **Find the Perfect Sound Effects and Music 🎵**
+            
+            Search Envato's vast library of royalty-free audio:
+            
+            🎼 Categories:
+            - Background music
+            - Sound effects
+            - Ambient sounds
+            - Voice overs
+            
+            ✨ Features:
+            - Length filtering
+            - Category selection
+            - Tag-based search
+            - Free items filter
+            - Preview available
+            
+            Perfect for:
+            - Adding background music
+            - Including sound effects
+            - Creating atmosphere
+            - Enhancing engagement
+            """,
+            api_name="search_audio_from_envato"
+        )
     ],
     [
         "Upload File",
@@ -280,7 +484,6 @@ demo = gr.TabbedInterface(
         "Add Text Overlay",
         "Change Speed",
         "Extract Audio",
-        "Add Image Overlay",
         "Apply Color Filter",
         "Merge Videos",
         "Add Audio",