INSTALL

Videomass Installation Instructions and buildings

BASE DEPENDENCIES
-----------------

    Required:
        - Python >=3.7.0
        - wxPython-Phoenix >=4.0.7
        - PyPubSub
        - requests
        - FFmpeg (with ffplay and ffprobe) >=4.3
    Optionals:
        - youtube_dl
        - yt-dlp
        - atomicparsley (to embed thumbnail in audio file)

Videomass can be run without installing by unpack the source package archive
and executing the "launcher" script inside the root Videomass directory.

    cd Videomass

    python3 launcher

Videomass can also be imported from the Python3 console (interactive mode):

    >>> from videomass import gui_app
    >>> gui_app.main()

#--------------------------------------------------------------------------#

Installing with pip tool: (Linux, MacOs, FreeBSD, Windows, etc.)

    $ python3 -m pip install --user videomass

Upgrading with pip tool: (Linux, MacOs, FreeBSD, Windows, etc.)

    $ python3 -m pip install --user -U videomass

- To uninstall:

    $ python3 -m pip uninstall videomass

Please, Visit the Wiki page for more info:

<https://github.com/jeanslack/Videomass/wiki/Installation-using-pip>

#--------------------------------------------------------------------------#

Build as wheel: (Linux, MacOs, FreeBSD, Windows, etc.)

    $ python3 setup.py sdist bdist_wheel

    or

    $ python3 -m build

    For more info visit: <https://packaging.python.org/tutorials/packaging-projects/>
#--------------------------------------------------------------------------#

Make a Debian source package from upstream source code:

This will transform upstream source code into policy-compliant binary packages.

Please, Visit the Videomass Wiki page for istructions:

<https://github.com/jeanslack/Videomass/wiki/Packaging-for-Debian-and-derivatives>

#--------------------------------------------------------------------------#

Build as executable (Linux, Windows, MacOs)

require: pyinstaller

Use the 'develop/tools/pyinstaller_setup.py' script like this

    $ python3 develop/tools/pyinstaller_setup.py -h

Then choose the option you want.

#--------------------------------------------------------------------------#

Build as AppImage (only Linux)

Use the 'develop/tools/AppImage_build.sh' script

It will make a Videomass AppImage on current directory by installing the latest
version on PYPI