Videomass Installation Instructions and buildings

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

    Required:
        - Python >=3.7
        - wxPython4 (Phoenix)
        - PyPubSub
        - pip (On Windows and MacOS it is included with Python3.7)
        - FFmpeg (with ffplay and ffprobe) >=4.1.4
        - youtube_dl

    Optionals:
        - mpv (media player) for playing URLs
        - atomicparsley (to embed thumbnail in audio file)

Videomass can be run without installing by un-tarring the source package and
executing the "launcher" script inside the directory.

    python3 launcher

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

    >>> from videomass3 import Videomass3
    >>> Videomass3.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/Installing-from-PyPi-with-pip-command

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

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

    $ python3 setup.py sdist bdist_wheel

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

Make a Debian source package: 

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

Require: python3-setuptools, python3-all, debhelper, dh-python, devscripts

    $ python3 setup.py sdist
    $ cd dist/
    $ mv videomass-2.9.1.tar.gz videomass_2.9.1.orig.tar.gz
    $ tar -xvf videomass_2.9.1.orig.tar.gz
    $ cd videomass-2.9.1/
    - edit debian/changelog file and replace UNRELEASED row with specified 
      debian release e.g. unstable, bionic or focal, etc. then save it.
    $ debuild -S  (you could add the -sa option to digitally sign)

See also others info at:

    - https://wiki.debian.org/SimplePackagingTutorial
    - https://wiki.debian.org/CreatePackageFromPPA#Install_the_Debian_SDK
    - https://wiki.debian.org/Python/LibraryStyleGuide

Please, Visit the Wiki page for more info:

https://github.com/jeanslack/Videomass/wiki/Package-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

and choose the option you want .

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

Build as AppImage (only Linux)

require: pyinstaller

    $ python3 -m pip install --user pyinstaller

Use the 'develop/tools/makeAppImage.py' script like this:

    $ python3 develop/tools/makeAppImage.py
