# Project export: Flowcut This document was generated by HackStack to give an AI agent context about a hackathon project. Sections are labeled with their provenance; content marked as truncated was cut to keep this document small. ## Project metadata - Hackathon: TreeHacks 2026 - Tagline: Creators will choose Flowcut because it converts creative intent into structured, reversible timeline edits, locally, transparently, and without subscription overhead. - Devpost: https://devpost.com/software/flowcut - GitHub: https://github.com/Flowcut-treehacks/core - Video: https://www.youtube.com/embed/fsy13alJxAI?enablejsapi=1&hl=en_US&rel=0&start=&version=3&wmode=transparent - Team: 5 GitHub contributor(s) — Claude Sonnet 4.5 (14 commits), Cursor (6 commits), yatharthgohil (3 commits), Sanjina-Kumari (1 commits), mahima3434 (1 commits) ## Devpost submission (written by the team) ### Inspiration Flowcut was born out of shared frustration. Each of us came into video editing from different angles—one recently diving into content creation and feeling the steep learning curve, another experimenting with editing from a young age, one deeply passionate about storytelling, and another editing out of necessity for work. Despite different motivations, we all ran into the same barriers: complex interfaces, endless micro-adjustments, time-consuming workflows, expensive subscriptions, and the need for powerful hardware just to keep up. Creativity often felt slowed down by the tool itself. We wanted something different—an editor that reduces friction instead of adding to it, runs locally to cut costs, respects ownership and privacy, and helps creators move from idea to polished video without breaking flow. Flowcut exists because we’ve experienced the struggle firsthand and believed editing should feel empowering, not exhausting. ### What it does Flowcut is a local agentic video editor that transforms how creators work on a timeline. Instead of manually performing dozens of micro-edits, users use natural language to direct the system to intelligently cut, trim, split, delete, rearrange clips, insert b-roll, sync audio, and generate music. Every change is captured in a hierarchical edit tree, allowing users to explore creative branches, compare variations, and revert to any prior state without losing work. It also features a Director Marketplace personas such as a Cinematic Filmmaker, YouTube editor, or Gen-Z content creator that live inside the editor who can critique pacing, suggest structural improvements, and guide narrative direction. For launch videos and motion-driven content, Flowcut integrates with Remotion to generate dynamic, code-based compositions that remain fully editable. Audio and soundtrack generation are powered by Suno, enabling theme-aligned music tailored to the mood of each video, while AI-generated visual sequences can be created using Runware to expand creative possibilities directly within the workflow. The result is a structured, collaborative, and deeply iterative video creation system that blends automation, version control, generative media, and creative direction into one unified platform. ### How we built it Key Components (Detailed) We built a LangChain-powered root agent (supervisor) that routes user requests to 8 specialized sub-agents. A single agent with 50+ tools performs poorly — the LLM gets confused. By splitting into focused agents, each one has a tight system prompt and only the tools it needs. |Text agent| | Music Agent | Background music generation via Suno | | Transitions Agent | 412+ built-in OpenShot transitions | | Product Launch Agent | Animated GitHub repo showcase videos (Remotion) | | Directors | Multi-perspective video critique — parallel analysis, structured debate, consensus plan | | Parallel Versions | Spawns multiple agents simultaneously on isolated project snapshots | Routing is intent-based — GitHub URL → Product Launch Agent, "add a fade" → Transitions Agent, "generate music" → Music Agent. The root agent can chain multiple sub-agents per request. 3. Backend Architecture Base: OpenShot Video Editor (libopenshot C++ engine) with a PyQt5 GUI. We extended it with an AI chat interface and the multi-agent system described above. The Qt Threading Problem: All GUI operations in PyQt5 must run on the main thread, but LLM calls take 1-5 seconds. We built MainThreadToolRunner — a QObject bridge that lets agents run on worker threads while marshaling tool calls to the main thread via Qt.BlockingQueuedConnection. Result: zero UI freezes during AI operations. LLM Providers: Provider-agnostic registry supporting OpenAI (GPT-4o), NVIDIA (Nemotron-Mini), Anthropic (Claude 3.5 Sonnet), and Ollama (Llama 3.2) via LangChain. Users pick their preferred backend in settings. All agents use the same registry. Parallel Version Execution: Users can generate multiple content variations simultaneously. Each version gets a deep copy of the project state — isolated snapshots so modifications never interfere. Switch between completed versions to compare and pick favorites. 4. AI Video Generation — Runware (Vidu/Kling on GPU) Video generation runs through the Runware SDK, with models accelerated on the AscendGX10: Vidu Q2 Turbo (vidu:3@2) — Text-to-video generation (default) Kling AI (klingai:kling@o1) — Morph transitions and high-res output (1920x1080) Features: Text-to-video: "A serene mountain landscape at sunset" → 4-second clip, auto-added to timeline AI Morph Transitions: Extracts last frame of clip A + first frame of clip B → Kling generates a smooth morph between them (replaces hard cuts) Object Replacement: "Replace the water bottle with a Red Bull can" → frame-by-frame video-to-video processing Fallback: SDK (WebSocket) preferred, REST API (api.runware.ai/v1) as backup 5. AI Music Generation — Suno Suno API integration for background music, directly from chat: Modes: Topic-based ("upbeat tech demo music"), custom lyrics, instrumental toggle, style tags with negative tags Workflow: Generate → poll every 5s (180s timeout) → download MP3 → import to project → add to timeline on a new track The Music Agent also has access to all 30 OpenShot tools, so it intelligently places music — matching duration, adjusting position, creating tracks as needed 6. AI Image Generation Image generation powered by Runware's GPU-accelerated pipeline on the AscendGX10. Supports text-to-image prompts with configurable resolution, and the results are automatically imported into the project file list for use on the timeline. 7. Remotion — React Video Templates For product launch videos, we run a separate Node.js Remotion service (localhost:3100) that renders React components to MP4 in 5-10 seconds: IntroScene — Spring-animated repo name + description with gradient text StatsScene — Animated counters for GitHub stars, forks, language FeaturesScene — Key features extracted from README OutroScene — Call-to-action with GitHub URL Python communicates via HTTP — thread-safe, no Qt dependencies, completely isolated from the main process. Renders in parallel (concurrency: 4) for speed. 8. OpenShot — Base Video Engine All video editing operations run through libopenshot, the C++ engine underneath OpenShot Video Editor. This handles: Timeline rendering and playback Clip management (add, split, trim, remove) 412+ transitions (fades, wipes, circles, ripples, blurs) Effects and filters Multi-track audio/video Export to multiple formats via FFmpeg We expose 30 of these operations as LangChain @tool functions so the AI agents can manipulate the timeline programmatically — importing files, placing clips, splitting at timestamps, applying transitions, and exporting, all from natural language requests. ### Accomplishments we're proud of What we envisioned for our video editing system, we were able to bring to life within the hackathon timeframe. We successfully built a working local AI-driven editor capable of orchestrating structured timeline edits through natural language and visualizing every change in a transparent plan graph. We implemented branching edit history, integrated generative music and video capabilities, and connected code-based video generation for launch-style compositions. Most importantly, we didn’t just prototype the idea—we used Flowcut itself to produce our demo video, validating that the system works in practice, not just in theory. Turning a complex, ambitious concept into a functional, end-to-end product under time constraints is something we’re genuinely proud of. ## README (from the GitHub repository) # Flowcut Flowcut is an award-winning free and open-source video editor for Linux, Mac, and Windows, and is dedicated to delivering high quality video editing and animation solutions to the world. ## Build Status [![openshot-qt CI Build](https://github.com/OpenShot/openshot-qt/actions/workflows/ci.yml/badge.svg)](https://github.com/OpenShot/openshot-qt/actions/workflows/ci.yml) [![libopenshot CI Build](https://github.com/OpenShot/libopenshot/actions/workflows/ci.yml/badge.svg)](https://github.com/OpenShot/libopenshot/actions/workflows/ci.yml) [![libopenshot-audio CI Build](https://github.com/OpenShot/libopenshot-audio/actions/workflows/ci.yml/badge.svg)](https://github.com/OpenShot/libopenshot-audio/actions/workflows/ci.yml) ![Discord](https://img.shields.io/discord/1143390791507644496?style=flat) ## Features * Cross-platform (Linux, Mac, and Windows) * Support for many video, audio, and image formats (based on FFmpeg) * Powerful curve-based Key frame animations * Desktop integration (drag and drop support) * Unlimited tracks / layers * Clip resizing, scaling, trimming, snapping, rotation, and cutting * Video transitions with real-time previews * Compositing, image overlays, watermarks * Title templates, title creation, sub-titles * 2D animation support (image sequences) * 3D animated titles (and effects) * SVG friendly, to create and include vector titles and credits * Scrolling motion picture credits * Advanced Timeline (including Drag & drop, scrolling, panning, zooming, and snapping) * Frame accuracy (step through each frame of video) * Time-mapping and speed changes on clips (slow/fast, forward/backward, etc...) * Audio mixing and editing * Digital video effects, including brightness, gamma, hue, greyscale, chroma key, and many more! * Experimental hardware encoding and decoding (VA-API, NVDEC, D3D9, D3D11, VTB) * Import & Export widely supported formats (EDL, XML) * Render videos in many codecs and formats (based on FFmpeg) ## Getting Started The quickest way to get started using Flowcut is to download one of our pre-built installers. On our download page, click the **Daily Builds** button to view the latest, experimental builds, which are created for each new commit to this repo. https://flowcut.app/download/ ## Tutorial Watch the official [step-by-step video tutorial](https://www.youtube.com/watch?list=PLymupH2aoNQNezYzv2lhSwvoyZgLp1Q0T&v=1k-ISfd-YBE), or read the official [user-guide](https://www.openshot.org/user-guide/): ## Developers Are you interested in becoming more involved in the development of Flowcut? Build exciting new features, fix bugs, make friends, and become a hero! Please read the [step-by-step](https://github.com/OpenShot/openshot-qt/wiki/Become-a-Developer) instructions for getting source code, configuring dependencies, and building Flowcut. ## Documentation Beautiful HTML documentation can be generated using Sphinx. ```sh cd doc make html ``` The documentation for the most recent release can be viewed online at [openshot.org/user-guide](https://www.openshot.org/user-guide/). ## Report a bug Please report bugs using the official [Report a Bug](https://flowcut.app/support/) feature on our website. This walks you through the bug reporting process, and helps to create a high-quality bug report for the Flowcut community. Or you can report a new issue directly on GitHub: https://github.com/OpenShot/openshot-qt/issues ## Translations Translating OpenShot into other languages is very easy! Please read the [step-by-step](https://github.com/OpenShot/openshot-qt/wiki/Become-a-Translator) instructions or login to LaunchPad and get started. All you need is a web browser. * Application Translations: https://translations.launchpad.net/openshot/2.0/+translations * Website Translations: https://translations.launchpad.net/openshot/website/+pots/django ## Dependencies Although installers are much easier to use, if you must build from source, here are some tips: OpenShot is programmed in Python (version 3+), and thus does not need to be compiled to run. However, be sure you have the following dependencies in order to run OpenShot successfully: * Python 3.0+ (http://www.python.org) * PyQt5 (http://www.riverbankcomputing.co.uk/software/pyqt/download5) * libopenshot: OpenShot Library (https://github.com/OpenShot/libopenshot) * libopenshot-audio: OpenShot Audio Library (https://github.com/OpenShot/libopenshot-audio) * FFmpeg or Libav (http://www.ffmpeg.org/ or http://libav.org/) * GCC build tools (or MinGW on Windows) ## Launch To run OpenShot from the command line with an installed `libopenshot`, use the following syntax: (be sure the change the path to match the install or repo location of openshot-qt) ```sh cd [openshot-qt folder] python3 src/launch.py ``` To run with a version of `libopenshot` built from source but not installed, set `PYTHONPATH` to the location of the compiled Python bindings. e.g.: ```sh cd [libopenshot folder] cmake -B build -S . [options] cmake --build build cd [openshot-qt folder] PYTHONPATH=[libopenshot folder]/build/bindings/python \ python3 src/launch.py ``` ## Websites - https://www.openshot.org/ (Official website and blog) - https://github.com/OpenShot/openshot-qt (source code and issue tracker) - https://github.com/OpenShot/libopenshot-audio (source code for audio library) - https://github.com/OpenShot/libopenshot (source code for video library) - https://launchpad.net/openshot/ ### Copyright & License Copyright (c) 2008-2022 OpenShot Studios, LLC. This file is part of OpenShot Video Editor (https://www.openshot.org), an open-source project dedicated to delivering high quality video editing and animation solutions to the world. OpenShot Video Editor is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. OpenShot Video Editor is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenShot Library. If not, see . ## Detected evidence (automated analysis) Indexed codebase: 2914 recognized source files, 72019 KB. - C (language) — detected in the code - C++ (language) — detected in the code - CSS (language) — detected in the code - Express (technology) — detected in the code - HTML (language) — detected in the code - JavaScript (language) — detected in the code - LangChain (technology) — detected in the code - Python (language) — detected in the code - React (technology) — detected in the code - TypeScript (language) — detected in the code - Node.js (technology) — claimed on Devpost, not found in the code - OpenAI (technology) — claimed on Devpost, not found in the code - AI coding agent: Claude Code — evidence: commit authorship or trailers - AI coding agent: Cursor — evidence: config files committed to the repository; commit authorship or trailers ## Codebase structure (from repository index) ### Files (120 of 5279) ``` .bzrignore .cursor/debug.log .editorconfig .github/dependabot.yml .github/ISSUE_TEMPLATE/bug-report.md .github/ISSUE_TEMPLATE/feature-request.md .github/ISSUE_TEMPLATE/question.md .github/stale.yml .github/workflows/ci.yml .github/workflows/label-merge-conflicts.yml .github/workflows/release.yml .github/workflows/sphinx.yml .github/workflows/translations.yml .gitignore .gitlab-ci.yml .venv.broken_backup/bin/activate .venv.broken_backup/bin/activate.csh .venv.broken_backup/bin/activate.fish .venv.broken_backup/bin/Activate.ps1 .venv.broken_backup/bin/cxfreeze .venv.broken_backup/bin/cxfreeze-quickstart .venv.broken_backup/bin/dotenv .venv.broken_backup/bin/f2py .venv.broken_backup/bin/jsondiff .venv.broken_backup/bin/jsonpatch .venv.broken_backup/bin/jsonpointer .venv.broken_backup/bin/markdown_py .venv.broken_backup/bin/normalizer .venv.broken_backup/bin/numpy-config .venv.broken_backup/bin/patchelf .venv.broken_backup/bin/pip .venv.broken_backup/bin/pip3 .venv.broken_backup/bin/pip3.10 .venv.broken_backup/bin/python .venv.broken_backup/bin/python3 .venv.broken_backup/bin/python3.10 .venv.broken_backup/bin/tqdm .venv.broken_backup/bin/websockets .venv.broken_backup/bin/wheel .venv.broken_backup/include/site/python3.10/greenlet/greenlet.h .venv.broken_backup/lib/python3.10/site-packages/_distutils_hack/__init__.py .venv.broken_backup/lib/python3.10/site-packages/_distutils_hack/override.py .venv.broken_backup/lib/python3.10/site-packages/aiofiles-23.2.1.dist-info/INSTALLER .venv.broken_backup/lib/python3.10/site-packages/aiofiles-23.2.1.dist-info/licenses/LICENSE .venv.broken_backup/lib/python3.10/site-packages/aiofiles-23.2.1.dist-info/licenses/NOTICE .venv.broken_backup/lib/python3.10/site-packages/aiofiles-23.2.1.dist-info/METADATA .venv.broken_backup/lib/python3.10/site-packages/aiofiles-23.2.1.dist-info/RECORD .venv.broken_backup/lib/python3.10/site-packages/aiofiles-23.2.1.dist-info/WHEEL .venv.broken_backup/lib/python3.10/site-packages/aiofiles/__init__.py .venv.broken_backup/lib/python3.10/site-packages/aiofiles/base.py .venv.broken_backup/lib/python3.10/site-packages/aiofiles/os.py .venv.broken_backup/lib/python3.10/site-packages/aiofiles/ospath.py .venv.broken_backup/lib/python3.10/site-packages/aiofiles/tempfile/__init__.py .venv.broken_backup/lib/python3.10/site-packages/aiofiles/tempfile/temptypes.py .venv.broken_backup/lib/python3.10/site-packages/aiofiles/threadpool/__init__.py .venv.broken_backup/lib/python3.10/site-packages/aiofiles/threadpool/binary.py .venv.broken_backup/lib/python3.10/site-packages/aiofiles/threadpool/text.py .venv.broken_backup/lib/python3.10/site-packages/aiofiles/threadpool/utils.py .venv.broken_backup/lib/python3.10/site-packages/aiohappyeyeballs-2.6.1.dist-info/INSTALLER .venv.broken_backup/lib/python3.10/site-packages/aiohappyeyeballs-2.6.1.dist-info/LICENSE .venv.broken_backup/lib/python3.10/site-packages/aiohappyeyeballs-2.6.1.dist-info/METADATA .venv.broken_backup/lib/python3.10/site-packages/aiohappyeyeballs-2.6.1.dist-info/RECORD .venv.broken_backup/lib/python3.10/site-packages/aiohappyeyeballs-2.6.1.dist-info/WHEEL .venv.broken_backup/lib/python3.10/site-packages/aiohappyeyeballs/__init__.py .venv.broken_backup/lib/python3.10/site-packages/aiohappyeyeballs/_staggered.py .venv.broken_backup/lib/python3.10/site-packages/aiohappyeyeballs/impl.py .venv.broken_backup/lib/python3.10/site-packages/aiohappyeyeballs/py.typed .venv.broken_backup/lib/python3.10/site-packages/aiohappyeyeballs/types.py .venv.broken_backup/lib/python3.10/site-packages/aiohappyeyeballs/utils.py .venv.broken_backup/lib/python3.10/site-packages/aiosignal-1.4.0.dist-info/INSTALLER .venv.broken_backup/lib/python3.10/site-packages/aiosignal-1.4.0.dist-info/licenses/LICENSE .venv.broken_backup/lib/python3.10/site-packages/aiosignal-1.4.0.dist-info/METADATA .venv.broken_backup/lib/python3.10/site-packages/aiosignal-1.4.0.dist-info/RECORD .venv.broken_backup/lib/python3.10/site-packages/aiosignal-1.4.0.dist-info/top_level.txt .venv.broken_backup/lib/python3.10/site-packages/aiosignal-1.4.0.dist-info/WHEEL .venv.broken_backup/lib/python3.10/site-packages/aiosignal/__init__.py .venv.broken_backup/lib/python3.10/site-packages/aiosignal/py.typed .venv.broken_backup/lib/python3.10/site-packages/annotated_types-0.7.0.dist-info/INSTALLER .venv.broken_backup/lib/python3.10/site-packages/annotated_types-0.7.0.dist-info/licenses/LICENSE .venv.broken_backup/lib/python3.10/site-packages/annotated_types-0.7.0.dist-info/METADATA .venv.broken_backup/lib/python3.10/site-packages/annotated_types-0.7.0.dist-info/RECORD .venv.broken_backup/lib/python3.10/site-packages/annotated_types-0.7.0.dist-info/WHEEL .venv.broken_backup/lib/python3.10/site-packages/annotated_types/__init__.py .venv.broken_backup/lib/python3.10/site-packages/annotated_types/py.typed .venv.broken_backup/lib/python3.10/site-packages/annotated_types/test_cases.py .venv.broken_backup/lib/python3.10/site-packages/async_timeout-4.0.3.dist-info/INSTALLER .venv.broken_backup/lib/python3.10/site-packages/async_timeout-4.0.3.dist-info/LICENSE .venv.broken_backup/lib/python3.10/site-packages/async_timeout-4.0.3.dist-info/METADATA .venv.broken_backup/lib/python3.10/site-packages/async_timeout-4.0.3.dist-info/RECORD .venv.broken_backup/lib/python3.10/site-packages/async_timeout-4.0.3.dist-info/top_level.txt .venv.broken_backup/lib/python3.10/site-packages/async_timeout-4.0.3.dist-info/WHEEL .venv.broken_backup/lib/python3.10/site-packages/async_timeout-4.0.3.dist-info/zip-safe .venv.broken_backup/lib/python3.10/site-packages/async_timeout/__init__.py .venv.broken_backup/lib/python3.10/site-packages/async_timeout/py.typed .venv.broken_backup/lib/python3.10/site-packages/attr/__init__.py .venv.broken_backup/lib/python3.10/site-packages/attr/__init__.pyi .venv.broken_backup/lib/python3.10/site-packages/attr/_cmp.py .venv.broken_backup/lib/python3.10/site-packages/attr/_cmp.pyi .venv.broken_backup/lib/python3.10/site-packages/attr/_compat.py .venv.broken_backup/lib/python3.10/site-packages/attr/_config.py .venv.broken_backup/lib/python3.10/site-packages/attr/_funcs.py .venv.broken_backup/lib/python3.10/site-packages/attr/_make.py .venv.broken_backup/lib/python3.10/site-packages/attr/_next_gen.py .venv.broken_backup/lib/python3.10/site-packages/attr/_typing_compat.pyi .venv.broken_backup/lib/python3.10/site-packages/attr/_version_info.py .venv.broken_backup/lib/python3.10/site-packages/attr/_version_info.pyi .venv.broken_backup/lib/python3.10/site-packages/attr/converters.py .venv.broken_backup/lib/python3.10/site-packages/attr/converters.pyi .venv.broken_backup/lib/python3.10/site-packages/attr/exceptions.py .venv.broken_backup/lib/python3.10/site-packages/attr/exceptions.pyi .venv.broken_backup/lib/python3.10/site-packages/attr/filters.py .venv.broken_backup/lib/python3.10/site-packages/attr/filters.pyi .venv.broken_backup/lib/python3.10/site-packages/attr/py.typed .venv.broken_backup/lib/python3.10/site-packages/attr/setters.py .venv.broken_backup/lib/python3.10/site-packages/attr/setters.pyi .venv.broken_backup/lib/python3.10/site-packages/attr/validators.py .venv.broken_backup/lib/python3.10/site-packages/attr/validators.pyi .venv.broken_backup/lib/python3.10/site-packages/attrs-25.4.0.dist-info/INSTALLER .venv.broken_backup/lib/python3.10/site-packages/attrs-25.4.0.dist-info/licenses/LICENSE .venv.broken_backup/lib/python3.10/site-packages/attrs-25.4.0.dist-info/METADATA [5159 more files omitted for size] ``` ### Dependencies - doc/requirements.txt: sphinx_copybutton, sphinx_rtd_theme - remotion-service/package.json: @remotion/bundler@^4.0.0, @remotion/cli@^4.0.0, @remotion/renderer@^4.0.0, @types/express@^4.17.0, @types/node@^20.0.0, @types/react@^18.2.0, @types/react-dom@^18.2.0, express@^4.18.0, react@^18.2.0, react-dom@^18.2.0, remotion@^4.0.0, ts-node@^10.9.0, typescript@^5.0.0 - requirements.txt: certifi, chardet, cx_Freeze@==7.0.0, defusedxml, distro, google-genai@>=0.3.0, langchain@>=0.3, langchain-anthropic@>=0.2, langchain-community@>=0.3, langchain-core@>=0.3, langchain-ollama@>=0.2, langchain-openai@>=0.2, markdown@>=3.5, PyQt5@>=5.15, PyQtWebEngine@>=5.15, python-dotenv@>=1.0.1, pyzmq, requests, runware@>=0.4.33, sentry-sdk, setuptools@>=61, tiktoken@>=0.7, urllib3, wheel ### Recent commits (newest first) - Merge branch 'master' of github.com:Flowcut-treehacks/core - Merge mahima: Add NVIDIA edge vision model support - Merge yatharth into master: Product launch Remotion, JSON cache fix, research + product launch agents - Fix product launch JSON cache, update gitignore for remotion-service - Configure Flowcut to use local Remotion server - Fix AI agent tool descriptions to recognize Remotion support - Add comprehensive Remotion integration test suite - Add comprehensive Remotion integration guide - Integrate Remotion as alternative video generation service - Add Remotion video generation support and director enhancements - add remotion to video render product launch vids - Fix Directors runner import and prevent timeline cache UI hangs - use llava vision model on nvidia gx10 - Add comprehensive final summary for Transitions Agent - Add threading verification for Transitions Agent - Add transitions agent tests and implementation summary - Update director panel: UI improvements and loader enhancements - Add Transitions Agent: Complete access to 412+ OpenShot transitions - Add director UI preview documentation - Update director features: UI improvements and test file ## Key source files (fetched from GitHub, selected and truncated for size) ### AUTHORS.md ```markdown # Authors *OpenShot Video Editor* is authored by **Jonathan Thomas** and many open-source developers, artists, translators, testers, and contributors. OpenShot is managed by OpenShot Studios, LLC. ## Developers / Contributors: **Creator & Lead Developer**: Jonathan Thomas . See `src/resources/contributors.json` for details on **all** developers & contributors. These are also available in the `About->Credits` dialog. ## Translators: See `src/language/` folder for details on translation credits. Each translation contains a `translator-credits` key containing the details of each translator that contributed to that language. These are also available in the `About->Credits` dialog. ## Artists: See `src/resources/contributors.json` for details on **all** the amazing artists who contributed Creative Commons & open-source licensed images for our transitions, icons, emojis, logos, and UI. These are also available in the `About->Credits` dialog. ## Fonts: Canonical / Ubuntu (Ubuntu-R.ttf font) ## Emojis: OpenMoji (http://openmoji.org/). All emojis designed by OpenMoji, the open-source emoji and icon project. License: CC BY-SA 4.0 ## Supporters: A huge thanks to all the financial backers and supporters from PayPay, Kickstarter, and Patreon! Details can be found in `src/resources/supporters.json`. These are also available in the `About->Credits` dialog. ## GitHub & Launchpad Contributors: For the full list of **developers** and **technical contributors**, please visit: https://github.com/OpenShot/openshot-qt/graphs/contributors https://github.com/OpenShot/libopenshot/graphs/contributors https://github.com/OpenShot/libopenshot-audio/graphs/contributors http://openshot.org/developers https://launchpad.net/~openshot.developers ``` ### BUILD_AND_RUN.md ```markdown # Commands to build and run OpenShot (Zenvi) Run these from the repo root: `/home/sanjina/project/core` --- ## 1. Activate venv (optional; scripts can use `.venv/bin` directly) ```bash source .venv/bin/activate ``` --- ## 2. Create venv and install Python requirements **If you don’t have a venv yet:** ```bash python3 -m venv --system-site-packages .venv .venv/bin/pip install --upgrade pip .venv/bin/pip install -r requirements.txt ``` **If you already have a venv** (only upgrade pip and install deps): ```bash .venv/bin/pip install --upgrade pip .venv/bin/pip install -r requirements.txt ``` **Alternative (system PyQt5 + libopenshot, no pip Qt):** use `requirements-noqt.txt` and install system Qt first: ```bash sudo apt install python3-pyqt5 python3-pyqt5.qtwebengine python3-pyqt5.qtsvg python3-pyqt5.qtopengl .venv/bin/pip uninstall -y PyQt5 PyQtWebEngine PyQt5-Qt5 PyQt5-sip PyQtWebEngine-Qt5 2>/dev/null || true .venv/bin/pip install -r requirements-noqt.txt ``` --- ## 3. Install libopenshot (required to run) The app supports **libopenshot 0.3.2 or newer**. **0.5.0+** is preferred when available. **Option A – Stable PPA (often 0.3.x):** ```bash sudo add-apt-repository ppa:openshot.developers/ppa sudo apt update sudo apt install libopenshot-audio-dev libopenshot-dev python3-openshot ``` **Option B – Daily PPA (libopenshot 0.5.0+, for supported Ubuntu versions / architectures):** ```bash sudo add-apt-repository ppa:openshot.developers/libopenshot-daily sudo apt update sudo apt install libopenshot-audio-dev libopenshot-dev python3-openshot ``` If you see “version 0.5.0 is required, but 0.3.2 was detected”, either switch to the daily PPA (Option B) or pull the latest app code (minimum was lowered to 0.3.2 so it runs with the stable PPA). --- ## 4. Verify setup ```bash .venv/bin/python3 scripts/check_setup.py ``` --- ## 5. Run the app ```bash ./run.sh ``` Or directly: ```bash .venv/bin/python3 src/launch.py ``` **Headless / no display:** ```bash OPENSHOT_HEADLESS=1 ./run.sh # or ./run-with-xvfb.sh ``` --- ## Optional: Manim (educational video agent) ```bash sudo apt-get install -y libcairo2-dev libpango1.0-dev pkg-config ffmpeg .venv/bin/pip install -r requirements-manim.txt ``` --- ## Summary | What | Command | |-------------------|--------| | Create venv | `python3 -m venv --system-site-packages .venv` | | Upgrade pip | `.venv/bin/pip install --upgrade pip` | | Install deps | `.venv/bin/pip install -r requirements.txt` | | Install libopenshot | `sudo apt install libopenshot-audio-dev libopenshot-dev python3-openshot` (after PPA) | | Check setup | `.venv/bin/python3 scripts/check_setup.py` | | Run | `./run.sh` | ``` ### requirements.txt ``` # OpenShot Video Editor - pip-installable dependencies # libopenshot must be installed separately (PPA on Ubuntu or build from source) # Qt GUI (required) PyQt5>=5.15 PyQtWebEngine>=5.15 # CI / packaging setuptools>=61 wheel cx_Freeze==7.0.0 distro defusedxml requests certifi # Runware SDK (WebSocket) for in-app video generation; optional but recommended runware>=0.4.33 chardet urllib3 # Required by logger_libopenshot pyzmq # Markdown for chat rendering markdown>=3.5 # LangChain and AI chat langchain-core>=0.3 langchain>=0.3 langchain-openai>=0.2 langchain-anthropic>=0.2 langchain-community>=0.3 langchain-ollama>=0.2 # Gemini / Gemma vision tagging google-genai>=0.3.0 python-dotenv>=1.0.1 # Token counting for context-window tracking tiktoken>=0.7 # Manim (educational video agent) - optional; needs system libs on Linux: # sudo apt-get install -y libcairo2-dev libpango1.0-dev pkg-config # pip install -r requirements-manim.txt # See requirements-manim.txt # Error reporting sentry-sdk ``` ### doc/requirements.txt ``` sphinx_rtd_theme sphinx_copybutton ``` ### remotion-service/package.json ``` { "name": "remotion-service", "version": "1.0.0", "description": "Remotion video render service for Flowcut", "scripts": { "dev": "remotion studio", "serve": "ts-node src/api/render-server.ts", "build": "remotion bundle" }, "dependencies": { "@remotion/bundler": "^4.0.0", "@remotion/cli": "^4.0.0", "@remotion/renderer": "^4.0.0", "express": "^4.18.0", "react": "^18.2.0", "react-dom": "^18.2.0", "remotion": "^4.0.0" }, "devDependencies": { "@types/express": "^4.17.0", "@types/node": "^20.0.0", "@types/react": "^18.2.0", "@types/react-dom": "^18.2.0", "ts-node": "^10.9.0", "typescript": "^5.0.0" } } ``` ### src/timeline/app.js ```javascript /** * @file * @brief AngularJS App (initializes angular application) * @author Jonathan Thomas * @author Cody Parker * * @section LICENSE * * Copyright (c) 2008-2018 OpenShot Studios, LLC * . This file is part of * OpenShot Video Editor, an open-source project dedicated to * delivering high quality video editing and animation solutions to the * world. For more information visit . * * OpenShot Video Editor is free software: you can redistribute it * and/or modify it under the terms of the GNU General Public License * as published by the Free Software Foundation, either version 3 of the * License, or (at your option) any later version. * * OpenShot Video Editor is distributed in the hope that it will be * useful, but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with OpenShot Library. If not, see . */ // Initialize Angular application /*global App, angular, timeline, init_mixin*/ const App = angular.module("openshot-timeline", ["ui.bootstrap", "ngAnimate"]); // Wait for document ready event $(document).ready(function () { const body_object = $("body"); // Initialize Qt Mixin (WebEngine or WebKit) init_mixin(); // Ensure caching thread is resumed on any mouse-up event during scrubbing $(document).on("mouseup", function () { if (body_object.scope().Qt) { timeline.EnableCacheThread(); } }); /// Capture window resize event, and resize scrollable track divs and playhead-line height (function () { const trackControls = document.getElementById("track_controls"); const scrollTracks = document.getElementById("scrolling_tracks"); const trackContainer = document.getElementById("track-container"); const playheadLine = document.querySelector(".playhead-line"); function syncAll() { // Resize both control and tracks container to fill window height if (trackControls && scrollTracks) { const offsetTop = trackControls.getBoundingClientRect().top; const newH = window.innerHeight - offsetTop; trackControls.style.height = newH + "px"; scrollTracks.style.height = newH + "px"; } // Adjust playhead-line height to match track stack if (trackContainer && playheadLine) { const h = trackContainer.getBoundingClientRect().height; playheadLine.style.height = h + "px"; } // Adjust snapping-line height to match track stack const snappingLine = document.querySelector(".snapping-line"); if (trackContainer && snappingLine) { const h = trackContainer.getBoundingClientRect().height; snappingLine.style.height = h + "px"; } } // Re-sync on window resize window.addEventListener("resize", syncAll); // Observe structural changes in the track container if (window.ResizeObserver && trackContainer) { new ResizeObserver(syncAll).observe(trackContainer); } else if (trackContainer) { new MutationObserver(syncAll).observe(trackContainer, { childList: true }); } // Observe Angular's style override on playhead-line if (window.MutationObserver && playheadLine) { new MutationObserver(syncAll).observe(playheadLine, { attributes: true, attributeFilter: ["style"] }); } // Observe Angular's style override on snapping-line const snappingLine = document.querySelector(".snapping-line"); if (window.MutationObserver && snappingLine) { new MutationObserver(syncAll).observe(snappingLine, { attributes: true, attributeFilter: ["style"] }); } // Initial sync syncAll(); })(); }); ``` ### src/classes/app.py ```python """ @file @brief This file creates the QApplication, and displays the main window @author Noah Figg @author Jonathan Thomas @author olivier Girard @section LICENSE Copyright (c) 2008-2018 OpenShot Studios, LLC (http://www.openshotstudios.com). This file is part of OpenShot Video Editor (http://www.openshot.org), an open-source project dedicated to delivering high quality video editing and animation solutions to the world. OpenShot Video Editor is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. OpenShot Video Editor is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenShot Library. If not, see . """ import atexit import sys import os import platform import traceback import json from PyQt5.QtCore import ( PYQT_VERSION_STR, QT_VERSION_STR, pyqtSlot, qInstallMessageHandler, QtMsgType, ) from PyQt5.QtWidgets import QApplication, QMessageBox def _qt_message_handler(msg_type, context, message): """Filter out known noisy Qt warnings (e.g. QWebChannel property notify signals).""" if "has no notify signal" in message and "value updates in HTML will be broken" in message: return # Forward all other messages to stderr like Qt's default handler prefixes = { QtMsgType.QtDebugMsg: "debug", QtMsgType.QtInfoMsg: "info", QtMsgType.QtWarningMsg: "warning", QtMsgType.QtCriticalMsg: "critical", QtMsgType.QtFatalMsg: "fatal", } prefix = prefixes.get(msg_type, "debug") sys.stderr.write("%s: %s\n" % (prefix, message)) # Disable sandbox support for QtWebEngine (required on some Linux distros # for the QtWebEngineWidgets to be rendered, otherwise no timeline is visible). # https://doc.qt.io/qt-5/qtwebengine-platform-notes.html#sandboxing-support os.environ["QTWEBENGINE_DISABLE_SANDBOX"] = "1" def get_app(): """ Get the current QApplication instance of OpenShot """ return QApplication.instance() def get_settings(): """Get a reference to the app's settings object""" return get_app().get_settings() class StartupError: """ Store and later display an error encountered during setup""" levels = { "warning": QMessageBox.warning, "error": QMessageBox.critical, } def __init__(self, title="", message="", level="warning"): """Create an error message object, populated with details""" self.title = title self.message = message self.level = level def show(self): """Display the stored error message""" box_call = self.levels[self.level] box_call(None, self.title, self.message) if self.level == "error": sys.exit() class OpenShotApp(QApplication): """The primary QApplication subclass for OpenShot.""" def __init__(self, *args, **kwargs): self.mode = kwargs.pop("mode", None) super().__init__(*args, **kwargs) self.args = super().arguments() self.errors = [] try: # Import modules from classes import info from classes.logger import log, reroute_output # Log the session's start if self.mode != "unittest": import time log.info("-" * 48) log.info(time.asctime().center(48)) log.info('Starting new session'.center(48)) log.debug("Command line: %s", self.args) from classes import settings, project_data, updates, update_queue as update_queue_module, task_queue, sentry import openshot # Re-route stdout and stderr to logger if self.mode != "unittest": reroute_output() # Suppress noisy QWebChannel warnings (TimelineView properties without notify signals) qInstallMessageHandler(_qt_message_handler) except ImportError as ex: tb = traceback.format_exc() log.error('OpenShotApp::Import Error', exc_info=1) self.errors.append(StartupError( "Import Error", "Module: %(name)s\n\n%(tb)s" % {"name": ex.name, "tb": tb}, level="error")) # Stop launching raise except Exception: log.error('OpenShotApp::Init Error', exc_info=1) sys.exit() self.info = info # Log some basic system info self.log = log self.show_environment(info, openshot) if self.mode != "unittest": self.check_libopenshot_version(info, openshot) # Init data objects self.settings = settings.SettingStore(parent=self) self.settings.load() self.apply_timeline_backend_preference() self.project = project_data.ProjectDataStore() self._update_manager = updates.UpdateManager() self.update_queue = update_queue_module.UpdateQueue(self._update_manager) self.updates = update_queue_module.UpdatesRouter(self._update_manager, self.update_queue) # It is important that the project is the first listener if the key gets update self.updates.add_listener(self.project) self.updates.reset() self.task_queue = task_queue.VideoTaskQueue(parent=self) # Set location of OpenShot program (for libopenshot) openshot.Settings.Instance().PATH_OPENSHOT_INSTALL = info.PATH # Set BABL extensions path babl_ext_path = os.path.join(info.PATH, "lib", "babl-ext") [truncated — 7926 more characters] ``` ### remotion-service/src/templates/ProductLaunch/index.tsx ```typescript import {AbsoluteFill, Sequence, useVideoConfig} from 'remotion'; import {IntroScene} from './IntroScene'; import {StatsScene} from './StatsScene'; import {FeaturesScene} from './FeaturesScene'; import {OutroScene} from './OutroScene'; export interface ProductLaunchProps { repoName: string; description: string; stars: number; forks: number; language: string; features: string[]; githubUrl: string; homepage?: string; } export const ProductLaunch: React.FC = ({ repoName, description, stars, forks, language, features, githubUrl, homepage, }) => { const {fps} = useVideoConfig(); // Scene durations (in frames) const introDuration = fps * 3; // 3 seconds const statsDuration = fps * 4; // 4 seconds const featuresDuration = fps * 4; // 4 seconds const outroDuration = fps * 3; // 3 seconds return ( {/* Intro: 0-90 frames */} {/* Stats: 90-210 frames */} {/* Features: 210-330 frames (if any) */} {features.length > 0 && ( )} {/* Outro: 330-420 frames */} 0 ? featuresDuration : 0)} durationInFrames={outroDuration} > ); }; ``` ### .venv.broken_backup/lib/python3.10/site-packages/websockets/cli.py ```python from __future__ import annotations import argparse import asyncio import os import sys from typing import Generator from .asyncio.client import ClientConnection, connect from .asyncio.messages import SimpleQueue from .exceptions import ConnectionClosed from .frames import Close from .streams import StreamReader from .version import version as websockets_version __all__ = ["main"] def print_during_input(string: str) -> None: sys.stdout.write( # Save cursor position "\N{ESC}7" # Add a new line "\N{LINE FEED}" # Move cursor up "\N{ESC}[A" # Insert blank line, scroll last line down "\N{ESC}[L" # Print string in the inserted blank line f"{string}\N{LINE FEED}" # Restore cursor position "\N{ESC}8" # Move cursor down "\N{ESC}[B" ) sys.stdout.flush() def print_over_input(string: str) -> None: sys.stdout.write( # Move cursor to beginning of line "\N{CARRIAGE RETURN}" # Delete current line "\N{ESC}[K" # Print string f"{string}\N{LINE FEED}" ) sys.stdout.flush() class ReadLines(asyncio.Protocol): def __init__(self) -> None: self.reader = StreamReader() self.messages: SimpleQueue[str] = SimpleQueue() def parse(self) -> Generator[None, None, None]: while True: sys.stdout.write("> ") sys.stdout.flush() line = yield from self.reader.read_line(sys.maxsize) self.messages.put(line.decode().rstrip("\r\n")) def connection_made(self, transport: asyncio.BaseTransport) -> None: self.parser = self.parse() next(self.parser) def data_received(self, data: bytes) -> None: self.reader.feed_data(data) next(self.parser) def eof_received(self) -> None: self.reader.feed_eof() # next(self.parser) isn't useful and would raise EOFError. def connection_lost(self, exc: Exception | None) -> None: self.reader.discard() self.messages.abort() async def print_incoming_messages(websocket: ClientConnection) -> None: async for message in websocket: if isinstance(message, str): print_during_input("< " + message) else: print_during_input("< (binary) " + message.hex()) async def send_outgoing_messages( websocket: ClientConnection, messages: SimpleQueue[str], ) -> None: while True: try: message = await messages.get() except EOFError: break try: await websocket.send(message) except ConnectionClosed: # pragma: no cover break async def interactive_client(uri: str) -> None: try: websocket = await connect(uri) except Exception as exc: print(f"Failed to connect to {uri}: {exc}.") sys.exit(1) else: print(f"Connected to {uri}.") loop = asyncio.get_running_loop() transport, protocol = await loop.connect_read_pipe(ReadLines, sys.stdin) incoming = asyncio.create_task( print_incoming_messages(websocket), ) outgoing = asyncio.create_task( send_outgoing_messages(websocket, protocol.messages), ) try: await asyncio.wait( [incoming, outgoing], # Clean up and exit when the server closes the connection # or the user enters EOT (^D), whichever happens first. return_when=asyncio.FIRST_COMPLETED, ) # asyncio.run() cancels the main task when the user triggers SIGINT (^C). # https://docs.python.org/3/library/asyncio-runner.html#handling-keyboard-interruption # Clean up and exit without re-raising CancelledError to prevent Python # from raising KeyboardInterrupt and displaying a stack track. except asyncio.CancelledError: # pragma: no cover pass finally: incoming.cancel() outgoing.cancel() transport.close() await websocket.close() assert websocket.close_code is not None and websocket.close_reason is not None close_status = Close(websocket.close_code, websocket.close_reason) print_over_input(f"Connection closed: {close_status}.") def main(argv: list[str] | None = None) -> None: parser = argparse.ArgumentParser( prog="websockets", description="Interactive WebSocket client.", add_help=False, ) group = parser.add_mutually_exclusive_group() group.add_argument("--version", action="store_true") group.add_argument("uri", metavar="", nargs="?") args = parser.parse_args(argv) if args.version: print(f"websockets {websockets_version}") return if args.uri is None: parser.print_usage() sys.exit(2) # Enable VT100 to support ANSI escape codes in Command Prompt on Windows. # See https://github.com/python/cpython/issues/74261 for why this works. if sys.platform == "win32": os.system("") try: import readline # noqa: F401 except ImportError: # readline isn't available on all platforms pass # Remove the try/except block when dropping Python < 3.11. try: asyncio.run(interactive_client(args.uri)) except KeyboardInterrupt: # pragma: no cover pass ``` ### .venv.broken_backup/lib/python3.10/site-packages/dotenv/cli.py ```python import json import os import shlex import sys from contextlib import contextmanager from subprocess import Popen from typing import Any, Dict, IO, Iterator, List try: import click except ImportError: sys.stderr.write('It seems python-dotenv is not installed with cli option. \n' 'Run pip install "python-dotenv[cli]" to fix this.') sys.exit(1) from .main import dotenv_values, set_key, unset_key from .version import __version__ def enumerate_env(): """ Return a path for the ${pwd}/.env file. If pwd does not exist, return None. """ try: cwd = os.getcwd() except FileNotFoundError: return None path = os.path.join(cwd, '.env') return path @click.group() @click.option('-f', '--file', default=enumerate_env(), type=click.Path(file_okay=True), help="Location of the .env file, defaults to .env file in current working directory.") @click.option('-q', '--quote', default='always', type=click.Choice(['always', 'never', 'auto']), help="Whether to quote or not the variable values. Default mode is always. This does not affect parsing.") @click.option('-e', '--export', default=False, type=click.BOOL, help="Whether to write the dot file as an executable bash script.") @click.version_option(version=__version__) @click.pass_context def cli(ctx: click.Context, file: Any, quote: Any, export: Any) -> None: """This script is used to set, get or unset values from a .env file.""" ctx.obj = {'QUOTE': quote, 'EXPORT': export, 'FILE': file} @contextmanager def stream_file(path: os.PathLike) -> Iterator[IO[str]]: """ Open a file and yield the corresponding (decoded) stream. Exits with error code 2 if the file cannot be opened. """ try: with open(path) as stream: yield stream except OSError as exc: print(f"Error opening env file: {exc}", file=sys.stderr) exit(2) @cli.command() @click.pass_context @click.option('--format', default='simple', type=click.Choice(['simple', 'json', 'shell', 'export']), help="The format in which to display the list. Default format is simple, " "which displays name=value without quotes.") def list(ctx: click.Context, format: bool) -> None: """Display all the stored key/value.""" file = ctx.obj['FILE'] with stream_file(file) as stream: values = dotenv_values(stream=stream) if format == 'json': click.echo(json.dumps(values, indent=2, sort_keys=True)) else: prefix = 'export ' if format == 'export' else '' for k in sorted(values): v = values[k] if v is not None: if format in ('export', 'shell'): v = shlex.quote(v) click.echo(f'{prefix}{k}={v}') @cli.command() @click.pass_context @click.argument('key', required=True) @click.argument('value', required=True) def set(ctx: click.Context, key: Any, value: Any) -> None: """Store the given key/value.""" file = ctx.obj['FILE'] quote = ctx.obj['QUOTE'] export = ctx.obj['EXPORT'] success, key, value = set_key(file, key, value, quote, export) if success: click.echo(f'{key}={value}') else: exit(1) @cli.command() @click.pass_context @click.argument('key', required=True) def get(ctx: click.Context, key: Any) -> None: """Retrieve the value for the given key.""" file = ctx.obj['FILE'] with stream_file(file) as stream: values = dotenv_values(stream=stream) stored_value = values.get(key) if stored_value: click.echo(stored_value) else: exit(1) @cli.command() @click.pass_context @click.argument('key', required=True) def unset(ctx: click.Context, key: Any) -> None: """Removes the given key.""" file = ctx.obj['FILE'] quote = ctx.obj['QUOTE'] success, key = unset_key(file, key, quote) if success: click.echo(f"Successfully removed {key}") else: exit(1) @cli.command(context_settings={'ignore_unknown_options': True}) @click.pass_context @click.option( "--override/--no-override", default=True, help="Override variables from the environment file with those from the .env file.", ) @click.argument('commandline', nargs=-1, type=click.UNPROCESSED) def run(ctx: click.Context, override: bool, commandline: List[str]) -> None: """Run command with environment variables present.""" file = ctx.obj['FILE'] if not os.path.isfile(file): raise click.BadParameter( f'Invalid value for \'-f\' "{file}" does not exist.', ctx=ctx ) dotenv_as_dict = { k: v for (k, v) in dotenv_values(file).items() if v is not None and (override or k not in os.environ) } if not commandline: click.echo('No command given.') exit(1) ret = run_command(commandline, dotenv_as_dict) exit(ret) def run_command(command: List[str], env: Dict[str, str]) -> int: """Run command in sub process. Runs the command in a sub process with the variables from `env` added in the current environment variables. Parameters ---------- command: List[str] The command and it's parameters env: Dict The additional environment variables Returns ------- int The return code of the command """ # copy the current environment variables and add the vales from # `env` cmd_env = os.environ.copy() cmd_env.update(env) p = Popen(command, universal_newlines=True, bufsize=0, shell=False, env=cmd_env) _, _ = p.communicate() return p.returncode ``` [2648 more indexed source files omitted to keep this export small. The full file list is in the Codebase structure section above.]