OpenCut es un editor de vídeo de código abierto dirigido a navegadores, ordenadores de sobremesa y dispositivos móviles. A menudo se le llama la versión de código abierto de CapCut. Sin embargo, el repositorio principal actual se está reescribiendo desde cero. Lo que se obtiene al clonar directamente main es una nueva arquitectura en desarrollo, que no es equivalente a la versión oficial que es estable y disponible.
Dirección del proyecto: OpenCut-app/OpenCut
Respuesta rápida
Si sólo deseas cortar vídeos ahora, dale prioridad a la versión Clásica que todavía se está ejecutando oficialmente; Si desea estudiar la nueva versión del núcleo de Rust, la arquitectura de complementos, MCP y el renderizado sin cabeza, cree el entorno de desarrollo del repositorio principal.
La nueva versión del plan incluye:
- API de edición;
- Complementos de terceros;
- Los terminales web, de escritorio y móviles comparten el núcleo de Rust;
- Servidor MCP para Agente AI;
- Modo sin cabeza para renderizado por lotes automatizado;
- Panel de guión en el editor.
Éstas son direcciones en las que se están logrando avances y no todas deberían considerarse características estables actuales.
Entorno de desarrollo local
Oficialmente, proto de moonrepo se utiliza para administrar herramientas de desarrollo de versiones fijas. Después de instalar proto, ejecute en el directorio raíz del repositorio:
|
|
El servicio de desarrollo web utiliza localhost:5173 de forma predeterminada y el servicio de desarrollo de API utiliza localhost:8787 de forma predeterminada. Uso de escritorio:
|
|
Las compilaciones de escritorio también deben hacer referencia a las dependencias de la plataforma en apps/desktop/README.md. Los usuarios de Windows, en particular, primero deben confirmar si Rust, las herramientas de compilación del sistema y el entorno de ejecución de WebView están completos.
¿Por qué no se recomienda utilizar la nueva versión directamente como herramienta de producción?
El repositorio principal README establece claramente que la arquitectura aún se está diseñando y aún no está lista para aceptar contribuciones externas. Los usuarios normales pueden encontrar tres tipos de problemas:
- La entrada de la función existe, pero el comportamiento de guardar, exportar o la línea de tiempo cambiará;
- Los documentos y comandos se ajustan rápidamente mediante la reescritura;
- El hecho de que la demostración del navegador pueda ejecutarse no significa que los terminales móviles y de escritorio hayan alcanzado la misma estabilidad.
Así que no entregues tu único proyecto de video a la versión de desarrollo. Haga una copia de seguridad del material antes de realizar la prueba, expórtelo y reprodúzcalo nuevamente para verificar la sincronización, la resolución y la velocidad de cuadros de audio y video.
¿Para quién es adecuado OpenCut?
| Requisitos | Sugerencias |
|---|---|
| Reemplazo instantáneo del software de edición cotidiano | Pruebe primero Classic u otras herramientas maduras |
| Conozca la arquitectura del editor de vídeo de código abierto | Utilice el nuevo repositorio de moderador |
| Desarrollar complementos de vídeo o automatización | Centrarse en API de complementos y patrones sin cabeza |
| Permitir que AI Agent edite automáticamente | Espere hasta que MCP y la API del editor estén estables antes de evaluar |
Cómo elegir entre la versión clásica y la reescrita
El malentendido más común sobre OpenCut actualmente es confundir el Classic disponible en el sitio web oficial, la versión reescrita del repositorio principal y la planificación futura. Puedes elegir por objetivo:
Solo quiero cortar el video.
Primero abra la versión clásica oficial y utilice un clip corto disponible públicamente para probar la importación, el recorte, el audio, los subtítulos y la exportación. No cree primero el repositorio principal y no entregue los únicos archivos del proyecto a la versión de desarrollo.
Quieres estudiar el código fuente.
Utilice el repositorio principal, centrándose en leer apps/, el núcleo de Rust y la configuración de tareas de Moon. Los servicios de desarrollo se pueden iniciar por separado, lo que es más adecuado para localizar problemas, pero aún se pueden ajustar las interfaces de cada módulo.
Quiere participar en complementos o automatización
Continúe prestando atención a la implementación real de la API del Editor, la arquitectura del complemento, el modo sin cabeza y el servidor MCP. Las instrucciones enumeradas en el archivo README no significan que la interfaz se haya congelado. Debe verificar el código correspondiente, Emitir y Lanzar antes del desarrollo formal.
Preparación del entorno de desarrollo
Antes de ejecutar proto use, se deben confirmar las siguientes condiciones básicas:
- Git puede revisar el repositorio normalmente;
- El sistema operativo tiene una cadena de herramientas para compilar dependencias de Rust;
- El comando
protose ha agregado aPATH; - Los puertos
5173y8787no están ocupados; - Se han instalado el WebView y el SDK del sistema necesarios para escritorio;
- El disco tiene suficiente espacio para almacenar dependencias y crear caché.
proto use instalará las herramientas de la versión fija según .prototools en el repositorio. No te lo saltes cuando veas que tienes Node.js o Rust instalado, su propósito es reducir las diferencias de versión entre desarrolladores.
¿Cuáles son los beneficios de iniciar servicios por separado?
OpenCut divide la web, la API y el escritorio en diferentes tareas:
|
|
Al solucionar problemas, se recomienda abrir tres terminales y mantener registros respectivamente. Si no se puede abrir la página, primero verifique el servicio web; si la página se puede abrir pero el proyecto o la operación del material falla, verifique la API; si solo la ventana del escritorio es anormal, finalmente verifique el entorno de ejecución del escritorio.
Verificación del servicio web
Visite http://localhost:5173, abra las herramientas de desarrollo de su navegador y verifique si hay errores de consola y solicitudes a localhost:8787. Si la dirección de la solicitud es incorrecta, primero verifique las variables de entorno local y los documentos del repositorio. No apague CORS directamente.
Verificación del servicio API
Confirme que 8787 esté escuchando y observe el punto final de la API para detectar fallas de inicio, inicialización de la base de datos o errores de permisos. Cuando hay un conflicto portuario, primero busque el proceso de ocupación. No cambie el puerto a voluntad y luego reinicie solo uno de los servicios.
Comprobación de escritorio
El modo escritorio suele tener una capa más de dependencias nativas que el navegador. Cuando la versión web funciona pero la versión de escritorio falla, lo más probable es que el problema esté en el SDK del sistema, WebView, los permisos de archivos o la configuración del paquete, en lugar de en la interfaz del editor en sí.
¿Qué elementos se deben tener en cuenta al probar un editor de vídeo?
Importar
Prepare clips cortos en diferentes codificaciones y resoluciones, incluyendo al menos paisaje, retrato, velocidades de fotogramas variables y audio separado. Registre qué formatos se pueden importar y cuáles solo pueden mostrar miniaturas pero no se pueden reproducir.
Cronología
Pruebe cortar, arrastrar, deshacer, rehacer y sincronización multipista. El problema más común en la versión de desarrollo no es que el botón desaparezca, sino que el estado de la línea de tiempo no coincide con la vista previa después de la operación.
Exportar
Verifique la resolución de salida, la velocidad de cuadros, la duración, la sincronización de audio y video y el tamaño del archivo. La finalización de la exportación no significa que el resultado sea correcto. Debes usar el reproductor para reproducirlo por completo y usar la herramienta de información multimedia para verificar los parámetros de codificación.
Recuperación del proyecto
Cierre la página o el programa de escritorio y vuelva a abrirlo para verificar si el proyecto se guardó, si la ruta del material aún es válida y si el historial de deshacer es el esperado. No trabajes en proyectos largos sin pasar la prueba de recuperación.
Límites cuando es autohospedado
La edición de vídeo del lado del navegador consume CPU, GPU, memoria y almacenamiento local. Incluso si se implementa en su propio servidor, el trabajo de renderizado puede realizarse en el lado del cliente. Al evaluar las opciones autohospedadas, asegúrese de:
- ¿El material se sube al servidor o simplemente permanece en el navegador?
- ¿Dónde se guardan los archivos del proyecto?
- ¿La exportación se completa mediante el navegador, el núcleo del escritorio o el servidor?
- ¿Existe un mecanismo de limpieza de archivos temporal?
- Si varios usuarios verán los proyectos o activos de los demás.
No confíe simplemente en el “fuente abierto” para inferir que los datos nunca salen del dispositivo; aún así se deben leer las solicitudes de red reales y la configuración de implementación.
No mires sólo el menú cuando lo compares con un software de edición maduro
| Dimensiones | Lo que realmente se está verificando |
|---|---|
| Estabilidad | Edición a largo plazo, deshacer, recuperación de fallas |
| Soporte de formato | Codificación real de importación y exportación |
| Rendimiento | Retraso de vista previa, medios proxy, tiempo de renderizado |
| Subtítulos | Importar, editar, diseñar y exportar |
| Automatización | API, Headless, madurez de tareas por lotes |
| Ecología | Complementos, plantillas, tutoriales y velocidad de mantenimiento |
El camino futuro para OpenCut es intrigante, pero las decisiones de migración deben basarse en capacidades verificables actuales.
Solución de problemas de comprobación rápida
| Pregunta | Verificación de prioridad |
|---|---|
proto no encontrado |
Si se completa la instalación, si se reinicia el terminal, PATH |
moon run falló |
.prototools Si la instalación fue exitosa y si las sucursales del repositorio coinciden |
| 5173 No se puede acceder | Registro de tareas web y ocupación de puertos |
| La página se puede abrir pero se produce un error de operación | Servicio API, solicitud 8787 y variables de entorno |
| Error en el escritorio | apps/desktop/README.md y dependencias del sistema |
| Resultados de exportación anormales | Codificación de materiales, registros de renderizado y parámetros de salida |
Preguntas frecuentes
¿Puede OpenCut reemplazar completamente a CapCut?
No es posible sacar conclusiones sencillas en este momento. Se pueden probar escenas de edición básicas, pero las plantillas, los efectos especiales, los subtítulos, la ecología de los materiales y los flujos de trabajo entre dispositivos aún deben compararse uno por uno.
¿Por qué se puede iniciar el repositorio pero no se puede exportar normalmente?
Primero confirme si está utilizando la versión clásica o reescrita y verifique la rama y la documentación correspondientes. Si el servicio de desarrollo del repositorio principal se inicia con éxito, solo significa que el front-end y el back-end pueden ejecutarse, pero no significa que se hayan completado todas las funciones de edición.
¿Puedo usar Docker para implementar una nueva versión con un solo clic?
La disponibilidad de imágenes y configuraciones de Compose debe estar sujeta a la documentación actual del repositorio. Los servicios de desarrollo involucran navegadores, API y escritorios, y las imágenes de terceros no mantenidas no deben considerarse métodos oficiales de implementación estable.
¿Se puede utilizar MCP de OpenCut para la edición por lotes ahora?
El README enumera MCP como una de las direcciones de reescritura. Antes del acceso real, debe confirmar que el código actual y la versión hayan proporcionado servidores, listas de herramientas y descripciones de permisos disponibles. No puede configurar tareas de producción basándose únicamente en el texto de planificación.
Cómo realizar un seguimiento del progreso de la reescritura
El repositorio principal de OpenCut cambia rápidamente. Al juzgar si una determinada función está disponible, verifique en este orden:
- LÉAME descripción del estado actual;
- Si existe una versión correspondiente en Lanzamientos;
- Si existe una implementación real en el código;
- Si el Problema está marcado con limitaciones o fallas conocidas;
- Si la nueva versión de la estación de demostración puede completar la misma operación;
- Si la versión de pago local es consistente con el envío del documento.
No se limite a mirar capturas de pantalla, hojas de ruta o vídeos de terceros. Las API MCP, Headless y de complementos en particular solo son adecuadas para desarrollar la automatización de la producción una vez que estén disponibles interfaces estables, descripciones de permisos y ejemplos reproducibles.
Actualización y reversión de la versión de desarrollo
Antes de actualizar, registre la confirmación de Git actual y la versión de la herramienta analizada por .prototools. Si hay cambios locales, primero cree una sucursal y envíela. No lo extraiga directamente y luego mezcle actualizaciones de dependencia con modificaciones comerciales.
Pasos recomendados:
|
|
Luego inicie las tareas web, API y de escritorio respectivamente, y vuelva a ejecutar las pruebas de importación, línea de tiempo, exportación y recuperación. Si no se puede utilizar la nueva versión, puede volver a las confirmaciones registradas para compararlas, pero no utilice comandos destructivos de Git para descartar material o código no guardado.
Verificación de materiales y privacidad
Al probar la versión de desarrollo, utilice materiales breves que puedan divulgarse y evite vídeos de clientes, rostros, productos inéditos y vídeos originales con información de posicionamiento. Abra el panel de red del navegador para confirmar la solicitud de carga y el nombre de dominio de terceros; en el escritorio, verifique también si el caché, los archivos temporales y los registros de fallas contienen la ruta del material.
Si la función MCP o script está habilitada en el futuro, el proyecto del editor, el directorio de materiales y el directorio de exportación deben autorizarse por separado y no permitir que el Agente lea todo el directorio de inicio del usuario de forma predeterminada.
Resumen
OpenCut merece atención, pero el mensaje más importante es “actualmente en proceso de reescritura”. Los usuarios comunes deben usar Classic como punto de entrada actual, mientras que los desarrolladores pueden usar proto y moon para estudiar nuevas versiones. Una vez que la API del editor, los complementos y el renderizado sin cabeza estén estables, será más adecuado ingresar al proceso de producción automatizado.