done

README.md

@@ -6,4 +6,45 @@ colorTo: red
 sdk: docker
 pinned: false
 app_file: app.py
----
+---
+
+# 🎥 AutoVideoEditor: AI-Powered Clipchamp Automation
+
+AutoVideoEditor uses Google's Gemini 3 Flash to watch your raw footage, identify the best moments, and automatically construct a fully edited timeline file for Microsoft Clipchamp.
+
+## 🚀 How to Use
+
+Follow this workflow to turn raw footage into an edited video automatically:
+
+### 1. Prepare in Clipchamp
+1. Go to **Microsoft Clipchamp** (app or web).
+2. Create a **New Video Project**.
+3. (Optional) Add your media files to the project bin so they are ready, or just keep the project file created in your OneDrive.
+4. Ensure your project is synced/saved to OneDrive (usually in the `Videos/Clipchamp` folder).
+
+### 2. Configure AutoVideoEditor
+1. Open this app.
+2. **Login with OneDrive** (button in the UI). This allows the app to find your Clipchamp project and save the edits back to it.
+3. **Select your Project:** Choose the Clipchamp project file you created in Step 1.
+4. **Upload Raw Media:** Upload the video, audio, and image files you want the AI to edit.
+   * *Note:* The AI watches these videos to make creative decisions.
+5. **Describe your Style:** Tell the AI what kind of vibe you want (e.g., "Fast-paced gym motivation," "Slow cinematic travel vlog").
+
+### 3. Generate & Sync
+1. Click **Generate Video**.
+2. The AI will analyze the footage (using dynamic FPS calculations to optimize quality) and generate an editing plan.
+3. The app will construct a `.clipchamp` project file and **automatically upload it to your OneDrive**, overwriting or creating a new version of your project.
+
+### 4. The Magic Moment
+1. Go back to **Clipchamp**.
+2. **Reload/Refresh** the page or app.
+3. Open your project.
+4. ✨ **Voila!** You will see your timeline automatically populated with the best clips, trimmed and arranged according to the AI's plan.
+
+---
+
+## ⚡ Features
+*   **Gemini 3 Powered:** Uses the latest multimodal AI to "watch" and understand your video content.
+*   **Dynamic FPS Optimization:** Automatically adjusts frame rates to ensure even long videos fit within token limits.
+*   **OneDrive Integration:** Seamlessly syncs project files directly to your Microsoft cloud storage.
+*   **Style Control:** You dictate the pacing, mood, and focus of the edit via text prompts.