pycapcut 0.0.2__tar.gz → 0.0.4__tar.gz

pycapcut-0.0.4/MANIFEST.in

@@ -0,0 +1,19 @@
+include README.md
+include english_readme.md
+include pypi_readme.md
+include requirements.txt
+recursive-include pycapcut *.py *.json
+
+prune tests
+prune tools
+prune ignored
+prune readme_assets
+prune build
+prune dist
+prune .git
+prune .vscode
+
+exclude AGENTS.md AGENTS.local.md CLAUDE.md
+exclude demo.py generate_example.py replace_example.py temp.py
+exclude .flake8 .gitignore
+global-exclude *.lnk *.log *.pyc *.pyo *.pyd .DS_Store Thumbs.db

pycapcut-0.0.4/PKG-INFO

@@ -0,0 +1,124 @@
+Metadata-Version: 2.1
+Name: pycapcut
+Version: 0.0.4
+Summary: A lightweight, flexible Python tool for generating and editing CapCut drafts
+Home-page: https://github.com/GuanYixuan/pycapcut
+Author: gary318
+License: UNKNOWN
+Description: <!-- Generated from english_readme.md by tools/generate_pypi_readme.py. Do not edit directly. -->
+        
+        # pyCapCut
+        
+        ### A lightweight, flexible Python tool for generating and editing CapCut drafts
+        
+        [中文版本](https://github.com/GuanYixuan/pyCapCut/blob/main/README.md)
+        
+        > This project shares its origins with [PyJianYingDraft](https://github.com/GuanYixuan/pyJianYingDraft) and targets CapCut drafts.
+        
+        > ⚠️ **0.1.0 preview**: The next version will align track ordering and references with pyJianYingDraft, introduce `append_track(s)` / `insert_track(s)` and `TrackSpec` / `TrackRef`, and remove `add_track`. Scripts that depend on the old API or track layering behavior will need updating; a migration guide will accompany the release. To keep the current behavior, pin `pip install pycapcut==0.0.4` and refer to that version's [documentation](https://github.com/GuanYixuan/pyCapCut/blob/0.0.4/english_readme.md) and [example](https://github.com/GuanYixuan/pyCapCut/blob/0.0.4/demo.py).
+        
+        > 📢 Join the [Discord server](https://discord.gg/WfHgGQvhyW) to discuss usage and new features
+        
+        ## Workflow
+        
+        ![Workflow](https://github.com/GuanYixuan/pyCapCut/raw/main/readme_assets/%E4%BD%BF%E7%94%A8%E6%80%9D%E8%B7%AF.jpg)
+        
+        Open the generated draft in CapCut and export the video manually. Automated export is currently unsupported.
+        
+        # Feature List
+        
+        ✅ Supported. The validation version column lists confirmed CapCut versions; “—” means no version is recorded. It does not specify a minimum version or guarantee compatibility with every version.
+        
+        ### Video and Image
+        
+        | Feature | Support | Validation version |
+        |---|---|---|
+        | Local video/image media and [timing](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#source-trimming-and-global-speed) | ✅ | 8.2.0 |
+        | [Global video adjustments](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#global-video-adjustments) | ✅ | 8.2.0 |
+        | [Video keyframes](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#keyframes) | ✅ | — |
+        | [Video masks](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#masks) | ✅ | 9.5.0.4050 |
+        | [Video chroma keying](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#add-chroma-keying) | ✅ | 9.5.0.4050 |
+        | [Video blend modes](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#set-segment-blend-mode) | ✅ | 9.5.0.4050 |
+        | Video background fill [(example)](https://github.com/GuanYixuan/pyCapCut/blob/main/demo.py) | ✅ | — |
+        | [Audio fades](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#audio-fades) for videos with audio | ✅ | — |
+        | [Pitch change during speed adjustment](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#pitch-change-during-speed-adjustment) for videos with audio | ✅ | 9.5.0.4050 |
+        
+        ### Stickers
+        
+        | Feature | Support | Validation version |
+        |---|---|---|
+        | Add stickers using [resource metadata](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#extract-resource-metadata) | ✅ | — |
+        | [Sticker keyframes](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#keyframes) | ✅ | — |
+        
+        ### Audio
+        
+        | Feature | Support | Validation version |
+        |---|---|---|
+        | Local audio media and [timing](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#source-trimming-and-global-speed) | ✅ | 9.5.0.4050 |
+        | [Audio fades](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#audio-fades), volume and [keyframes](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#keyframes) | ✅ | — |
+        | [Pitch change during speed adjustment](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#pitch-change-during-speed-adjustment) | ✅ | 9.5.0.4050 |
+        | [Scene audio effects](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#add-segment-effects) | ✅ | — |
+        | [Tone effects](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#add-segment-effects) | ✅ | 9.5.0.4050 (花栗鼠) |
+        
+        ### Tracks
+        
+        | Feature | Support | Validation version |
+        |---|---|---|
+        | [Add tracks and segments](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#multi-track-operations) | ✅ | 8.2.0 |
+        | [Track layer ordering](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#multi-track-operations) | ✅ | 8.2.0 (video tracks) |
+        | [Main track magnet](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#main-track-magnet) | ✅ | 8.2.0 |
+        
+        ### Effects, Filters, and Transitions
+        
+        | Feature | Support | Validation version |
+        |---|---|---|
+        | [Video segment animations](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#add-segment-animations) | ✅ | — |
+        | [Video segment effects](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#add-segment-effects) | ✅ | — |
+        | [Video segment filters](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#add-segment-filters) | ✅ | — |
+        | [Standalone effect and filter tracks](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#effect-and-filter-tracks) | ✅ | — |
+        | Transitions [(example)](https://github.com/GuanYixuan/pyCapCut/blob/main/demo.py) | ✅ | — |
+        
+        ### Text and Subtitles
+        
+        | Feature | Support | Validation version |
+        |---|---|---|
+        | [Text and styles](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#add-text) | ✅ | 8.2.0 |
+        | [Fonts](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#add-text) | ✅ | 9.5.0.4050 |
+        | [Text keyframes](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#keyframes) | ✅ | — |
+        | [Text animations](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#add-segment-animations) | ✅ | — |
+        | Text stroke, background and shadow | ✅ | — |
+        | Text bubbles and fancy text [(example)](https://github.com/GuanYixuan/pyCapCut/blob/main/demo.py) | ✅ | 9.5.0.4050 (fancy text) |
+        | [Automatic line wrapping](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#automatic-line-wrapping) | ✅ | — |
+        | [Import SRT subtitles](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#import-subtitles) | ✅ | — |
+        
+        ### Template Mode
+        
+        | Feature | Support | Validation version |
+        |---|---|---|
+        | [Load plaintext drafts](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#load-template) | ✅ | 8.2.0 |
+        | [Replace media by name](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#replace-media-by-name) | ✅ | — |
+        | [Replace media by segment](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#replace-media-by-segment) | ✅ | — |
+        | [Replace text content](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#replace-text-segment-content) | ✅ | — |
+        | [Import template tracks](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#import-tracks-from-a-template-draft) | ✅ | — |
+        | [Extract resource metadata](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#extract-resource-metadata) | ✅ | — |
+        
+        # Installation
+        
+        pyCapCut now supports pip installation (excluding demo).
+        
+        ```bash
+        pip install pycapcut
+        ```
+        
+        ### Cross-platform Compatibility
+        
+        Install the library on Windows, Linux or macOS to generate and edit drafts. **Open the generated drafts in CapCut for Windows and export videos manually.**
+        
+        For complete usage examples, see the [full documentation](https://github.com/GuanYixuan/pyCapCut/blob/main/english_readme.md#quick-start).
+        
+Platform: UNKNOWN
+Classifier: Programming Language :: Python :: 3
+Classifier: Development Status :: 4 - Beta
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown