Development

Phantom-Player is coded in Python, so it is actually pretty easy to develop. It is only necessary to install VLC, GTK, a few Python dependencies, and it will run out of the box. Its source code can be found in Codeberg External Link.

*If you wish to install Phantom-Player in an OS/System that does not have installation packages, install the dependencies that are described below, and execute the installation script.

How to set a Dev Environment

To start developing Phantom Player, you need to download the master branch, and then follow the instructions according your OS/Distribution.

GNU-Linux

  1. Install the dependencies:

    • Debian / Ubuntu

      apt-get install libgtk-3-0 python3 python3-gi-cairo python3-pil python3-magic python3-send2trash python3-vlc
      Note: python3-vlc must be >= 3.0.2, so currently it is not possible to use the software on Debian bookworm.

    • ArchLinux

      pacman -S gtk3 python python-cairo python-pillow python-magic python-send2trash
      and python-vlc from the AUR.

    • Fedora

      dnf install gtk3-devel vlc python3 python3-pip python3-cairo python3-pillow python3-file-magic python3-send2trash
      and pip3 install python-vlc .

    Note: There are different implementations of python magic. If you have it already installed in your system, use that one, the code should be able to handle the differences.

  2. Run install_linux.sh or main.py

FreeBSD

  1. Install the dependencies:
    pkg install gtk3 multimedia/vlc python3 devel/py-pip graphics/py-pillow devel/py-python-magic deskutils/py-send2trash
    and python3 -m pip install python-vlc.
  2. Run install_bsd.sh or main.py

Windows

  1. Install MSYS2 External Link.
  2. Install the dependencies from the MSYS2 console: 
    pacman -S \
    mingw-w64-ucrt-x86_64-gtk3 \
    mingw-w64-ucrt-x86_64-python \
    mingw-w64-ucrt-x86_64-python-pip \
    mingw-w64-ucrt-x86_64-python-gobject \
    mingw-w64-ucrt-x86_64-python-pillow \
    mingw-w64-ucrt-x86_64-file \ 
    mingw-w64-ucrt-x86_64-python-send2trash

    python -m pip install python-magic python-vlc

  3. Install Vlc x64 External Link under C:\Program Files\VideoLAN
  4. Run main.py with Python of the MSYS2 UCRT directory.

Mac

To be tested.