renoise-kit 0.5.0__tar.gz → 0.6.0__tar.gz

{renoise_kit-0.5.0/renoise_kit.egg-info → renoise_kit-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: renoise-kit
-Version: 0.5.0
+Version: 0.6.0
 Summary: rn: frame-exact probing, contact sheets, EDL assembly, finishing and QA for AI video edits
 License-Expression: MIT
 Project-URL: Homepage, https://renoise.ai
@@ -58,17 +58,20 @@ machine.
 
 `rn` drives the system's ffmpeg and ffprobe, version 7 or later, built with libass for burned-in subtitles.
 
-| | macOS | Debian / Ubuntu |
-|---|---|---|
-| ffmpeg with libass | `brew install ffmpeg-full`, then `export PATH="$(brew --prefix ffmpeg-full)/bin:$PATH"` (keg-only; Homebrew's plain `ffmpeg` has no libass) | `apt install ffmpeg fontconfig` |
-| OCR for `rn text` (optional) | comes with `ffmpeg-full` | `apt install tesseract-ocr tesseract-ocr-chi-sim` |
+| | macOS | Debian / Ubuntu | Windows 10 / 11 |
+|---|---|---|---|
+| ffmpeg with libass | `brew install ffmpeg-full`, then `export PATH="$(brew --prefix ffmpeg-full)/bin:$PATH"` (keg-only; Homebrew's plain `ffmpeg` has no libass) | `apt install ffmpeg fontconfig` | `winget install Gyan.FFmpeg` (the full build, libass and fontconfig included), then open a new terminal |
+| OCR for `rn text` (optional) | comes with `ffmpeg-full` | `apt install tesseract-ocr tesseract-ocr-chi-sim` | `winget install UB-Mannheim.TesseractOCR`, then add `C:\Program Files\Tesseract-OCR` to `PATH` |
 
 ```sh
-uv tool install 'renoise-kit[all]'     # or: pipx install 'renoise-kit[all]'
+uv tool install "renoise-kit[all]"     # or: pipx install "renoise-kit[all]"
 playwright install chromium            # only for rn capture
 rn --version
 ```
 
+The same commands work in a POSIX shell, PowerShell and cmd (hence the double quotes). On Windows `rn fonts` reads the
+system font folders directly when fontconfig is not installed, and `rn` writes UTF-8 when its output goes to a pipe.
+
 The core install is Pillow and numpy. Heavier dependencies come as extras, so you can install only what you use. When
 a command needs a missing extra, its error line names the extra to install.
 
@@ -112,16 +115,17 @@ window.renderFrame = i => {
 
 ```json
 {
+  "version": 2,
   "output": {"width": 1080, "height": 1920, "fps": 30},
   "tracks": [
     {"clips": [
       {"id": "open", "src": "shots/s1.mp4", "in": 0.4, "out": 3.2},
       {"id": "hero", "src": "shots/s2.mp4", "ranges": [[0, 1.5], [2.5, 4]],
        "transition": {"type": "fade", "duration": 0.3}},
-      {"id": "end", "image": "card.png", "duration": 1.5, "fit": "contain"}
+      {"id": "end", "image": "card.png", "duration": 1.5, "style": {"object-fit": "contain"}}
     ]},
     {"clips": [
-      {"id": "title", "frames": "title/%05d.png", "fps": 30, "y": 1500,
+      {"id": "title", "frames": "title/%05d.png", "fps": 30, "style": {"top": 1500},
        "at": {"clip": "hero", "offset": 0.2}, "until": {"clip_end": "hero"}}
     ]}
   ],
@@ -207,7 +211,7 @@ rn edit edit.json delete end --lift
 
 | Command | What it gives |
 |---|---|
-| `rn edit EDL ids\|set\|split\|delete\|insert\|move` | Changes an EDL by clip id. Each step is checked against the whole timeline before the file is written |
+| `rn edit EDL ids\|set\|split\|delete\|insert\|move\|upgrade` | Changes an EDL by clip id. Each step is checked against the whole timeline before the file is written |
 | `rn assemble EDL -o OUT [--preview] [--range A-B] [--placeholders]` | Renders the EDL frame-exactly. `--placeholders` turns missing shots into labelled cards |
 
 **Check and deliver**
@@ -221,8 +225,14 @@ rn edit edit.json delete end --lift
 
 ## The EDL in one screen
 
+- **Version.** `"version": 2`. A file without it uses the version-1 names (`x`, `y`, `w`, `h`, `fit`, `blend`) and is
+  upgraded on load; `rn edit FILE upgrade` rewrites it.
 - **Tracks.** `tracks[0]` is the main track: its clips play back to back. Later tracks are overlays, placed with `at`
-  in time and with `x / y / w / h` in space.
+  in time and with `style` in space.
+- **Style.** Placement and look under CSS names and units: `left`, `top`, `width`, `height` (px, `"90px"`, or `"50%"`
+  of the frame), `opacity`, `scale`, `rotate` (degrees), `object-fit` (`cover`, `contain`, `fill`) and
+  `mix-blend-mode` (the CSS modes). The main track fills the frame, so it takes only `object-fit`, `left`, `top`,
+  `scale` and `rotate`.
 - **Audio items.** Items in `audio` are placed with `at`. `role` is `music`, `voice` or `sfx`; music ducks under voice
   when `mix.duck_db` is set.
 - **One time grid.** `output.fps` is the only clock. A clip of N seconds is exactly `round(N × fps)` frames.
@@ -236,14 +246,17 @@ rn edit edit.json delete end --lift
   - `{"beat": n, "listen": file}` and `{"word": n, "listen": file}`
 
   `pivot` places a point inside the source on the anchor instead of the source's start.
-- **Keys.** Written as `[t, value, ease]`. Overlays animate `scale`, `x`, `y`, `rotate`, `opacity` and `speed`; the
-  main track `scale`, `x`, `y`, `rotate`, `speed` and `gain_db`; audio items `gain_db`.
-- **Compositing.** `blend` takes `screen`, `multiply`, `add` and other blend modes. `mask` takes a full-frame matte, as
-  luma or alpha, optionally inverted. `vf` and `af` insert one raw ffmpeg filter chain.
+- **Keys.** Written as `[t, value, ease]`: the moving form of a style value. Overlays animate `scale`, `left`, `top`,
+  `rotate`, `opacity` and `speed`; the main track `scale`, `left`, `top`, `rotate`, `speed` and `gain_db`; audio items
+  `gain_db`.
+- **Compositing.** `mask` takes a full-frame matte, as luma or alpha, optionally inverted. `vf` and `af` insert one raw
+  ffmpeg filter chain.
 - **Bookkeeping.** `id` and `meta` go on anything; `meta` is kept as given. `accept` waives qa warnings judged
   intended.
 
-The full schema is in `rn assemble --help` and [SPEC.md](SPEC.md) §4.
+The full schema is [schema/edit.schema.json](schema/edit.schema.json), with `rn assemble --help` and [SPEC.md](SPEC.md)
+§4. Fields it marks `x-rn-only` (raw filters, masks, image sequences, nested edits, beat and word anchors, delivery
+loudness, subtitles) are rn's own; another program that renders the rest of the format previews what rn delivers.
 
 ## Conventions
 
@@ -286,8 +299,9 @@ In the Renoise media sandbox, `rn` comes preinstalled at the version pinned by t
 uv run pytest -q    # Python 3.12 (as the sandbox); needs ffmpeg with libass; playwright install chromium for capture tests
 ```
 
-CI runs on Debian trixie with ffmpeg 7.1 (the same base as the sandbox) and on macOS with ffmpeg-full. The tests
-generate their own media.
+CI runs on Debian trixie with ffmpeg 7.1 (the same base as the sandbox), on macOS with ffmpeg-full and on Windows with
+gyan.dev's full build (with Windows' own default encoding, so a file read without `encoding='utf-8'` fails there). The
+tests generate their own media.
 
 To release:
 

{renoise_kit-0.5.0 → renoise_kit-0.6.0}/README.md

@@ -22,17 +22,20 @@ machine.
 
 `rn` drives the system's ffmpeg and ffprobe, version 7 or later, built with libass for burned-in subtitles.
 
-| | macOS | Debian / Ubuntu |
-|---|---|---|
-| ffmpeg with libass | `brew install ffmpeg-full`, then `export PATH="$(brew --prefix ffmpeg-full)/bin:$PATH"` (keg-only; Homebrew's plain `ffmpeg` has no libass) | `apt install ffmpeg fontconfig` |
-| OCR for `rn text` (optional) | comes with `ffmpeg-full` | `apt install tesseract-ocr tesseract-ocr-chi-sim` |
+| | macOS | Debian / Ubuntu | Windows 10 / 11 |
+|---|---|---|---|
+| ffmpeg with libass | `brew install ffmpeg-full`, then `export PATH="$(brew --prefix ffmpeg-full)/bin:$PATH"` (keg-only; Homebrew's plain `ffmpeg` has no libass) | `apt install ffmpeg fontconfig` | `winget install Gyan.FFmpeg` (the full build, libass and fontconfig included), then open a new terminal |
+| OCR for `rn text` (optional) | comes with `ffmpeg-full` | `apt install tesseract-ocr tesseract-ocr-chi-sim` | `winget install UB-Mannheim.TesseractOCR`, then add `C:\Program Files\Tesseract-OCR` to `PATH` |
 
 ```sh
-uv tool install 'renoise-kit[all]'     # or: pipx install 'renoise-kit[all]'
+uv tool install "renoise-kit[all]"     # or: pipx install "renoise-kit[all]"
 playwright install chromium            # only for rn capture
 rn --version
 ```
 
+The same commands work in a POSIX shell, PowerShell and cmd (hence the double quotes). On Windows `rn fonts` reads the
+system font folders directly when fontconfig is not installed, and `rn` writes UTF-8 when its output goes to a pipe.
+
 The core install is Pillow and numpy. Heavier dependencies come as extras, so you can install only what you use. When
 a command needs a missing extra, its error line names the extra to install.
 
@@ -76,16 +79,17 @@ window.renderFrame = i => {
 
 ```json
 {
+  "version": 2,
   "output": {"width": 1080, "height": 1920, "fps": 30},
   "tracks": [
     {"clips": [
       {"id": "open", "src": "shots/s1.mp4", "in": 0.4, "out": 3.2},
       {"id": "hero", "src": "shots/s2.mp4", "ranges": [[0, 1.5], [2.5, 4]],
        "transition": {"type": "fade", "duration": 0.3}},
-      {"id": "end", "image": "card.png", "duration": 1.5, "fit": "contain"}
+      {"id": "end", "image": "card.png", "duration": 1.5, "style": {"object-fit": "contain"}}
     ]},
     {"clips": [
-      {"id": "title", "frames": "title/%05d.png", "fps": 30, "y": 1500,
+      {"id": "title", "frames": "title/%05d.png", "fps": 30, "style": {"top": 1500},
        "at": {"clip": "hero", "offset": 0.2}, "until": {"clip_end": "hero"}}
     ]}
   ],
@@ -171,7 +175,7 @@ rn edit edit.json delete end --lift
 
 | Command | What it gives |
 |---|---|
-| `rn edit EDL ids\|set\|split\|delete\|insert\|move` | Changes an EDL by clip id. Each step is checked against the whole timeline before the file is written |
+| `rn edit EDL ids\|set\|split\|delete\|insert\|move\|upgrade` | Changes an EDL by clip id. Each step is checked against the whole timeline before the file is written |
 | `rn assemble EDL -o OUT [--preview] [--range A-B] [--placeholders]` | Renders the EDL frame-exactly. `--placeholders` turns missing shots into labelled cards |
 
 **Check and deliver**
@@ -185,8 +189,14 @@ rn edit edit.json delete end --lift
 
 ## The EDL in one screen
 
+- **Version.** `"version": 2`. A file without it uses the version-1 names (`x`, `y`, `w`, `h`, `fit`, `blend`) and is
+  upgraded on load; `rn edit FILE upgrade` rewrites it.
 - **Tracks.** `tracks[0]` is the main track: its clips play back to back. Later tracks are overlays, placed with `at`
-  in time and with `x / y / w / h` in space.
+  in time and with `style` in space.
+- **Style.** Placement and look under CSS names and units: `left`, `top`, `width`, `height` (px, `"90px"`, or `"50%"`
+  of the frame), `opacity`, `scale`, `rotate` (degrees), `object-fit` (`cover`, `contain`, `fill`) and
+  `mix-blend-mode` (the CSS modes). The main track fills the frame, so it takes only `object-fit`, `left`, `top`,
+  `scale` and `rotate`.
 - **Audio items.** Items in `audio` are placed with `at`. `role` is `music`, `voice` or `sfx`; music ducks under voice
   when `mix.duck_db` is set.
 - **One time grid.** `output.fps` is the only clock. A clip of N seconds is exactly `round(N × fps)` frames.
@@ -200,14 +210,17 @@ rn edit edit.json delete end --lift
   - `{"beat": n, "listen": file}` and `{"word": n, "listen": file}`
 
   `pivot` places a point inside the source on the anchor instead of the source's start.
-- **Keys.** Written as `[t, value, ease]`. Overlays animate `scale`, `x`, `y`, `rotate`, `opacity` and `speed`; the
-  main track `scale`, `x`, `y`, `rotate`, `speed` and `gain_db`; audio items `gain_db`.
-- **Compositing.** `blend` takes `screen`, `multiply`, `add` and other blend modes. `mask` takes a full-frame matte, as
-  luma or alpha, optionally inverted. `vf` and `af` insert one raw ffmpeg filter chain.
+- **Keys.** Written as `[t, value, ease]`: the moving form of a style value. Overlays animate `scale`, `left`, `top`,
+  `rotate`, `opacity` and `speed`; the main track `scale`, `left`, `top`, `rotate`, `speed` and `gain_db`; audio items
+  `gain_db`.
+- **Compositing.** `mask` takes a full-frame matte, as luma or alpha, optionally inverted. `vf` and `af` insert one raw
+  ffmpeg filter chain.
 - **Bookkeeping.** `id` and `meta` go on anything; `meta` is kept as given. `accept` waives qa warnings judged
   intended.
 
-The full schema is in `rn assemble --help` and [SPEC.md](SPEC.md) §4.
+The full schema is [schema/edit.schema.json](schema/edit.schema.json), with `rn assemble --help` and [SPEC.md](SPEC.md)
+§4. Fields it marks `x-rn-only` (raw filters, masks, image sequences, nested edits, beat and word anchors, delivery
+loudness, subtitles) are rn's own; another program that renders the rest of the format previews what rn delivers.
 
 ## Conventions
 
@@ -250,8 +263,9 @@ In the Renoise media sandbox, `rn` comes preinstalled at the version pinned by t
 uv run pytest -q    # Python 3.12 (as the sandbox); needs ffmpeg with libass; playwright install chromium for capture tests
 ```
 
-CI runs on Debian trixie with ffmpeg 7.1 (the same base as the sandbox) and on macOS with ffmpeg-full. The tests
-generate their own media.
+CI runs on Debian trixie with ffmpeg 7.1 (the same base as the sandbox), on macOS with ffmpeg-full and on Windows with
+gyan.dev's full build (with Windows' own default encoding, so a file read without `encoding='utf-8'` fails there). The
+tests generate their own media.
 
 To release:
 

{renoise_kit-0.5.0 → renoise_kit-0.6.0}/pyproject.toml

@@ -23,7 +23,7 @@ all = ["renoise-kit[listen,transcribe,faces,capture,captions,fonts,matte,export]
 # uv run pytest. faster-whisper and rembg are left out (large models); their tests skip, as OCR does without tesseract.
 [dependency-groups]
 dev = ["pytest", "librosa", "matplotlib", "opencv-python-headless>=4.8", "pysubs2", "playwright", "fonttools", "opentimelineio",
-       "otio-fcpx-xml-adapter", "otio-fcp-adapter"]
+       "otio-fcpx-xml-adapter", "otio-fcp-adapter", "jsonschema"]
 
 [project.urls]
 Homepage = "https://renoise.ai"

{renoise_kit-0.5.0 → renoise_kit-0.6.0/renoise_kit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: renoise-kit
-Version: 0.5.0
+Version: 0.6.0
 Summary: rn: frame-exact probing, contact sheets, EDL assembly, finishing and QA for AI video edits
 License-Expression: MIT
 Project-URL: Homepage, https://renoise.ai
@@ -58,17 +58,20 @@ machine.
 
 `rn` drives the system's ffmpeg and ffprobe, version 7 or later, built with libass for burned-in subtitles.
 
-| | macOS | Debian / Ubuntu |
-|---|---|---|
-| ffmpeg with libass | `brew install ffmpeg-full`, then `export PATH="$(brew --prefix ffmpeg-full)/bin:$PATH"` (keg-only; Homebrew's plain `ffmpeg` has no libass) | `apt install ffmpeg fontconfig` |
-| OCR for `rn text` (optional) | comes with `ffmpeg-full` | `apt install tesseract-ocr tesseract-ocr-chi-sim` |
+| | macOS | Debian / Ubuntu | Windows 10 / 11 |
+|---|---|---|---|
+| ffmpeg with libass | `brew install ffmpeg-full`, then `export PATH="$(brew --prefix ffmpeg-full)/bin:$PATH"` (keg-only; Homebrew's plain `ffmpeg` has no libass) | `apt install ffmpeg fontconfig` | `winget install Gyan.FFmpeg` (the full build, libass and fontconfig included), then open a new terminal |
+| OCR for `rn text` (optional) | comes with `ffmpeg-full` | `apt install tesseract-ocr tesseract-ocr-chi-sim` | `winget install UB-Mannheim.TesseractOCR`, then add `C:\Program Files\Tesseract-OCR` to `PATH` |
 
 ```sh
-uv tool install 'renoise-kit[all]'     # or: pipx install 'renoise-kit[all]'
+uv tool install "renoise-kit[all]"     # or: pipx install "renoise-kit[all]"
 playwright install chromium            # only for rn capture
 rn --version
 ```
 
+The same commands work in a POSIX shell, PowerShell and cmd (hence the double quotes). On Windows `rn fonts` reads the
+system font folders directly when fontconfig is not installed, and `rn` writes UTF-8 when its output goes to a pipe.
+
 The core install is Pillow and numpy. Heavier dependencies come as extras, so you can install only what you use. When
 a command needs a missing extra, its error line names the extra to install.
 
@@ -112,16 +115,17 @@ window.renderFrame = i => {
 
 ```json
 {
+  "version": 2,
   "output": {"width": 1080, "height": 1920, "fps": 30},
   "tracks": [
     {"clips": [
       {"id": "open", "src": "shots/s1.mp4", "in": 0.4, "out": 3.2},
       {"id": "hero", "src": "shots/s2.mp4", "ranges": [[0, 1.5], [2.5, 4]],
        "transition": {"type": "fade", "duration": 0.3}},
-      {"id": "end", "image": "card.png", "duration": 1.5, "fit": "contain"}
+      {"id": "end", "image": "card.png", "duration": 1.5, "style": {"object-fit": "contain"}}
     ]},
     {"clips": [
-      {"id": "title", "frames": "title/%05d.png", "fps": 30, "y": 1500,
+      {"id": "title", "frames": "title/%05d.png", "fps": 30, "style": {"top": 1500},
        "at": {"clip": "hero", "offset": 0.2}, "until": {"clip_end": "hero"}}
     ]}
   ],
@@ -207,7 +211,7 @@ rn edit edit.json delete end --lift
 
 | Command | What it gives |
 |---|---|
-| `rn edit EDL ids\|set\|split\|delete\|insert\|move` | Changes an EDL by clip id. Each step is checked against the whole timeline before the file is written |
+| `rn edit EDL ids\|set\|split\|delete\|insert\|move\|upgrade` | Changes an EDL by clip id. Each step is checked against the whole timeline before the file is written |
 | `rn assemble EDL -o OUT [--preview] [--range A-B] [--placeholders]` | Renders the EDL frame-exactly. `--placeholders` turns missing shots into labelled cards |
 
 **Check and deliver**
@@ -221,8 +225,14 @@ rn edit edit.json delete end --lift
 
 ## The EDL in one screen
 
+- **Version.** `"version": 2`. A file without it uses the version-1 names (`x`, `y`, `w`, `h`, `fit`, `blend`) and is
+  upgraded on load; `rn edit FILE upgrade` rewrites it.
 - **Tracks.** `tracks[0]` is the main track: its clips play back to back. Later tracks are overlays, placed with `at`
-  in time and with `x / y / w / h` in space.
+  in time and with `style` in space.
+- **Style.** Placement and look under CSS names and units: `left`, `top`, `width`, `height` (px, `"90px"`, or `"50%"`
+  of the frame), `opacity`, `scale`, `rotate` (degrees), `object-fit` (`cover`, `contain`, `fill`) and
+  `mix-blend-mode` (the CSS modes). The main track fills the frame, so it takes only `object-fit`, `left`, `top`,
+  `scale` and `rotate`.
 - **Audio items.** Items in `audio` are placed with `at`. `role` is `music`, `voice` or `sfx`; music ducks under voice
   when `mix.duck_db` is set.
 - **One time grid.** `output.fps` is the only clock. A clip of N seconds is exactly `round(N × fps)` frames.
@@ -236,14 +246,17 @@ rn edit edit.json delete end --lift
   - `{"beat": n, "listen": file}` and `{"word": n, "listen": file}`
 
   `pivot` places a point inside the source on the anchor instead of the source's start.
-- **Keys.** Written as `[t, value, ease]`. Overlays animate `scale`, `x`, `y`, `rotate`, `opacity` and `speed`; the
-  main track `scale`, `x`, `y`, `rotate`, `speed` and `gain_db`; audio items `gain_db`.
-- **Compositing.** `blend` takes `screen`, `multiply`, `add` and other blend modes. `mask` takes a full-frame matte, as
-  luma or alpha, optionally inverted. `vf` and `af` insert one raw ffmpeg filter chain.
+- **Keys.** Written as `[t, value, ease]`: the moving form of a style value. Overlays animate `scale`, `left`, `top`,
+  `rotate`, `opacity` and `speed`; the main track `scale`, `left`, `top`, `rotate`, `speed` and `gain_db`; audio items
+  `gain_db`.
+- **Compositing.** `mask` takes a full-frame matte, as luma or alpha, optionally inverted. `vf` and `af` insert one raw
+  ffmpeg filter chain.
 - **Bookkeeping.** `id` and `meta` go on anything; `meta` is kept as given. `accept` waives qa warnings judged
   intended.
 
-The full schema is in `rn assemble --help` and [SPEC.md](SPEC.md) §4.
+The full schema is [schema/edit.schema.json](schema/edit.schema.json), with `rn assemble --help` and [SPEC.md](SPEC.md)
+§4. Fields it marks `x-rn-only` (raw filters, masks, image sequences, nested edits, beat and word anchors, delivery
+loudness, subtitles) are rn's own; another program that renders the rest of the format previews what rn delivers.
 
 ## Conventions
 
@@ -286,8 +299,9 @@ In the Renoise media sandbox, `rn` comes preinstalled at the version pinned by t
 uv run pytest -q    # Python 3.12 (as the sandbox); needs ffmpeg with libass; playwright install chromium for capture tests
 ```
 
-CI runs on Debian trixie with ffmpeg 7.1 (the same base as the sandbox) and on macOS with ffmpeg-full. The tests
-generate their own media.
+CI runs on Debian trixie with ffmpeg 7.1 (the same base as the sandbox), on macOS with ffmpeg-full and on Windows with
+gyan.dev's full build (with Windows' own default encoding, so a file read without `encoding='utf-8'` fails there). The
+tests generate their own media.
 
 To release:
 

{renoise_kit-0.5.0 → renoise_kit-0.6.0}/renoise_kit.egg-info/SOURCES.txt

@@ -36,10 +36,12 @@ rn/fx/__init__.py
 rn/fx/fx.js
 tests/test_captions.py
 tests/test_capture.py
+tests/test_edit_v2.py
 tests/test_edl_v3.py
 tests/test_faces.py
 tests/test_fx.py
 tests/test_listen.py
+tests/test_portability.py
 tests/test_rn.py
 tests/test_v3_commands.py
 tests/test_v4_commands.py

{renoise_kit-0.5.0 → renoise_kit-0.6.0}/rn/__init__.py

@@ -1,2 +1,2 @@
 """Renoise kit (`rn`, PyPI `renoise-kit`). Released on its own; the media sandbox template pins a version."""
-__version__ = '0.5.0'
+__version__ = '0.6.0'

{renoise_kit-0.5.0 → renoise_kit-0.6.0}/rn/assemble.py

@@ -211,7 +211,9 @@ def _join(edit: Edit, slots: list[Path], work: Path) -> Path:
              '-map', '[v]', *INTERMEDIATE, '-r', str(edit.fps), '-y', str(piece)])
         pieces.append(piece)
     listing = work / 'main.txt'
-    listing.write_text(''.join(f"file '{piece.resolve()}'\n" for piece in pieces))
+    # Forward slashes work on every OS (a backslash is the demuxer's escape character); a quote closes and reopens.
+    quoted = (piece.resolve().as_posix().replace("'", "'\\''") for piece in pieces)
+    listing.write_text(''.join(f"file '{path}'\n" for path in quoted), encoding='utf-8')
     return listing
 
 
@@ -467,7 +469,7 @@ def _cached(cache: Path | None, key: str, suffix: str, work: Path, render) -> Pa
 def _fingerprint(path: Path, placeholders: bool) -> str:
     """A nested edit's render depends on its text and, recursively, on every file it reads."""
     edit = load(path, placeholders=placeholders)
-    parts = [__version__, path.read_text(), placeholders]
+    parts = [__version__, path.read_text(encoding='utf-8'), placeholders]
     for clip in edit.base + edit.overlays:
         parts.append(_fingerprint(clip.source, placeholders) if clip.kind == 'edit' else _files(clip.source, clip.kind == 'sequence'))
     parts += [_files(item.source) for item in edit.audio] + [_files(edit.subtitles)]

{renoise_kit-0.5.0 → renoise_kit-0.6.0}/rn/assets.py

@@ -56,7 +56,7 @@ def fetch_checked(source: str, digest: str, cached: Path, *, name: str) -> Path:
     if hasher.hexdigest() != digest:
         partial.unlink()
         raise RnError(f'{name}: checksum mismatch, refusing the download')
-    partial.rename(cached)
+    partial.replace(cached)  # rename() refuses to overwrite on Windows
     return cached
 
 

{renoise_kit-0.5.0 → renoise_kit-0.6.0}/rn/audio.py

@@ -20,7 +20,7 @@ MAX_LIMITER_PASSES = 6
 def measure(path: str | Path, *, stream: str = 'a:0') -> dict:
     """Integrated loudness (LUFS), loudness range and true peak (dBTP) via ebur128."""
     result = subprocess.run(['ffmpeg', '-hide_banner', '-nostdin', '-i', str(path), '-map', f'0:{stream}',
-                             '-af', 'ebur128=peak=true:framelog=quiet', '-f', 'null', '-'], capture_output=True, text=True)
+                             '-af', 'ebur128=peak=true:framelog=quiet', '-f', 'null', '-'], capture_output=True, text=True, encoding='utf-8', errors='replace')
     if result.returncode != 0:
         raise RnError(f'loudness measurement failed: {result.stderr.strip().splitlines()[-1:]}')
     summary = result.stderr[result.stderr.rfind('Summary:'):]

{renoise_kit-0.5.0 → renoise_kit-0.6.0}/rn/captions.py

@@ -7,6 +7,7 @@ from __future__ import annotations
 
 import json
 import re
+import sys
 import unicodedata
 from difflib import SequenceMatcher
 from pathlib import Path
@@ -27,7 +28,9 @@ OPENERS = set('「『（([“‘《〈【')
 SENTENCE_END = set('。！？.!?…‼⁇')
 SOFT_BREAK = set('，、；：,;:—')
 CLOSERS = set('」』）)]”’》〉】"\'')
-FONTS = {'zh': 'Noto Sans CJK SC', 'yue': 'Noto Sans CJK SC', 'ja': 'Noto Sans CJK JP', 'ko': 'Noto Sans CJK KR'}
+FONTS = {'zh': 'Noto Sans CJK SC', 'yue': 'Noto Sans CJK SC', 'ja': 'Noto Sans CJK JP', 'ko': 'Noto Sans CJK KR', '': 'Noto Sans'}
+# Windows ships no Noto face and libass would fall back silently, so name the faces every Windows has.
+WINDOWS_FONTS = {'zh': 'Microsoft YaHei', 'yue': 'Microsoft YaHei', 'ja': 'Yu Gothic', 'ko': 'Malgun Gothic', '': 'Segoe UI'}
 PAUSE_BREAK = 0.5  # seconds of silence that ends a caption
 
 
@@ -220,7 +223,7 @@ def captions_command(words_json: str, *, script: str | None = None, faces_json:
     if width <= 0 or height <= 0 or max_lines < 1 or min_duration > max_duration:
         raise RnError('captions: width/height must be positive, max_lines >= 1, min_duration <= max_duration')
     try:
-        listen = json.loads(Path(words_json).read_text(encoding='utf-8'))
+        listen = json.loads(Path(words_json).read_text(encoding='utf-8-sig'))
     except (OSError, ValueError) as error:
         raise RnError(f'cannot read words json {words_json}: {error}') from error
     words = [w for w in listen.get('words', []) if str(w.get('word', '')).strip()]
@@ -234,7 +237,7 @@ def captions_command(words_json: str, *, script: str | None = None, faces_json:
     alignment = None
     if script is not None:
         try:
-            script_text = Path(script).read_text(encoding='utf-8')
+            script_text = Path(script).read_text(encoding='utf-8-sig')
         except OSError as error:
             raise RnError(f'cannot read script {script}: {error}') from error
         script_units = _script_units(script_text, cjk)
@@ -251,7 +254,8 @@ def captions_command(words_json: str, *, script: str | None = None, faces_json:
     max_chars = max_chars or max(4, round(BASE_CHARS['cjk' if cjk else 'latin'] * width / 1080))
     em_per_char = 1.0 if cjk else LATIN_EM
     font_size = round(min(height * (0.03 if height > width else 0.05), safe_width / (max_chars * em_per_char)))
-    font_name = FONTS.get(language.split('-')[0].lower(), 'Noto Sans') if language else ('Noto Sans CJK SC' if cjk else 'Noto Sans')
+    fonts = WINDOWS_FONTS if sys.platform == 'win32' else FONTS
+    font_name = fonts.get(language.split('-')[0].lower(), fonts['']) if language else fonts['zh' if cjk else '']
 
     chunks = _chunk(units, max_chars=max_chars, max_lines=max_lines, min_duration=min_duration, max_duration=max_duration, cjk=cjk)
     for chunk in chunks:
@@ -263,7 +267,7 @@ def captions_command(words_json: str, *, script: str | None = None, faces_json:
     scale = (1.0, 1.0)
     if faces_json:
         try:
-            faces = json.loads(Path(faces_json).read_text(encoding='utf-8'))
+            faces = json.loads(Path(faces_json).read_text(encoding='utf-8-sig'))
         except (OSError, ValueError) as error:
             raise RnError(f'cannot read faces json {faces_json}: {error}') from error
         frames = faces.get('frames', [])

{renoise_kit-0.5.0 → renoise_kit-0.6.0}/rn/capture.py

@@ -22,7 +22,7 @@ FRAME_TIMEOUT_MS = 20_000
 def _init_script(fps: float, frames: int, width: int, height: int, shard: int) -> str:
     from .fx import js_path
     meta = json.dumps({'fps': fps, 'frames': frames, 'width': width, 'height': height, 'shard': shard})
-    return f'window.RN = {meta};\n' + js_path().read_text()
+    return f'window.RN = {meta};\n' + js_path().read_text(encoding='utf-8')
 
 
 def _shard(args: tuple) -> dict:
@@ -64,7 +64,7 @@ def capture_command(page: str, *, out: str, frames: int, width: int, height: int
     try:
         import playwright  # noqa: F401
     except ImportError:
-        raise RnError("rn capture needs playwright (extra \"capture\"): uv tool install 'renoise-kit[all]' && playwright install chromium") from None
+        raise RnError('rn capture needs playwright (extra "capture"): uv tool install "renoise-kit[all]" && playwright install chromium') from None
     out_dir = Path(out)
     out_dir.mkdir(parents=True, exist_ok=True)
     for stale in out_dir.glob('*.png'):

{renoise_kit-0.5.0 → renoise_kit-0.6.0}/rn/cli.py

@@ -9,6 +9,7 @@ from __future__ import annotations
 
 import argparse
 import json
+import os
 import shutil
 import sys
 from pathlib import Path
@@ -214,20 +215,21 @@ def _parser() -> argparse.ArgumentParser:
                    'ducking, LUFS target and encoded true peak <= limit. Output: H.264 High yuv420p bt709, moov first.\n'
                    'The EDL handles the mechanical assembly; render anything creative with your own code (rn capture for\n'
                    'HTML/canvas, numpy + rn.fx, Manim, Blender) to a PNG sequence or alpha clip and place it in the EDL.\n\n'
-                   'edit.json (paths relative to it; times in seconds; {"frame": n} also works for in/out;\n'
-                   '# marks notes below, not JSON; a "note" field is allowed on any clip):\n'
+                   'edit.json version 2 (paths relative to it; times in seconds; # marks notes below, not JSON; a "note"\n'
+                   'field is allowed anywhere; schema: schema/edit.schema.json in the renoise-kit repository):\n'
                    '{\n'
+                   '  "version": 2,\n'
                    '  "output": {"width": 1080, "height": 1920, "fps": 30, "background": "#000000", "crf": 18},\n'
                    '  "tracks": [\n'
                    '    {"clips": [                                  # track 0 = main track, clips back to back\n'
-                   '      {"src": "s1.mp4", "in": 0.4, "out": 3.2, "fit": "cover"},\n'
+                   '      {"src": "s1.mp4", "in": 0.4, "out": 3.2},\n'
                    '      {"src": "s2.mp4", "in": {"frame": 6}, "duration": 2.5, "speed": 0.5, "audio": false,\n'
                    '       "transition": {"type": "fade", "duration": 0.4}},   # any xfade name: dissolve, wipeleft, slideup...\n'
-                   '      {"image": "card.png", "duration": 1.5, "fit": "contain"},\n'
+                   '      {"image": "card.png", "duration": 1.5, "style": {"object-fit": "contain"}},\n'
                    '      {"color": "#000000", "duration": 0.5}]},\n'
-                   '    {"clips": [                                  # later tracks = overlays, positioned in time and space\n'
-                   '      {"image": "title.png", "at": 0.5, "duration": 2, "x": 90, "y": 1400, "w": 900,\n'
-                   '       "opacity": 1, "fade_in": 0.2, "fade_out": 0.2}]}],\n'
+                   '    {"clips": [                                  # later tracks = overlays, placed in time and space\n'
+                   '      {"image": "title.png", "at": 0.5, "duration": 2, "fade_in": 0.2, "fade_out": 0.2,\n'
+                   '       "style": {"left": 90, "top": "73%", "width": 900, "opacity": 0.9, "mix-blend-mode": "screen"}}]},\n'
                    '    {"clips": [{"frames": "title/%05d.png", "fps": 30, "at": {"clip": 1, "offset": 0.2},\n'
                    '                "until": {"clip_end": 1}, "keys": {"scale": [[0, 0.9], [0.3, 1, "out3"]], "opacity": [[0, 0], [0.2, 1]]}}]}],\n'
                    '  "markers": {"drop": 4.5},                                   # named times for anchors\n'
@@ -236,21 +238,27 @@ def _parser() -> argparse.ArgumentParser:
                    '  "subtitles": {"file": "captions.ass"},\n'
                    '  "mix": {"lufs": -14, "true_peak": -1.0, "duck_db": 10}            # duck music under voice\n'
                    '}\n'
+                   '"style" uses CSS names: overlays left/top/width/height (px: 90 or "90px"; "50%" of the frame), opacity,\n'
+                   'scale, rotate (degrees: 5 or "5deg"), object-fit (cover | contain | fill), mix-blend-mode (normal multiply\n'
+                   'screen overlay darken lighten color-dodge color-burn hard-light soft-light difference exclusion\n'
+                   'plus-lighter); the main track fills the frame: object-fit, left/top, scale, rotate.\n'
                    'Positions: in/out take seconds, {"frame": n} or {"shot": n, "offset": s} (shots from rn cuts).\n'
                    'Overlay "at"/"until" and audio "at" take seconds or an anchor + "offset": {"clip": i or "id"},\n'
                    '{"clip_end": i or "id"} (main-track clip as laid out, or an earlier overlay by id), {"marker": name},\n'
                    '{"frame": n}, {"beat": n, "listen": f.json}, {"word": n, "listen": f.json, "edge": "start"|"end"}.\n'
-                   'Keys [t, value, ease?] (t from the clip start; eases linear in out inout in3 out3 inout3 hold):\n'
-                   'main track scale/x/y/rotate (x, y as fractions of the frame), speed (a ramp; drops the clip\'s sound),\n'
-                   'gain_db; overlays scale/x/y/rotate/opacity/speed (x, y in px, about the layer centre); audio gain_db.\n'
-                   'Keep main-track scale >= 1: edges smear.\n'
+                   'Keys [t, value, ease?] (t from the clip start; eases linear in out inout in3 out3 inout3 hold), the\n'
+                   'moving form of a style value: main track scale/left/top/rotate (left, top: px the frame moves), speed\n'
+                   '(a ramp; drops the clip\'s sound), gain_db; overlays scale/left/top/rotate/opacity/speed (scale and rotate\n'
+                   'about the layer centre); audio gain_db. Keep main-track scale >= 1: edges smear.\n'
                    'Any clip or audio item: "id" (anchors, rn edit), "meta" (anything, kept as is), "vf" / "af" (one raw\n'
                    'ffmpeg filter chain, e.g. "eq=saturation=1.2,unsharp"; af on main-track clips and audio).\n'
                    'Main track: "ranges": [[in, out], ...] plays spans of one source back to back; "src": "part.json"\n'
-                   'plays another EDL. Overlays: "blend": screen|multiply|add|overlay|... ; "mask": {"frames"|"image"|"src":\n'
-                   '..., "mode": "luma"|"alpha", "invert": bool} (full frame, e.g. from rn matte). Overlays and audio:\n'
-                   '"pivot": s puts that point of the source (a hit, a downbeat) on "at". "mix": {"cut_fade": 0.01} fades\n'
-                   'every hard cut\'s own sound. "accept": [{"check", "at", "note"}] waives qa warnings judged intended.')
+                   'plays another edit. Overlays: "mask": {"frames"|"image"|"src": ..., "mode": "luma"|"alpha", "invert": bool}\n'
+                   '(full frame, e.g. from rn matte). Overlays and audio: "pivot": s puts that point of the source (a hit, a\n'
+                   'downbeat) on "at". "mix": {"cut_fade": 0.01} fades every hard cut\'s own sound. "accept": [{"check", "at",\n'
+                   '"note"}] waives qa warnings judged intended. A file without "version" uses the version-1 names (x, y, w,\n'
+                   'h, fit, blend; main-track keys x/y as fractions of the frame) and is upgraded on load; rn edit FILE\n'
+                   'upgrade rewrites it.')
     assemble.add_argument('edl')
     assemble.add_argument('-o', '--out', default='out.mp4')
     assemble.add_argument('--dry-run', action='store_true', help='validate and print the timeline without rendering')
@@ -277,6 +285,7 @@ def _parser() -> argparse.ArgumentParser:
     edit.add_argument('edl')
     ops = edit.add_subparsers(dest='op', required=True, metavar='op')
     ops.add_parser('ids', help='give every clip and audio item without an id one (c1.. main, o1.. overlays, a1.. audio)')
+    ops.add_parser('upgrade', help='rewrite a version-1 edit.json under version-2 names (style, keys left/top)')
     op_set = ops.add_parser('set', help='set fields: key=value (JSON when it parses), dotted keys reach into objects')
     op_set.add_argument('ref')
     op_set.add_argument('assignments', nargs='*', metavar='key=value')
@@ -442,6 +451,8 @@ def _run_summarized(args) -> tuple[dict, list[str]]:
         path = Path(args.edl)
         if args.op == 'ids':
             result = editops.ids_op(path)
+        elif args.op == 'upgrade':
+            result = editops.upgrade_op(path)
         elif args.op == 'set':
             result = editops.set_op(path, args.ref, args.assignments, args.unset)
         elif args.op == 'split':
@@ -492,6 +503,11 @@ def _run_summarized(args) -> tuple[dict, list[str]]:
 
 
 def main(argv: list[str] | None = None) -> int:
+    if sys.platform == 'win32' and not os.environ.get('PYTHONIOENCODING'):
+        # A pipe (an agent reading rn) would get the ANSI code page, which cannot hold every file name or caption.
+        for stream in (sys.stdout, sys.stderr):
+            if not stream.isatty() and hasattr(stream, 'reconfigure'):
+                stream.reconfigure(encoding='utf-8', errors='replace')
     args = _parser().parse_args(argv)
     for tool in ('ffmpeg', 'ffprobe'):
         if not shutil.which(tool):
@@ -536,7 +552,7 @@ def main(argv: list[str] | None = None) -> int:
     except ModuleNotFoundError as error:
         extra = EXTRAS.get(args.command, 'all')
         print(f"rn: error: rn {args.command} needs the Python module {error.name} (extra \"{extra}\"): "
-              f"uv tool install 'renoise-kit[all]'", file=sys.stderr)
+              'uv tool install "renoise-kit[all]"', file=sys.stderr)
         return 1
     except Exception as error:  # a kit bug: keep the traceback for the report, end on the usual one-liner
         import traceback
@@ -545,7 +561,7 @@ def main(argv: list[str] | None = None) -> int:
         return 1
     if args.json:
         Path(args.json).parent.mkdir(parents=True, exist_ok=True)
-        Path(args.json).write_text(json.dumps(result, indent=1, ensure_ascii=False, default=str))
+        Path(args.json).write_text(json.dumps(result, indent=1, ensure_ascii=False, default=str), encoding='utf-8')
     if args.command in SUMMARIZED:
         print('\n'.join(lines))
     else: