clipkly 0.1.0__tar.gz

clipkly-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Judlup Luna
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

clipkly-0.1.0/MANIFEST.in

@@ -0,0 +1 @@
+include README.md

clipkly-0.1.0/PKG-INFO

@@ -0,0 +1,210 @@
+Metadata-Version: 2.4
+Name: clipkly
+Version: 0.1.0
+Summary: Corta automáticamente clips de video a partir de subtítulos o timecodes definidos en un JSON.
+Home-page: https://github.com/judlup/clipkly
+Author: Julian Dario Luna Patiño
+Author-email: judlup@trycatch.tv
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas
+Requires-Dist: tqdm
+Requires-Dist: openpyxl
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+
+# 🎬 Clipkly
+
+`Clipkly` es una herramienta en Python para cortar automáticamente clips desde dos versiones de un mismo video (horizontal y vertical), usando un archivo `.json` con los timecodes de los mejores momentos.
+
+Soporta desfase (`--offset`) cuando el video vertical empieza en un punto diferente al horizontal (por ejemplo, por edición o plataformas como TikTok).
+
+---
+
+## 🚀 Uso rápido
+
+```bash
+python clipkly.py --offset 403.025 --vertical video_v.mp4
+```
+
+Esto generará clips desde:
+
+- `video_v.mp4` (con offset aplicado) → en `clips/vertical/`
+
+Si también incluyes `--horizontal`, generará clips desde `video_h.mp4` (sin offset) → en `clips/horizontal/`.
+
+---
+
+## 🧾 Formato del archivo clips.json
+
+```json
+[
+  {
+    "start": "01:46:31.760",
+    "end": "01:47:17.199",
+    "slug": "titulo_del_video",
+    "titulo": "titulo del video optimizado para SEO",
+    "descripcion": "breve descripción del contenido del clip",
+    "feeling": "sentimiento del clip",
+    "category" : "categoria del clip"
+  }
+]
+```
+
+🧠 Puedes generar este archivo a partir de los subtítulos de YouTube (ver más abajo).
+
+📥 Cómo obtener los subtítulos (`.srt`):
+
+1. Ve a https://www.downloadyoutubesubtitles.com/es  
+2. Pega el enlace del video de YouTube  
+3. Descarga el archivo en formato `.srt` (idealmente en español)  
+4. Abre Google AI Studio  
+5. Usa este prompt:
+
+```plaintext
+Estos son los subtítulos de la transmisión, puede darme la lista de los mejores momentos para sacar los clips, también en formato JSON:
+
+{
+  "start": "01:46:31.760",
+  "end": "01:47:17.199",
+  "slug": "titulo_del_video",
+  "titulo": "titulo del video optimizado para seo",
+  "description": "descripción o sinapsis del video",
+  "feeling": "sentimiento del clip",
+  "category" : " categoria del clip"
+}
+```
+
+---
+
+## ⚙️ Argumentos del script
+
+```bash
+python clipkly.py [opciones]
+```
+
+| Opción           | Descripción                                                                 |
+|------------------|-----------------------------------------------------------------------------|
+| `--offset`       | Offset en segundos solo para el video vertical (default: 0.0)               |
+| `--horizontal`   | Ruta al video horizontal (opcional)                                         |
+| `--vertical`     | Ruta al video vertical (opcional)                                           |
+| `--json`         | Ruta al archivo JSON con los timecodes (default: `clips.json`)             |
+| `--filter`       | Filtra los clips por categoría (`inspiracional`, `tips`, etc.)             |
+| `--duracion`     | Filtra clips por duración: `muy_corto`, `ideal`, `largo`, `muy_largo`      |
+| `--dry-run`      | Muestra los comandos sin ejecutarlos                                        |
+| `--version`, `-v`| Muestra la versión del script                                               |
+
+---
+
+## 📁 Estructura generada
+
+```plaintext
+📁 clips/
+ ├── 📁 horizontal/     ← Clips del video horizontal (sin offset)
+ ├── 📁 vertical/       ← Clips del video vertical (con offset)
+ └── 📄 estado_clips.xlsx  ← Archivo Excel con metadatos editoriales
+```
+
+Este Excel incluye:
+
+- duración del clip en segundos (`duracion_segundos`)
+- duración en formato `min:seg` (`duracion_mmss`)
+- clasificación automática:
+  - `muy_corto`: hasta 30s
+  - `ideal`: entre 31s y 90s
+  - `largo`: entre 91s y 179s
+  - `muy_largo`: más de 3 minutos
+
+---
+
+## 📦 Requisitos
+
+- Python 3.7+
+- `ffmpeg` instalado y en el PATH
+- Ejecutar: `pip install -r requirements.txt` para instalar dependencias
+
+Dependencias mínimas:
+
+```
+pandas
+tqdm
+openpyxl
+```
+
+---
+
+## 💡 Funcionalidades
+
+- ✂️ Corta clips precisos con FFmpeg sin recodificar (`-c copy`)
+- 🕒 Aplica offset únicamente al video vertical
+- 📁 Genera carpetas separadas para cada versión (`clips/horizontal` y `clips/vertical`)
+- 🧼 Limpia automáticamente los nombres de archivo
+- 🧠 Exporta Excel para planeación editorial (`estado_clips.xlsx`)
+- 🔍 Filtros por duración y categoría
+- 🔄 Modo `--dry-run` para validar sin ejecutar
+- 🧾 Modo CLI personalizable
+
+---
+
+## 🖥️ Alias útil en consola
+
+Powershell:
+
+```powershell
+Set-Alias clipkly python ./clipkly.py
+```
+
+Linux/Bash:
+
+```bash
+alias clipkly='python ./clipkly.py'
+```
+
+Entonces puedes correr:
+
+```bash
+clipkly --offset 3.25 --vertical video_v.mp4
+```
+
+---
+
+## 📌 Ejemplo completo
+
+```bash
+python clipkly.py --offset 403.025 --horizontal video_h.mp4 --vertical video_v.mp4 --json clips.json --duracion ideal
+```
+
+---
+
+## 🔜 Próximas mejoras sugeridas
+
+- 🎞️ Subtítulos quemados en los clips
+- 📸 Generación de miniaturas automáticas
+- 🌐 Interfaz gráfica simple con Gradio
+- 📊 Dashboard para gestión de clips y publicaciones
+- ☁️ Integración con plataformas como Notion o Google Sheets
+
+---
+
+## 🙌 Créditos
+
+Este proyecto fue creado por **Julian Dario Luna Patiño**, ingeniero de software, arquitecto de soluciones en la nube y creador de contenido en [TryCatch.tv](https://trycatch.tv).
+
+**clipkly** nació como una herramienta práctica para automatizar la creación de clips a partir de transmisiones en vivo, especialmente útil para quienes trabajan con contenido en plataformas como YouTube, TikTok e Instagram.
+
+Contacto: [judlup@trycatch.tv](mailto:judlup@trycatch.tv)
+
+✨ Dedicado con cariño a **Nikol Daniela** ❤️

clipkly-0.1.0/README.md

@@ -0,0 +1,183 @@
+
+# 🎬 Clipkly
+
+`Clipkly` es una herramienta en Python para cortar automáticamente clips desde dos versiones de un mismo video (horizontal y vertical), usando un archivo `.json` con los timecodes de los mejores momentos.
+
+Soporta desfase (`--offset`) cuando el video vertical empieza en un punto diferente al horizontal (por ejemplo, por edición o plataformas como TikTok).
+
+---
+
+## 🚀 Uso rápido
+
+```bash
+python clipkly.py --offset 403.025 --vertical video_v.mp4
+```
+
+Esto generará clips desde:
+
+- `video_v.mp4` (con offset aplicado) → en `clips/vertical/`
+
+Si también incluyes `--horizontal`, generará clips desde `video_h.mp4` (sin offset) → en `clips/horizontal/`.
+
+---
+
+## 🧾 Formato del archivo clips.json
+
+```json
+[
+  {
+    "start": "01:46:31.760",
+    "end": "01:47:17.199",
+    "slug": "titulo_del_video",
+    "titulo": "titulo del video optimizado para SEO",
+    "descripcion": "breve descripción del contenido del clip",
+    "feeling": "sentimiento del clip",
+    "category" : "categoria del clip"
+  }
+]
+```
+
+🧠 Puedes generar este archivo a partir de los subtítulos de YouTube (ver más abajo).
+
+📥 Cómo obtener los subtítulos (`.srt`):
+
+1. Ve a https://www.downloadyoutubesubtitles.com/es  
+2. Pega el enlace del video de YouTube  
+3. Descarga el archivo en formato `.srt` (idealmente en español)  
+4. Abre Google AI Studio  
+5. Usa este prompt:
+
+```plaintext
+Estos son los subtítulos de la transmisión, puede darme la lista de los mejores momentos para sacar los clips, también en formato JSON:
+
+{
+  "start": "01:46:31.760",
+  "end": "01:47:17.199",
+  "slug": "titulo_del_video",
+  "titulo": "titulo del video optimizado para seo",
+  "description": "descripción o sinapsis del video",
+  "feeling": "sentimiento del clip",
+  "category" : " categoria del clip"
+}
+```
+
+---
+
+## ⚙️ Argumentos del script
+
+```bash
+python clipkly.py [opciones]
+```
+
+| Opción           | Descripción                                                                 |
+|------------------|-----------------------------------------------------------------------------|
+| `--offset`       | Offset en segundos solo para el video vertical (default: 0.0)               |
+| `--horizontal`   | Ruta al video horizontal (opcional)                                         |
+| `--vertical`     | Ruta al video vertical (opcional)                                           |
+| `--json`         | Ruta al archivo JSON con los timecodes (default: `clips.json`)             |
+| `--filter`       | Filtra los clips por categoría (`inspiracional`, `tips`, etc.)             |
+| `--duracion`     | Filtra clips por duración: `muy_corto`, `ideal`, `largo`, `muy_largo`      |
+| `--dry-run`      | Muestra los comandos sin ejecutarlos                                        |
+| `--version`, `-v`| Muestra la versión del script                                               |
+
+---
+
+## 📁 Estructura generada
+
+```plaintext
+📁 clips/
+ ├── 📁 horizontal/     ← Clips del video horizontal (sin offset)
+ ├── 📁 vertical/       ← Clips del video vertical (con offset)
+ └── 📄 estado_clips.xlsx  ← Archivo Excel con metadatos editoriales
+```
+
+Este Excel incluye:
+
+- duración del clip en segundos (`duracion_segundos`)
+- duración en formato `min:seg` (`duracion_mmss`)
+- clasificación automática:
+  - `muy_corto`: hasta 30s
+  - `ideal`: entre 31s y 90s
+  - `largo`: entre 91s y 179s
+  - `muy_largo`: más de 3 minutos
+
+---
+
+## 📦 Requisitos
+
+- Python 3.7+
+- `ffmpeg` instalado y en el PATH
+- Ejecutar: `pip install -r requirements.txt` para instalar dependencias
+
+Dependencias mínimas:
+
+```
+pandas
+tqdm
+openpyxl
+```
+
+---
+
+## 💡 Funcionalidades
+
+- ✂️ Corta clips precisos con FFmpeg sin recodificar (`-c copy`)
+- 🕒 Aplica offset únicamente al video vertical
+- 📁 Genera carpetas separadas para cada versión (`clips/horizontal` y `clips/vertical`)
+- 🧼 Limpia automáticamente los nombres de archivo
+- 🧠 Exporta Excel para planeación editorial (`estado_clips.xlsx`)
+- 🔍 Filtros por duración y categoría
+- 🔄 Modo `--dry-run` para validar sin ejecutar
+- 🧾 Modo CLI personalizable
+
+---
+
+## 🖥️ Alias útil en consola
+
+Powershell:
+
+```powershell
+Set-Alias clipkly python ./clipkly.py
+```
+
+Linux/Bash:
+
+```bash
+alias clipkly='python ./clipkly.py'
+```
+
+Entonces puedes correr:
+
+```bash
+clipkly --offset 3.25 --vertical video_v.mp4
+```
+
+---
+
+## 📌 Ejemplo completo
+
+```bash
+python clipkly.py --offset 403.025 --horizontal video_h.mp4 --vertical video_v.mp4 --json clips.json --duracion ideal
+```
+
+---
+
+## 🔜 Próximas mejoras sugeridas
+
+- 🎞️ Subtítulos quemados en los clips
+- 📸 Generación de miniaturas automáticas
+- 🌐 Interfaz gráfica simple con Gradio
+- 📊 Dashboard para gestión de clips y publicaciones
+- ☁️ Integración con plataformas como Notion o Google Sheets
+
+---
+
+## 🙌 Créditos
+
+Este proyecto fue creado por **Julian Dario Luna Patiño**, ingeniero de software, arquitecto de soluciones en la nube y creador de contenido en [TryCatch.tv](https://trycatch.tv).
+
+**clipkly** nació como una herramienta práctica para automatizar la creación de clips a partir de transmisiones en vivo, especialmente útil para quienes trabajan con contenido en plataformas como YouTube, TikTok e Instagram.
+
+Contacto: [judlup@trycatch.tv](mailto:judlup@trycatch.tv)
+
+✨ Dedicado con cariño a **Nikol Daniela** ❤️

clipkly-0.1.0/clipkly/__init__.py

@@ -0,0 +1 @@
+# clipkly/__init__.py

clipkly-0.1.0/clipkly/cli.py

@@ -0,0 +1,152 @@
+import argparse
+import json
+import os
+import pathlib
+import re
+import shlex
+import subprocess
+import unicodedata
+from datetime import datetime
+
+import pandas as pd
+from tqdm import tqdm
+
+
+def main():
+    VERSION = "0.1.0"
+
+    parser = argparse.ArgumentParser(
+        description="Recorta clips desde uno o dos videos según un archivo JSON.")
+    parser.add_argument("--offset", type=float, default=0.0,
+                        help="Offset (en segundos) solo para el video vertical")
+    parser.add_argument("--horizontal", type=str,
+                        help="Ruta al archivo de video horizontal (opcional)")
+    parser.add_argument("--vertical", type=str,
+                        help="Ruta al archivo de video vertical (opcional)")
+    parser.add_argument("--json", type=str, default="clips.json",
+                        help="Archivo JSON con la definición de los clips")
+    parser.add_argument("--filter", type=str,
+                        help="Filtrar clips por categoría (opcional)")
+    parser.add_argument("--duracion", type=str, choices=[
+                        "muy_corto", "ideal", "largo", "muy_largo"], help="Filtrar clips por duración clasificada (opcional)")
+    parser.add_argument("--dry-run", action="store_true",
+                        help="Solo mostrar lo que se haría sin ejecutar FFmpeg")
+    parser.add_argument("--version", "-v", action="store_true",
+                        help="Mostrar versión y salir")
+    args = parser.parse_args()
+
+    if args.version:
+        print(f"clipkly v{VERSION}")
+        exit()
+
+    OFFSET_SECONDS = args.offset
+    VIDEO_H = args.horizontal
+    VIDEO_V = args.vertical
+    TIMECODES = args.json
+    FILTER = args.filter
+    DURACION = args.duracion
+    DRY_RUN = args.dry_run
+
+    ROOT_DIR = pathlib.Path("clips")
+    OUT_H = ROOT_DIR / "horizontal"
+    OUT_V = ROOT_DIR / "vertical"
+    OUT_H.mkdir(parents=True, exist_ok=True)
+    OUT_V.mkdir(parents=True, exist_ok=True)
+
+    def slugify(text: str) -> str:
+        text = unicodedata.normalize("NFKD", text)
+        text = text.encode("ascii", "ignore").decode("ascii")
+        text = re.sub(r"\W+", "_", text.lower())
+        return re.sub(r"_+", "_", text[:40].strip("_")) or "clip"
+
+    def hhmmss_to_sec(t: str) -> float:
+        dt = datetime.strptime(
+            t, "%H:%M:%S.%f") if "." in t else datetime.strptime(t, "%H:%M:%S")
+        return dt.hour * 3600 + dt.minute * 60 + dt.second + dt.microsecond / 1e6
+
+    def sec_to_hhmmss(seconds: float) -> str:
+        s = max(0, seconds)
+        h = int(s // 3600)
+        m = int((s % 3600) // 60)
+        s = s % 60
+        return f"{h:02}:{m:02}:{s:06.3f}"
+
+    with open(TIMECODES, encoding="utf-8") as f:
+        raw_clips = json.load(f)
+
+    clips = [c for c in raw_clips if not FILTER or c.get("category") == FILTER]
+
+    def clasifica(segundos):
+        if segundos <= 30:
+            return "muy_corto"
+        elif segundos <= 90:
+            return "ideal"
+        elif segundos <= 179:
+            return "largo"
+        else:
+            return "muy_largo"
+
+    if DURACION:
+        clips = [
+            c for c in clips
+            if clasifica(hhmmss_to_sec(c["end"]) - hhmmss_to_sec(c["start"])) == DURACION
+        ]
+
+    excel_data = []
+    for c in clips:
+        duracion = round(hhmmss_to_sec(
+            c["end"]) - hhmmss_to_sec(c["start"]), 2)
+        excel_data.append({
+            "slug": c.get("slug"),
+            "titulo": c.get("titulo"),
+            "descripcion": c.get("descripcion", ""),
+            "feeling": c.get("feeling", ""),
+            "category": c.get("category", ""),
+            "start": c.get("start"),
+            "end": c.get("end"),
+            "duracion_segundos": duracion,
+            "duracion_mmss": f"{int(duracion // 60)}:{int(duracion % 60):02}",
+            "clasificacion_duracion": clasifica(duracion),
+            "fecha_publicacion": "",
+            "estado": "por_publicar"
+        })
+
+    df = pd.DataFrame(excel_data)
+    df.to_excel(ROOT_DIR / "estado_clips.xlsx", index=False)
+
+    if VIDEO_H:
+        print("🎬 Procesando clips del video horizontal (sin offset)...")
+        for i, c in enumerate(tqdm(clips, desc="Horizontal")):
+            start = hhmmss_to_sec(c["start"])
+            end = hhmmss_to_sec(c["end"])
+            slug = slugify(c.get("slug", f"clip_{i:02d}"))
+            out = str(OUT_H / f"{i:02d}_{slug}.mp4").replace("\\", "/")
+            cmd = f'ffmpeg -y -hide_banner -loglevel error -ss {sec_to_hhmmss(start)} -to {sec_to_hhmmss(end)} -i "{VIDEO_H}" -c copy "{out}"'
+            if DRY_RUN:
+                print("[DRY RUN]", cmd)
+            else:
+                subprocess.run(cmd, shell=True, check=True)
+
+    if VIDEO_V:
+        print("🎬 Procesando clips del video vertical (con offset aplicado)...")
+        for i, c in enumerate(tqdm(clips, desc="Vertical")):
+            start = hhmmss_to_sec(c["start"]) - OFFSET_SECONDS
+            end = hhmmss_to_sec(c["end"]) - OFFSET_SECONDS
+            slug = slugify(c.get("slug", f"clip_{i:02d}"))
+            out = str(OUT_V / f"{i:02d}_{slug}.mp4").replace("\\", "/")
+            cmd = f'ffmpeg -y -hide_banner -loglevel error -ss {sec_to_hhmmss(start)} -to {sec_to_hhmmss(end)} -i "{VIDEO_V}" -c copy "{out}"'
+            if DRY_RUN:
+                print("[DRY RUN]", cmd)
+            else:
+                subprocess.run(cmd, shell=True, check=True)
+
+    print("\n✅ ¡Listo! Clips generados:")
+    if VIDEO_H:
+        print("📁", OUT_H)
+    if VIDEO_V:
+        print("📁", OUT_V)
+    print("🗂️  Archivo Excel:", ROOT_DIR / "estado_clips.xlsx")
+
+
+if __name__ == "__main__":
+    main()

clipkly-0.1.0/clipkly.egg-info/PKG-INFO

@@ -0,0 +1,210 @@
+Metadata-Version: 2.4
+Name: clipkly
+Version: 0.1.0
+Summary: Corta automáticamente clips de video a partir de subtítulos o timecodes definidos en un JSON.
+Home-page: https://github.com/judlup/clipkly
+Author: Julian Dario Luna Patiño
+Author-email: judlup@trycatch.tv
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas
+Requires-Dist: tqdm
+Requires-Dist: openpyxl
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+
+# 🎬 Clipkly
+
+`Clipkly` es una herramienta en Python para cortar automáticamente clips desde dos versiones de un mismo video (horizontal y vertical), usando un archivo `.json` con los timecodes de los mejores momentos.
+
+Soporta desfase (`--offset`) cuando el video vertical empieza en un punto diferente al horizontal (por ejemplo, por edición o plataformas como TikTok).
+
+---
+
+## 🚀 Uso rápido
+
+```bash
+python clipkly.py --offset 403.025 --vertical video_v.mp4
+```
+
+Esto generará clips desde:
+
+- `video_v.mp4` (con offset aplicado) → en `clips/vertical/`
+
+Si también incluyes `--horizontal`, generará clips desde `video_h.mp4` (sin offset) → en `clips/horizontal/`.
+
+---
+
+## 🧾 Formato del archivo clips.json
+
+```json
+[
+  {
+    "start": "01:46:31.760",
+    "end": "01:47:17.199",
+    "slug": "titulo_del_video",
+    "titulo": "titulo del video optimizado para SEO",
+    "descripcion": "breve descripción del contenido del clip",
+    "feeling": "sentimiento del clip",
+    "category" : "categoria del clip"
+  }
+]
+```
+
+🧠 Puedes generar este archivo a partir de los subtítulos de YouTube (ver más abajo).
+
+📥 Cómo obtener los subtítulos (`.srt`):
+
+1. Ve a https://www.downloadyoutubesubtitles.com/es  
+2. Pega el enlace del video de YouTube  
+3. Descarga el archivo en formato `.srt` (idealmente en español)  
+4. Abre Google AI Studio  
+5. Usa este prompt:
+
+```plaintext
+Estos son los subtítulos de la transmisión, puede darme la lista de los mejores momentos para sacar los clips, también en formato JSON:
+
+{
+  "start": "01:46:31.760",
+  "end": "01:47:17.199",
+  "slug": "titulo_del_video",
+  "titulo": "titulo del video optimizado para seo",
+  "description": "descripción o sinapsis del video",
+  "feeling": "sentimiento del clip",
+  "category" : " categoria del clip"
+}
+```
+
+---
+
+## ⚙️ Argumentos del script
+
+```bash
+python clipkly.py [opciones]
+```
+
+| Opción           | Descripción                                                                 |
+|------------------|-----------------------------------------------------------------------------|
+| `--offset`       | Offset en segundos solo para el video vertical (default: 0.0)               |
+| `--horizontal`   | Ruta al video horizontal (opcional)                                         |
+| `--vertical`     | Ruta al video vertical (opcional)                                           |
+| `--json`         | Ruta al archivo JSON con los timecodes (default: `clips.json`)             |
+| `--filter`       | Filtra los clips por categoría (`inspiracional`, `tips`, etc.)             |
+| `--duracion`     | Filtra clips por duración: `muy_corto`, `ideal`, `largo`, `muy_largo`      |
+| `--dry-run`      | Muestra los comandos sin ejecutarlos                                        |
+| `--version`, `-v`| Muestra la versión del script                                               |
+
+---
+
+## 📁 Estructura generada
+
+```plaintext
+📁 clips/
+ ├── 📁 horizontal/     ← Clips del video horizontal (sin offset)
+ ├── 📁 vertical/       ← Clips del video vertical (con offset)
+ └── 📄 estado_clips.xlsx  ← Archivo Excel con metadatos editoriales
+```
+
+Este Excel incluye:
+
+- duración del clip en segundos (`duracion_segundos`)
+- duración en formato `min:seg` (`duracion_mmss`)
+- clasificación automática:
+  - `muy_corto`: hasta 30s
+  - `ideal`: entre 31s y 90s
+  - `largo`: entre 91s y 179s
+  - `muy_largo`: más de 3 minutos
+
+---
+
+## 📦 Requisitos
+
+- Python 3.7+
+- `ffmpeg` instalado y en el PATH
+- Ejecutar: `pip install -r requirements.txt` para instalar dependencias
+
+Dependencias mínimas:
+
+```
+pandas
+tqdm
+openpyxl
+```
+
+---
+
+## 💡 Funcionalidades
+
+- ✂️ Corta clips precisos con FFmpeg sin recodificar (`-c copy`)
+- 🕒 Aplica offset únicamente al video vertical
+- 📁 Genera carpetas separadas para cada versión (`clips/horizontal` y `clips/vertical`)
+- 🧼 Limpia automáticamente los nombres de archivo
+- 🧠 Exporta Excel para planeación editorial (`estado_clips.xlsx`)
+- 🔍 Filtros por duración y categoría
+- 🔄 Modo `--dry-run` para validar sin ejecutar
+- 🧾 Modo CLI personalizable
+
+---
+
+## 🖥️ Alias útil en consola
+
+Powershell:
+
+```powershell
+Set-Alias clipkly python ./clipkly.py
+```
+
+Linux/Bash:
+
+```bash
+alias clipkly='python ./clipkly.py'
+```
+
+Entonces puedes correr:
+
+```bash
+clipkly --offset 3.25 --vertical video_v.mp4
+```
+
+---
+
+## 📌 Ejemplo completo
+
+```bash
+python clipkly.py --offset 403.025 --horizontal video_h.mp4 --vertical video_v.mp4 --json clips.json --duracion ideal
+```
+
+---
+
+## 🔜 Próximas mejoras sugeridas
+
+- 🎞️ Subtítulos quemados en los clips
+- 📸 Generación de miniaturas automáticas
+- 🌐 Interfaz gráfica simple con Gradio
+- 📊 Dashboard para gestión de clips y publicaciones
+- ☁️ Integración con plataformas como Notion o Google Sheets
+
+---
+
+## 🙌 Créditos
+
+Este proyecto fue creado por **Julian Dario Luna Patiño**, ingeniero de software, arquitecto de soluciones en la nube y creador de contenido en [TryCatch.tv](https://trycatch.tv).
+
+**clipkly** nació como una herramienta práctica para automatizar la creación de clips a partir de transmisiones en vivo, especialmente útil para quienes trabajan con contenido en plataformas como YouTube, TikTok e Instagram.
+
+Contacto: [judlup@trycatch.tv](mailto:judlup@trycatch.tv)
+
+✨ Dedicado con cariño a **Nikol Daniela** ❤️

clipkly-0.1.0/clipkly.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+clipkly/__init__.py
+clipkly/cli.py
+clipkly.egg-info/PKG-INFO
+clipkly.egg-info/SOURCES.txt
+clipkly.egg-info/dependency_links.txt
+clipkly.egg-info/entry_points.txt
+clipkly.egg-info/requires.txt
+clipkly.egg-info/top_level.txt

clipkly-0.1.0/clipkly.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

clipkly-0.1.0/clipkly.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+clipkly = clipkly.cli:main

clipkly-0.1.0/clipkly.egg-info/requires.txt

@@ -0,0 +1,3 @@
+pandas
+tqdm
+openpyxl

clipkly-0.1.0/clipkly.egg-info/top_level.txt

@@ -0,0 +1 @@
+clipkly

clipkly-0.1.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"

clipkly-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

clipkly-0.1.0/setup.py

@@ -0,0 +1,25 @@
+from setuptools import find_packages, setup
+
+setup(
+    name="clipkly",
+    version="0.1.0",
+    packages=find_packages(),
+    install_requires=["pandas", "tqdm", "openpyxl"],
+    entry_points={
+        "console_scripts": [
+            "clipkly=clipkly.cli:main"
+        ]
+    },
+    author="Julian Dario Luna Patiño",
+    author_email="judlup@trycatch.tv",
+    description="Corta automáticamente clips de video a partir de subtítulos o timecodes definidos en un JSON.",
+    long_description=open("README.md", encoding="utf-8").read(),
+    long_description_content_type="text/markdown",
+    url="https://github.com/judlup/clipkly",
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.7",
+)