@ignix-social/editor 0.1.1 → 0.1.3

package/NOTICE

@@ -18,12 +18,16 @@ Binaries downloaded by Ignix Editor (into ~/.ignix-editor, never bundled in
 this package)
 
 FFmpeg 7.1.2 (ffmpeg, ffprobe) — https://ffmpeg.org
-  Licensed under the GNU Lesser General Public License, version 2.1 or later.
-  Built without any GPL or non-free component (--disable-gpl --disable-nonfree)
-  using scripts/build-ffmpeg-macos.sh in this repository, which records the
-  exact configuration. The corresponding source code is available at
-  https://media.ignix.social/editor/bin/1/source/ffmpeg-7.1.2.tar.xz
+  Licensed under the GNU General Public License, version 2 or later. Its full text
+  is in licenses/ffmpeg-GPL-2.0.txt. Built with --enable-gpl --disable-nonfree and
+  without libx264 (it encodes with Apple's VideoToolbox), using
+  scripts/build-ffmpeg-macos.sh in this repository, which records the exact
+  configuration. The corresponding source code is available at
+  https://media.ignix.social/editor/bin/2/source/ffmpeg-7.1.2.tar.xz
   and from https://ffmpeg.org/releases/ffmpeg-7.1.2.tar.xz.
+  FFmpeg is a separate program: Ignix Editor runs it as its own process and
+  passes it command-line arguments. It is not linked into Ignix Editor, whose own
+  code stays under the Apache License 2.0.
 
 whisper.cpp v1.7.6 (whisper-cli) — https://github.com/ggml-org/whisper.cpp
   Built with scripts/build-whisper-macos.sh. Its license:

package/README.md

@@ -11,7 +11,7 @@ npx @ignix-social/editor render ~/ignix-videos/my-reel
 Commands: `doctor`, `init`, `check`, `snapshot`, `render`, `preview`, `transcribe`, `ffmpeg`, `ffprobe`, `skills add`, `help`.
 
 - Everything runs locally; your footage never leaves your machine.
-- ffmpeg (LGPL build) and whisper.cpp are downloaded once per machine into `~/.ignix-editor`, checked against their SHA-256. Chrome for rendering is downloaded once from Google's official channel.
+- ffmpeg (GPL build, without libx264) and whisper.cpp are downloaded once per machine into `~/.ignix-editor`, checked against their SHA-256. Chrome for rendering is downloaded once from Google's official channel.
 - No telemetry and no automatic updates: the version you install is the version that runs.
 - The final audio is normalised to −14 LUFS.
 - `ignix-editor skills add` installs the `ignix-editor` skill for Claude.

package/licenses/ffmpeg-GPL-2.0.txt

@@ -0,0 +1,339 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 2, June 1991
+
+ Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
+ 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The licenses for most software are designed to take away your
+freedom to share and change it.  By contrast, the GNU General Public
+License is intended to guarantee your freedom to share and change free
+software--to make sure the software is free for all its users.  This
+General Public License applies to most of the Free Software
+Foundation's software and to any other program whose authors commit to
+using it.  (Some other Free Software Foundation software is covered by
+the GNU Lesser General Public License instead.)  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+this service if you wish), that you receive source code or can get it
+if you want it, that you can change the software or use pieces of it
+in new free programs; and that you know you can do these things.
+
+  To protect your rights, we need to make restrictions that forbid
+anyone to deny you these rights or to ask you to surrender the rights.
+These restrictions translate to certain responsibilities for you if you
+distribute copies of the software, or if you modify it.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must give the recipients all the rights that
+you have.  You must make sure that they, too, receive or can get the
+source code.  And you must show them these terms so they know their
+rights.
+
+  We protect your rights with two steps: (1) copyright the software, and
+(2) offer you this license which gives you legal permission to copy,
+distribute and/or modify the software.
+
+  Also, for each author's protection and ours, we want to make certain
+that everyone understands that there is no warranty for this free
+software.  If the software is modified by someone else and passed on, we
+want its recipients to know that what they have is not the original, so
+that any problems introduced by others will not reflect on the original
+authors' reputations.
+
+  Finally, any free program is threatened constantly by software
+patents.  We wish to avoid the danger that redistributors of a free
+program will individually obtain patent licenses, in effect making the
+program proprietary.  To prevent this, we have made it clear that any
+patent must be licensed for everyone's free use or not licensed at all.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                    GNU GENERAL PUBLIC LICENSE
+   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
+
+  0. This License applies to any program or other work which contains
+a notice placed by the copyright holder saying it may be distributed
+under the terms of this General Public License.  The "Program", below,
+refers to any such program or work, and a "work based on the Program"
+means either the Program or any derivative work under copyright law:
+that is to say, a work containing the Program or a portion of it,
+either verbatim or with modifications and/or translated into another
+language.  (Hereinafter, translation is included without limitation in
+the term "modification".)  Each licensee is addressed as "you".
+
+Activities other than copying, distribution and modification are not
+covered by this License; they are outside its scope.  The act of
+running the Program is not restricted, and the output from the Program
+is covered only if its contents constitute a work based on the
+Program (independent of having been made by running the Program).
+Whether that is true depends on what the Program does.
+
+  1. You may copy and distribute verbatim copies of the Program's
+source code as you receive it, in any medium, provided that you
+conspicuously and appropriately publish on each copy an appropriate
+copyright notice and disclaimer of warranty; keep intact all the
+notices that refer to this License and to the absence of any warranty;
+and give any other recipients of the Program a copy of this License
+along with the Program.
+
+You may charge a fee for the physical act of transferring a copy, and
+you may at your option offer warranty protection in exchange for a fee.
+
+  2. You may modify your copy or copies of the Program or any portion
+of it, thus forming a work based on the Program, and copy and
+distribute such modifications or work under the terms of Section 1
+above, provided that you also meet all of these conditions:
+
+    a) You must cause the modified files to carry prominent notices
+    stating that you changed the files and the date of any change.
+
+    b) You must cause any work that you distribute or publish, that in
+    whole or in part contains or is derived from the Program or any
+    part thereof, to be licensed as a whole at no charge to all third
+    parties under the terms of this License.
+
+    c) If the modified program normally reads commands interactively
+    when run, you must cause it, when started running for such
+    interactive use in the most ordinary way, to print or display an
+    announcement including an appropriate copyright notice and a
+    notice that there is no warranty (or else, saying that you provide
+    a warranty) and that users may redistribute the program under
+    these conditions, and telling the user how to view a copy of this
+    License.  (Exception: if the Program itself is interactive but
+    does not normally print such an announcement, your work based on
+    the Program is not required to print an announcement.)
+
+These requirements apply to the modified work as a whole.  If
+identifiable sections of that work are not derived from the Program,
+and can be reasonably considered independent and separate works in
+themselves, then this License, and its terms, do not apply to those
+sections when you distribute them as separate works.  But when you
+distribute the same sections as part of a whole which is a work based
+on the Program, the distribution of the whole must be on the terms of
+this License, whose permissions for other licensees extend to the
+entire whole, and thus to each and every part regardless of who wrote it.
+
+Thus, it is not the intent of this section to claim rights or contest
+your rights to work written entirely by you; rather, the intent is to
+exercise the right to control the distribution of derivative or
+collective works based on the Program.
+
+In addition, mere aggregation of another work not based on the Program
+with the Program (or with a work based on the Program) on a volume of
+a storage or distribution medium does not bring the other work under
+the scope of this License.
+
+  3. You may copy and distribute the Program (or a work based on it,
+under Section 2) in object code or executable form under the terms of
+Sections 1 and 2 above provided that you also do one of the following:
+
+    a) Accompany it with the complete corresponding machine-readable
+    source code, which must be distributed under the terms of Sections
+    1 and 2 above on a medium customarily used for software interchange; or,
+
+    b) Accompany it with a written offer, valid for at least three
+    years, to give any third party, for a charge no more than your
+    cost of physically performing source distribution, a complete
+    machine-readable copy of the corresponding source code, to be
+    distributed under the terms of Sections 1 and 2 above on a medium
+    customarily used for software interchange; or,
+
+    c) Accompany it with the information you received as to the offer
+    to distribute corresponding source code.  (This alternative is
+    allowed only for noncommercial distribution and only if you
+    received the program in object code or executable form with such
+    an offer, in accord with Subsection b above.)
+
+The source code for a work means the preferred form of the work for
+making modifications to it.  For an executable work, complete source
+code means all the source code for all modules it contains, plus any
+associated interface definition files, plus the scripts used to
+control compilation and installation of the executable.  However, as a
+special exception, the source code distributed need not include
+anything that is normally distributed (in either source or binary
+form) with the major components (compiler, kernel, and so on) of the
+operating system on which the executable runs, unless that component
+itself accompanies the executable.
+
+If distribution of executable or object code is made by offering
+access to copy from a designated place, then offering equivalent
+access to copy the source code from the same place counts as
+distribution of the source code, even though third parties are not
+compelled to copy the source along with the object code.
+
+  4. You may not copy, modify, sublicense, or distribute the Program
+except as expressly provided under this License.  Any attempt
+otherwise to copy, modify, sublicense or distribute the Program is
+void, and will automatically terminate your rights under this License.
+However, parties who have received copies, or rights, from you under
+this License will not have their licenses terminated so long as such
+parties remain in full compliance.
+
+  5. You are not required to accept this License, since you have not
+signed it.  However, nothing else grants you permission to modify or
+distribute the Program or its derivative works.  These actions are
+prohibited by law if you do not accept this License.  Therefore, by
+modifying or distributing the Program (or any work based on the
+Program), you indicate your acceptance of this License to do so, and
+all its terms and conditions for copying, distributing or modifying
+the Program or works based on it.
+
+  6. Each time you redistribute the Program (or any work based on the
+Program), the recipient automatically receives a license from the
+original licensor to copy, distribute or modify the Program subject to
+these terms and conditions.  You may not impose any further
+restrictions on the recipients' exercise of the rights granted herein.
+You are not responsible for enforcing compliance by third parties to
+this License.
+
+  7. If, as a consequence of a court judgment or allegation of patent
+infringement or for any other reason (not limited to patent issues),
+conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot
+distribute so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you
+may not distribute the Program at all.  For example, if a patent
+license would not permit royalty-free redistribution of the Program by
+all those who receive copies directly or indirectly through you, then
+the only way you could satisfy both it and this License would be to
+refrain entirely from distribution of the Program.
+
+If any portion of this section is held invalid or unenforceable under
+any particular circumstance, the balance of the section is intended to
+apply and the section as a whole is intended to apply in other
+circumstances.
+
+It is not the purpose of this section to induce you to infringe any
+patents or other property right claims or to contest validity of any
+such claims; this section has the sole purpose of protecting the
+integrity of the free software distribution system, which is
+implemented by public license practices.  Many people have made
+generous contributions to the wide range of software distributed
+through that system in reliance on consistent application of that
+system; it is up to the author/donor to decide if he or she is willing
+to distribute software through any other system and a licensee cannot
+impose that choice.
+
+This section is intended to make thoroughly clear what is believed to
+be a consequence of the rest of this License.
+
+  8. If the distribution and/or use of the Program is restricted in
+certain countries either by patents or by copyrighted interfaces, the
+original copyright holder who places the Program under this License
+may add an explicit geographical distribution limitation excluding
+those countries, so that distribution is permitted only in or among
+countries not thus excluded.  In such case, this License incorporates
+the limitation as if written in the body of this License.
+
+  9. The Free Software Foundation may publish revised and/or new versions
+of the General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+Each version is given a distinguishing version number.  If the Program
+specifies a version number of this License which applies to it and "any
+later version", you have the option of following the terms and conditions
+either of that version or of any later version published by the Free
+Software Foundation.  If the Program does not specify a version number of
+this License, you may choose any version ever published by the Free Software
+Foundation.
+
+  10. If you wish to incorporate parts of the Program into other free
+programs whose distribution conditions are different, write to the author
+to ask for permission.  For software which is copyrighted by the Free
+Software Foundation, write to the Free Software Foundation; we sometimes
+make exceptions for this.  Our decision will be guided by the two goals
+of preserving the free status of all derivatives of our free software and
+of promoting the sharing and reuse of software generally.
+
+                            NO WARRANTY
+
+  11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
+FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
+OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
+PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
+OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
+TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
+PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
+REPAIR OR CORRECTION.
+
+  12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
+REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
+INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
+OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
+TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
+YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
+PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGES.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+convey the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program 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 2 of the License, or
+    (at your option) any later version.
+
+    This program 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 this program; if not, write to the Free Software Foundation, Inc.,
+    51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+
+Also add information on how to contact you by electronic and paper mail.
+
+If the program is interactive, make it output a short notice like this
+when it starts in an interactive mode:
+
+    Gnomovision version 69, Copyright (C) year name of author
+    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, the commands you use may
+be called something other than `show w' and `show c'; they could even be
+mouse-clicks or menu items--whatever suits your program.
+
+You should also get your employer (if you work as a programmer) or your
+school, if any, to sign a "copyright disclaimer" for the program, if
+necessary.  Here is a sample; alter the names:
+
+  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
+  `Gnomovision' (which makes passes at compilers) written by James Hacker.
+
+  <signature of Ty Coon>, 1 April 1989
+  Ty Coon, President of Vice
+
+This General Public License does not permit incorporating your program into
+proprietary programs.  If your program is a subroutine library, you may
+consider it more useful to permit linking proprietary applications with the
+library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ignix-social/editor",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Ignix Editor: render HTML video compositions (reels, edits, clips) on your own computer. Based on HyperFrames.",
   "license": "Apache-2.0",
   "type": "module",
@@ -16,7 +16,8 @@
     "patches",
     "scripts",
     "LICENSE",
-    "NOTICE"
+    "NOTICE",
+    "licenses"
   ],
   "engines": {
     "node": ">=22"

package/scripts/build-ffmpeg-macos.sh

@@ -1,7 +1,12 @@
 #!/bin/sh
-# Compila ffmpeg + ffprobe LGPL para macOS (sin libx264 ni nada GPL/non-free).
-# HyperFrames codifica entonces con VideoToolbox (h264_videotoolbox), el codificador del Mac.
+# Compila ffmpeg + ffprobe para macOS con licencia GPL (2026-10-05, decisión de Fran): trae los
+# filtros GPL (eq, boxblur, delogo, hqdn3d…) pero SIN libx264 ni nada non-free; codifica con
+# VideoToolbox (h264_videotoolbox), el codificador del Mac. Es un programa aparte que Ignix
+# Editor lanza por línea de comandos: su GPL no alcanza a nuestro código (ver NOTICE).
 # Uso: scripts/build-ffmpeg-macos.sh [dir-de-trabajo]  → <dir>/out/{ffmpeg,ffprobe}
+# --disable-autodetect: ffmpeg NO busca librerías externas por su cuenta (en el CI encontró la
+# liblzma de Homebrew y el binario exigía Homebrew en el Mac del cliente); solo lo que se activa
+# abajo, todo del sistema.
 set -eu
 NASM_VERSION=2.16.03
 FFMPEG_VERSION=7.1.2
@@ -22,11 +27,12 @@ export PATH="$WORK/tools/bin:$PATH"
 cd "ffmpeg-$FFMPEG_VERSION"
 ./configure \
   --prefix="$WORK/out-prefix" \
-  --disable-gpl --disable-nonfree --disable-version3 \
+  --enable-gpl --disable-nonfree --disable-version3 \
+  --disable-autodetect \
   --disable-debug --disable-doc --disable-ffplay \
   --disable-shared --enable-static \
   --enable-videotoolbox --enable-audiotoolbox \
-  --enable-zlib --enable-bzlib --enable-iconv \
+  --enable-zlib --enable-bzlib --disable-iconv \
   --disable-sdl2 --disable-xlib --disable-libxcb \
   --extra-cflags="-mmacosx-version-min=11.0" --extra-ldflags="-mmacosx-version-min=11.0" >/dev/null
 make -j"$JOBS" >/dev/null

package/skills/ignix-editor/SKILL.md

@@ -14,6 +14,7 @@ Commands (`npx @ignix-social/editor <cmd>` if `ignix-editor` is not on the PATH)
 | `ignix-editor doctor` | Node 22+ and the H.264 encoder; downloads its own ffmpeg and whisper the first time. Run it first. |
 | `ignix-editor init <name>` | Creates `~/ignix-videos/<name>` with a working skeleton, GSAP, local fonts and `ignix-frame.js`. |
 | `ignix-editor transcribe <file> --lang es [--script "…"] -o words.json` | Words with start/end seconds, on this machine. |
+| `ignix-editor faces <video> -o work/faces.json` | Where the face is over time (macOS, Apple Vision): a smoothed path `{t, cx, cy, size}` (0–1, top-left origin) to frame the person. |
 | `ignix-editor check [dir]` | HTML well-formed, no network assets, media rules, layout/contrast/motion audit. |
 | `ignix-editor snapshot [dir] --at 0,1.5,3` | PNG frames into `<dir>/snapshots/` to LOOK at. `[dir]` defaults to the current folder. |
 | `ignix-editor render [dir] [-o out.mp4]` | Renders to `<dir>/renders/<dir>.mp4`, audio normalised to −14 LUFS. |
@@ -94,16 +95,25 @@ Decide the zones once per video (e.g. header y 270–440, stage y 460–1300, ca
 - Transcribe on the machine: `ignix-editor transcribe assets/take.mp4 --lang es -o work/words.json`. Show the user the text and fix obvious mishearings (names, brands) without rewriting what they said.
 - Cuts: one `<video>` per kept range, edge to edge (`data-start` of the next = previous start + duration). Build a map from source time to edited time and pass every word time, zoom, overlay and sound through it.
 - Voice clean-up before building: `ignix-editor ffmpeg -i take.mp4 -vn -ac 1 -ar 48000 -af "highpass=f=80,acompressor=threshold=-22dB:ratio=3:attack=5:release=120:makeup=2" assets/voice.wav`, then one `<audio>` per kept range with `data-media-start` and 8 ms fade lanes, and the videos `muted`.
-- Reframing a horizontal source to 9:16 and following the face: a fixed card/frame element with `overflow:hidden`; inside it a wrapper sized like the card, `transform-origin:0 0`, moved with `translate(-x·z, -y·z) scale(z)` per frame from a face path (one point per frame, smoothed). Zooms multiply `z`.
+- Reframing a horizontal source to 9:16 and following the face: `ignix-editor faces assets/take.mp4 -o work/faces.json` gives a smoothed path (`cx`, `cy` = centre of the face, `size` = its height, all 0–1). Map it through your cut map like the words. Then a fixed card/frame element with `overflow:hidden`; inside it a wrapper sized like the card, `transform-origin:0 0`, moved with `translate(-x·z, -y·z) scale(z)` per frame from that path (interpolate between samples). Zooms multiply `z`.
+- The cover is the first frame: the face AND the hook. If the person is not in shot yet in the first second (sitting down, walking in), use a still of their face from later (`ignix-editor ffmpeg -ss <t> -i take.mp4 -frames:v 1 assets/cover.jpg`) under the hook for ~1 s, with a slow push, then cut to the footage.
+- The same file in two places at once (main shot + a small picture-in-picture window): give the second one its own copy (`cp take.mp4 take-pip.mp4`); `check` flags two simultaneous clips of one file.
 - Blurred background of the same footage: a second set of the same `<video>` elements behind, in a wrapper with `filter: blur(60px) brightness(.32)` and `transform: scale(1.25)`. (Heavy without a GPU: on a machine without one, prefer a pre-blurred copy made with ffmpeg.)
 - Long sources (lives, podcasts) are fine: the editor seeks straight to `data-media-start`.
 
+### The bundled ffmpeg
+
+`ignix-editor ffmpeg` is a full build for video prep (GPL, without libx264).
+- Encode H.264 with `-c:v h264_videotoolbox -b:v 10M -allow_sw 1` (there is no `libx264` and no `-crf`). AAC audio: `-c:a aac -b:a 192k`.
+- Filters include `scale`, `crop`, `pad`, `overlay`, `trim`/`atrim`, `concat`, `eq` (contrast, brightness, saturation), `curves`, `lutyuv`, `colorbalance`, `boxblur`, `gblur`, `delogo` (hide a burned-in label: `delogo=x=..:y=..:w=..:h=..`), `hqdn3d` (denoise), `fade`, `afade`, `highpass`, `lowpass`, `acompressor`, `loudnorm`, `ebur128`, `silencedetect`, `amix`, `volume`.
+- Grading and blur are usually easier in the HTML anyway (CSS `filter: contrast() saturate() blur()`).
+
 ## 4. Audio and captions for reels from scratch
 
 - One `<audio>` per voice line (Ignix `generate_voiceover`), placed back to back with ~0.25 s of air: the scenes follow the voice.
 - Word times: `ignix-editor transcribe assets/vo/l1.wav --lang es --script "<the exact line>" -o work/l1.json`. With `--script` the words are the script's and the times are whisper's (whisper mishears and sometimes drops the last words; the script wins).
 - Anchor every gesture (click, pop, highlight, cut) to a word time: `cue = line.start + word.s`. Sound effects start on their gesture.
-- Captions: groups of 2–3 words that never cross the end of a line; current word in the brand accent; font size shrinks for long groups so they fit the ~820 px column.
+- Captions: groups of 2–3 words that never cross the end of a line; current word in the brand accent; font size shrinks for long groups so they fit the ~820 px column. Keep a real gap between words (`gap: 0 0.3em` on the flex row): if the active word grows (`scale`), it eats a smaller gap and «EDITORES DE» reads «EDITORESDE» — grow it at most ~5 %, or only change its colour.
 - The final mix is normalised to −14 LUFS by `render` (`--lufs` to change, `--no-normalize` to skip).
 
 ## 5. Generate the HTML from data
@@ -124,7 +134,7 @@ Re-run it whenever the voice or the cuts change; the animation code reads `windo
 - Emojis render with the operating system's emoji font (different design on other machines).
 - An element that ends past `data-duration` is cut; a timeline shorter than it holds the last frame.
 - `check` also reads HTML comments: never leave example `<video>`/`<audio>` tags inside `<!-- -->` (it reports their files as missing).
-- `check` reports layout overlaps: real ones (a zoomed window under the header) must be fixed; intentional ones get `data-layout-allow-overlap` / `data-layout-allow-overflow` on the element.
+- `check` reports layout overlaps: real ones (a zoomed window under the header) must be fixed; intentional ones get `data-layout-allow-overlap` / `data-layout-allow-overflow` on the element. A title split in lines (one element per line) is reported line against line: put `data-layout-allow-overlap` on EACH line, not only on the container.
 
 ## 7. Review before showing anything
 

package/src/binaries.json

@@ -1,46 +1,16 @@
 {
-  "version": "1",
+  "version": "2",
   "baseUrl": "https://media.ignix.social/editor/bin",
   "platforms": {
     "darwin-x64": {
-      "ffmpeg": {
-        "file": "ffmpeg",
-        "size": 25060568,
-        "sha256": "d4d01b1c196a4c6e3000be608f906991fe41914840a1ce0dcdf66256c3ee4c40",
-        "build": "ffmpeg 7.1.2 LGPL + VideoToolbox, scripts/build-ffmpeg-macos.sh"
-      },
-      "ffprobe": {
-        "file": "ffprobe",
-        "size": 24973512,
-        "sha256": "dd9f843f01a934c8358c9a235d8e44349fe50692418dd79ba328be7f4fecbd85",
-        "build": "ffmpeg 7.1.2 LGPL, scripts/build-ffmpeg-macos.sh"
-      },
-      "whisper": {
-        "file": "whisper-cli",
-        "size": 2912480,
-        "sha256": "73fc58436c1e1a9d2cc3ea08bddf18bf78270d8c6940c5fd89a3c9cb31535efe",
-        "build": "whisper.cpp v1.7.6, scripts/build-whisper-macos.sh"
-      }
+      "ffmpeg": { "file": "ffmpeg", "size": 25454144, "sha256": "593bf505c3f4e67c3b24c8b24008577f217178e6b96ffa452f0d63d55f557d41", "build": "ffmpeg 7.1.2 GPL (sin libx264 ni non-free) + VideoToolbox, scripts/build-ffmpeg-macos.sh en Mac Intel" },
+      "ffprobe": { "file": "ffprobe", "size": 25367080, "sha256": "97dae7a58f71a3fa54d11be06c810896504fb70f062396cd466c37f66fe16b1e", "build": "ffmpeg 7.1.2 GPL, scripts/build-ffmpeg-macos.sh en Mac Intel" },
+      "whisper": { "file": "whisper-cli", "size": 2912480, "sha256": "73fc58436c1e1a9d2cc3ea08bddf18bf78270d8c6940c5fd89a3c9cb31535efe", "build": "whisper.cpp v1.7.6, scripts/build-whisper-macos.sh" }
     },
     "darwin-arm64": {
-      "ffmpeg": {
-        "file": "ffmpeg",
-        "size": 20858536,
-        "sha256": "ba5d9f9e59dd9588b88c97a526d971d07ccc60d1f101f47e2f9fac3c03ff2846",
-        "build": "ffmpeg 7.1.2 LGPL + VideoToolbox, CI binaries.yml (macos-15, run 37322341901)"
-      },
-      "ffprobe": {
-        "file": "ffprobe",
-        "size": 20799752,
-        "sha256": "5c7c6da2f0a7c14ac7aaf934afdfd6e0efa232955226a287b986fcb37e5992b9",
-        "build": "ffmpeg 7.1.2 LGPL, CI binaries.yml (macos-15, run 37322341901)"
-      },
-      "whisper": {
-        "file": "whisper-cli",
-        "size": 2573144,
-        "sha256": "215d93a2edc77f8929311f127f368727859e13833e925652315ca5ea774595ee",
-        "build": "whisper.cpp v1.7.6, CI binaries.yml (macos-15, run 37322341901)"
-      }
+      "ffmpeg": { "file": "ffmpeg", "size": 21133592, "sha256": "47430a1ac61ff5e461c0fd70db9c5feb74557018ede93773bdf98b09297dcd49", "build": "ffmpeg 7.1.2 GPL (sin libx264 ni non-free) + VideoToolbox, CI binaries.yml (macos-15, run 37375441240)" },
+      "ffprobe": { "file": "ffprobe", "size": 21074760, "sha256": "10c338cd1c804222a6c90c24c7c07f73bb07ee0f2d506eff565ca8f5e9fa9a40", "build": "ffmpeg 7.1.2 GPL, CI binaries.yml (macos-15, run 37375441240)" },
+      "whisper": { "file": "whisper-cli", "size": 2573144, "sha256": "215d93a2edc77f8929311f127f368727859e13833e925652315ca5ea774595ee", "build": "whisper.cpp v1.7.6, CI binaries.yml (macos-15, run 37375441240)" }
     }
   }
 }

package/src/cli.mjs

@@ -2,6 +2,7 @@
 // debajo con nuestro entorno: sin telemetría, sin actualizaciones solas, con nuestros binarios.
 // Los mensajes van en inglés, como el manual y la skill: los lee sobre todo el agente.
 import { spawnSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
 import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, symlinkSync, writeFileSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { homedir } from 'node:os';
@@ -231,6 +232,53 @@ const commands = {
     } else console.log(json);
   },
 
+  // Dónde está la cara a lo largo del vídeo, para encuadrar en vertical siguiéndola.
+  // macOS: Apple Vision desde un Swift propio (src/native/faces.swift), compilado una vez.
+  async faces(argv) {
+    const { pos, opts } = parseArgs(argv, { every: 'str', output: 'str', smooth: 'str' });
+    const input = pos[0] && resolve(pos[0]);
+    if (!input || !existsSync(input)) fail('Usage: ignix-editor faces <video> [--every 0.2] [--smooth 1] [-o work/faces.json]');
+    if (process.platform !== 'darwin') fail('faces needs macOS for now. Elsewhere, frame the person by hand from stills (snapshot) or keep a centred crop.');
+    const src = join(PKG_DIR, 'src', 'native', 'faces.swift');
+    const hash = createHash('sha256').update(readFileSync(src)).digest('hex').slice(0, 12);
+    const bin = join(HOME, 'bin', PLATFORM, `faces-${hash}`);
+    if (!existsSync(bin)) {
+      mkdirSync(dirname(bin), { recursive: true });
+      log('Compiling the face tracker (first time only)…');
+      const c = spawnSync('xcrun', ['swiftc', '-O', '-parse-as-library', src, '-o', bin], { encoding: 'utf8' });
+      if (c.status !== 0) fail(`Could not compile the face tracker. It needs Apple's Command Line Tools (xcode-select --install).\n${(c.stderr || c.error?.message || '').slice(-400)}`);
+    }
+    const every = Math.max(0.05, Number(opts.every ?? 0.2));
+    const r = spawnSync(bin, [input, String(every)], { encoding: 'utf8', maxBuffer: 256 * 1024 * 1024 });
+    if (r.status !== 0) fail(`Face tracking failed: ${(r.stderr || '').slice(-400)}`);
+    const raw = JSON.parse(r.stdout);
+    const S = raw.samples;
+    // Huecos sin cara: la posición conocida más cercana; si no hay ninguna, el centro.
+    const known = S.map((x, i) => (x.w ? i : -1)).filter((i) => i >= 0);
+    const filled = S.map((x, i) => {
+      if (x.w) return x;
+      if (!known.length) return { t: x.t, x: 0.4, y: 0.3, w: 0.2, h: 0.2 };
+      const k = known.reduce((a, b) => (Math.abs(b - i) < Math.abs(a - i) ? b : a));
+      return { ...S[k], t: x.t };
+    });
+    // Suavizado: media móvil de ~1 s (configurable) sobre el centro y el tamaño.
+    const half = Math.max(1, Math.round(Number(opts.smooth ?? 1) / every / 2));
+    const avg = (i, f) => {
+      let sum = 0, n = 0;
+      for (let j = Math.max(0, i - half); j <= Math.min(filled.length - 1, i + half); j++) (sum += f(filled[j])), n++;
+      return +(sum / n).toFixed(4);
+    };
+    const path = filled.map((x, i) => ({ t: x.t, cx: avg(i, (y) => y.x + y.w / 2), cy: avg(i, (y) => y.y + y.h / 2), size: avg(i, (y) => y.h) }));
+    const out = { source: input, width: raw.width, height: raw.height, duration: raw.duration, every, found: known.length, samples: S.length, path };
+    const json = JSON.stringify(out);
+    log(`✓ Face found in ${known.length}/${S.length} samples${known.length < S.length ? ' (gaps filled with the nearest position)' : ''}`);
+    if (opts.output) {
+      mkdirSync(dirname(resolve(opts.output)), { recursive: true });
+      writeFileSync(resolve(opts.output), json);
+      console.log(resolve(opts.output));
+    } else console.log(json);
+  },
+
   async ffmpeg(argv) {
     const r = spawnSync(await ensureTool('ffmpeg', log), argv, { stdio: 'inherit' });
     process.exit(r.status ?? 1);
@@ -264,6 +312,7 @@ const commands = {
   ignix-editor render [folder] [-o out.mp4] [--lufs -14] [--no-normalize]
   ignix-editor preview [folder]                live preview in the browser
   ignix-editor transcribe <file> [--lang es] [--script "text"] [-o words.json]
+  ignix-editor faces <video> [--every 0.2] [-o faces.json]   where the face is, smoothed (macOS)
   ignix-editor ffmpeg|ffprobe <args>           Ignix Editor's own ffmpeg
   ignix-editor skills add                      installs the skill for Claude
 

package/src/native/faces.swift

@@ -0,0 +1,60 @@
+// faces — dónde está la cara en cada momento de un vídeo (Apple Vision, macOS 13+).
+// Uso: faces <vídeo> <cada_segundos>  → JSON por stdout:
+//   { "duration": s, "width": px, "height": px, "samples": [ { "t": s, "x":…, "y":…, "w":…, "h":… } | { "t": s } ] }
+// x, y, w, h normalizados 0–1 con origen ARRIBA a la izquierda (como CSS). Sin cara → solo "t".
+import AVFoundation
+import Foundation
+import Vision
+
+@main
+struct Faces {
+  static func main() async {
+    let args = CommandLine.arguments
+    guard args.count >= 2 else {
+      FileHandle.standardError.write("usage: faces <video> [every_seconds]\n".data(using: .utf8)!)
+      exit(2)
+    }
+    let url = URL(fileURLWithPath: args[1])
+    let every = args.count >= 3 ? (Double(args[2]) ?? 0.2) : 0.2
+    let asset = AVURLAsset(url: url)
+    do {
+      let duration = try await asset.load(.duration).seconds
+      guard let track = try await asset.loadTracks(withMediaType: .video).first else {
+        FileHandle.standardError.write("no video track\n".data(using: .utf8)!)
+        exit(1)
+      }
+      let size = try await track.load(.naturalSize).applying(try await track.load(.preferredTransform))
+      let gen = AVAssetImageGenerator(asset: asset)
+      gen.appliesPreferredTrackTransform = true
+      gen.requestedTimeToleranceBefore = CMTime(value: 1, timescale: 30)
+      gen.requestedTimeToleranceAfter = CMTime(value: 1, timescale: 30)
+      gen.maximumSize = CGSize(width: 960, height: 960)
+
+      var samples: [[String: Double]] = []
+      var t = 0.0
+      while t < duration {
+        var sample: [String: Double] = ["t": (t * 1000).rounded() / 1000]
+        if let (image, _) = try? await gen.image(at: CMTime(seconds: t, preferredTimescale: 600)) {
+          let req = VNDetectFaceRectanglesRequest()
+          try? VNImageRequestHandler(cgImage: image, options: [:]).perform([req])
+          // La cara más grande: la de quien habla a cámara.
+          if let f = (req.results ?? []).max(by: { $0.boundingBox.width * $0.boundingBox.height < $1.boundingBox.width * $1.boundingBox.height }) {
+            let b = f.boundingBox // Vision: origen ABAJO a la izquierda
+            sample["x"] = b.minX
+            sample["y"] = 1 - b.maxY
+            sample["w"] = b.width
+            sample["h"] = b.height
+          }
+        }
+        samples.append(sample)
+        t += every
+      }
+      let out: [String: Any] = ["duration": duration, "width": abs(size.width), "height": abs(size.height), "samples": samples]
+      let data = try JSONSerialization.data(withJSONObject: out)
+      FileHandle.standardOutput.write(data)
+    } catch {
+      FileHandle.standardError.write("faces failed: \(error)\n".data(using: .utf8)!)
+      exit(1)
+    }
+  }
+}