Become an OpenShot Developer

If you are a programmer (or wanting to become a programmer), and are interested in developing new features, fixing bugs, improving the user interface, or developing new themes for OpenShot, the following sections will explain the steps and processes you will need to follow.

The Big Picture

OpenShot is a Python program made up of many different Python files (.py), images (.svg, .png),  XML files (.xml), GTK+ XML files (.ui), and Blender project files (.blend).  Python is an interpreted language, which means there are no files that need compiling or building to run OpenShot.  If you change any of the source files, you just need to close and relaunch OpenShot to see the changes.

Getting the Latest Source Code

OpenShot hosts the latest version of source code on LaunchPad.net, using the Bazaar version control system.

  1. Install the Bazaar version control system.  In Debian (or Ubuntu), you can type

    $ sudo apt-get install bzr

  2. Tell Bazaar to create a local branch for your computer.  This will create an /openshot/ folder in your home folder and download the latest source code into that folder.  For example: /home/USER/openshot/

    $ bzr branch lp:openshot

  3. If you already have an /openshot/ folder, just change your current directory to it, and run the following command to get the lastest version:

    $ cd /home/USER/openshot/

    $ bzr pull lp:openshot

  4. Now you should have the latest source code for OpenShot.  To launch OpenShot from this folder, you must run the following commands.  Remember, you must already have the dependencies for OpenShot installed, which is covered in the next topic.

    $ cd /home/USER/openshot/bin/

    $ ./openshot  or  python openshot

  5. If you have made some changes to the OpenShot source code, and want to see everything you have changed, run this command:

    $ cd /home/USER/openshot/

    $ bzr status

  6. If you are unhappy with your local changes, and want to revert your changes, run this command:

    $ cd /home/USER/openshot/

    $ bzr revert

Setting Up Your Environment

Uma vez que você obteve a última versão do código fonte, o passo seguinte é instalar todas as dependências requeridas.  Eu recomendaria a instalação do OpenShot a partir do seu gerenciador de pacotes favorito (como o Synaptic).  Isto irá instalar uma versão do OpenShot e todas as dependências.  E não vai conflitar com a sua versão local do código fonte do OpenShot.  A única dica é se lembrar que o comando $ openshot irá executar a versão oficial do OpenShot, e não a sua versão local.  Então você deve se lembrar de executar o OpenShot com os seguintes comandos:

$ cd /home/USER/openshot/bin/

$ ./openshot  or  python openshot

Now that you have the latest source code and all of the dependencies, you can either use a text editor (such as gedit), or a full Python IDE, such as Eclipse or Aptana (with Pydev) to modify the source code.  The advantage of using a full Python IDE is the enhanced debugging capabilities.  It is beyond the scope of this document to teach you how to debug Python with Eclipse or Aptana, but there are lots of good tutorials online.

Corrigindo seu primeiro erro

Agora que você está executando uma versão local do OpenShot, corrigir erros e adicionar novas funcionalidades é fácil.   Simplesmente modifique os arquivos, e reinicie o OpenShot para ver as mudanças feitas.  E, claro, eu não posso dizer exatamente como corrigir um erro, pois isso fica a seu critério.  Boa sorte!

Compartilhando suas alterações com o Time do OpenShot

Uma vez que você tenha corrigido um erro ou adicionado uma boa funcionalidade, o próximo passo é compartilhar isso com o Time do OpenShot, então nós podemos estar certos de que as suas modificações estarão na versão oficial do OpenShot.  A maneira mais fácil de compartilhar suas modificações é criando um patch (ou diff).  Use o seguinte comando para criar um patch:

$ cd /home/USER/openshot/

$ bzr diff > minhas_mudanças.patch

Isto criará um arquivo chamado minhas_mudanças.patch, que deverá conter todas as mudanças de todos os arquivos que você modificou.  Claro, se você criou arquivos novos, será necessário compactá-los em um arquivo ZIP ou TAR, e incluí-los junto com o arquivo minhas_mudanças.patch.

Next, create a new bug report on LaunchPad (or find an existing bug report), and upload your patch and related files to the bug report.  That's it!  The OpenShot team will be notified by email that a patch has been submitted.  Now you can subscribe to the bug report, and follow along to see if there are any questions or comments about your patch.

Junte-se ao Time de Desenvolvedores do OpenShot no LaunchPad

If you are fixing bugs or adding new features to OpenShot, please consider joining our team on LaunchPad.  We have a mailing list that will keep you up to date on the newest bug reports and plans related to OpenShot.