Desarrolladores

Si eres programador (o quieres convertirte en uno) y estás interesado en desarrollar nuevas funciones, corregir errores o mejorar la interfaz de usuario de OpenShot, las siguientes secciones explicarán cómo comenzar y participar.

La Visión General

OpenShot Video Editor tiene 3 componentes principales: una interfaz de usuario en Python y PyQt (openshot-qt), una biblioteca de audio en C++ (libopenshot-audio) y una biblioteca de video en C++ (libopenshot). Si no estás familiarizado con Python, PyQt o C++, estos serían buenos temas para investigar y aprender más en este punto.

Sin embargo, muchos errores pueden corregirse y nuevas funciones añadirse solo con conocimientos de Python, ya que los componentes en C++ no están involucrados en la interfaz de usuario. Python es un lenguaje increíble, muy divertido de aprender, y es la única habilidad previa necesaria para convertirse en desarrollador de OpenShot.

Advertencia

Las instrucciones que siguen son para Ubuntu Linux, que es el entorno más fácil de configurar para el desarrollo de OpenShot. Si usas otro sistema operativo, sugiero ejecutar una máquina virtual con Ubuntu LTS antes de continuar.

Si debes usar un sistema Windows o Mac para el desarrollo, comienza consultando las notas de compilación en el wiki de libopenshot. Compilar la biblioteca con todas sus dependencias es la parte más desafiante del proceso.

Obteniendo el código fuente más reciente

Antes de poder corregir errores o añadir funciones, necesitamos obtener el código fuente en tu computadora.

Usa git para clonar nuestros 3 repositorios:

git clone https://github.com/OpenShot/libopenshot-audio.git
git clone https://github.com/OpenShot/libopenshot.git
git clone https://github.com/OpenShot/openshot-qt.git

Configurando tu entorno de desarrollo

Para compilar o ejecutar OpenShot, necesitamos instalar algunas dependencias en tu sistema. La forma más fácil de hacerlo es con nuestro Daily PPA. Un PPA es un repositorio no oficial de Ubuntu que tiene nuestros paquetes de software disponibles para descargar e instalar.

sudo add-apt-repository ppa:openshot.developers/libopenshot-daily
sudo apt-get update
sudo apt-get install openshot-qt \
                     cmake \
                     libx11-dev \
                     libasound2-dev \
                     libavcodec-dev \
                     libavdevice-dev \
                     libavfilter-dev \
                     libavformat-dev \
                     libavresample-dev \
                     libavutil-dev \
                     libfdk-aac-dev \
                     libfreetype6-dev \
                     libjsoncpp-dev \
                     libmagick++-dev \
                     libopenshot-audio-dev \
                     libprotobuf-dev \
                     libqt5svg5-dev \
                     libswscale-dev \
                     libunittest++-dev \
                     libxcursor-dev \
                     libxinerama-dev \
                     libxrandr-dev \
                     libzmq3-dev \
                     pkg-config \
                     python3-dev \
                     protobuf-compiler \
                     qtbase5-dev \
                     libqt5svg5-dev \
                     libxcb-xfixes0-dev \
                     qtmultimedia5-dev \
                     swig

En este punto, deberías tener el código fuente de los 3 componentes de OpenShot clonados en carpetas locales, el PPA diario de OpenShot instalado y todas las dependencias de desarrollo y ejecución necesarias instaladas. ¡Es un gran comienzo y ahora estamos listos para empezar a compilar código!

libopenshot-audio (Instrucciones de compilación)

Esta biblioteca es necesaria para la reproducción de audio y efectos de audio. Está basada en el framework de audio JUCE. Aquí están los comandos para compilarla:

cd libopenshot-audio
mkdir build
cd build
cmake -DCMAKE_INSTALL_PREFIX=dist ..
make
make install

Esencialmente, cambiamos a la carpeta libopenshot-audio/build, luego ejecutamos cmake .. en la carpeta padre. Esto encuentra las dependencias y crea todos los Makefiles necesarios para compilar esta biblioteca. Luego, make usa esos Makefiles para compilar la biblioteca, y make install las instala en la ubicación que especificamos. Si CMAKE_INSTALL_PREFIX no está configurado, los archivos se instalarán en /usr/local/ (por defecto) y make install requerirá privilegios administrativos para ejecutarse.

libopenshot (Instrucciones de compilación)

Esta biblioteca es necesaria para la decodificación, codificación, animación de video y casi todo lo demás. Realiza la mayor parte del trabajo pesado de la edición y reproducción de video. Aquí están los comandos para compilarla:

cd libopenshot
mkdir build
cd build
cmake -DLIBOPENSHOT_AUDIO_DIR=../../libopenshot-audio/build/dist ..
make

Esencialmente, cambiamos a la carpeta libopenshot/build, luego ejecutamos cmake .. en la carpeta padre. Esto encuentra las dependencias y crea todos los Makefiles necesarios para compilar esta biblioteca. Luego, make usa esos Makefiles para compilar la biblioteca. Debido a que proporcionamos la ubicación de nuestra instalación compilada de libopenshot-audio, se usará esa versión de la biblioteca en lugar de la versión del sistema (si existe).

No instalamos nuestro libopenshot después de compilar porque no es necesario. Para propósitos de prueba, podemos indicarle a OpenShot que use libopenshot directamente desde nuestro directorio build.

Enlaces de lenguaje

La API de libopenshot está disponible en varios lenguajes mediante enlaces SWIG. Python es usado por la interfaz de usuario de OpenShot, y también ofrecemos enlaces para Ruby y Java. Se incluye soporte experimental para Godot 4.4 para desarrolladores que deseen integrar funciones de edición de video en el motor de juegos Godot. Todos estos enlaces se mapean a la misma base de código en C++ para que puedas editar video desde el entorno que prefieras.

openshot-qt (Instrucciones de lanzamiento)

Esta es nuestra aplicación principal en PyQt y Python. Como está escrita en Python, no requiere compilación para ejecutarse. Para lanzar OpenShot desde el código fuente con nuestras bibliotecas libopenshot-audio y libopenshot recién compiladas, usa los siguientes comandos:

cd openshot-qt
PYTHONPATH=../libopenshot/build/src/bindings/python
python3 src/launch.py

Esto debería iniciar la interfaz de usuario de OpenShot. Cualquier cambio que hayas hecho en los archivos de código fuente (archivos Python *.py, archivos de interfaz PyQt *.ui, etc.) se incluirá. Esto requiere las bibliotecas libopenshot-audio y libopenshot, y si algo salió mal con los pasos anteriores, probablemente OpenShot no se iniciará.

¡Si OpenShot se inicia en este punto, felicidades! Ahora tienes una versión local funcional de OpenShot, que se ejecuta desde tu código fuente local. Intenta hacer algunos cambios en el código fuente y vuelve a iniciar OpenShot… ¡ahora deberías ver tus cambios!

Problemas en GitHub

Ahora que has compilado e iniciado con éxito OpenShot Video Editor desde el código fuente, asegúrate de revisar nuestra lista de informes de errores en GitHub: OpenShot Issues. Además, te animamos a completar nuestro rápido formulario de contribuyente y presentarte.