Development

Phantom-Player is coded in Python, so it is actually pretty easy to develop. It is only necessary to install GStreamer*, GTK, a few Python dependencies, and it will run out of the box.

The source code of Phantom-Player can be found in Codeberg .

*Note: The last stable version is based in VLC but that is now deprecated, development versions are based on GStreamer.

How to set a Dev Environment

To start developing Phantom Player:

1. Download the master branch
2. Install the Dependencies according your OS/Distribution
3. Execute the software directly from sources.

Additionally, if you want to install it, execute the related installation script.

Note: There are two different implementations of Python magic. If you have already one installed in your system, do not change it, the software will handle the differences.

GNU-Linux & BSD

1. Install the dependencies:

   Debian / Ubuntu

   apt-get install \
       libgtk-3-0 \
       gstreamer1.0-gl \
       gstreamer1.0-plugins-base \
       gstreamer1.0-plugins-good \
       gstreamer1.0-plugins-bad \
       gstreamer1.0-gtk3 \
       python3 \
       python3-gi-cairo \
       python3-pil \
       python3-magic \
       python3-send2trash

   and it is also recommended:

   apt-get install \
       gstreamer1.0-libav
       gstreamer1.0-plugins-ugly

   Arch Linux

   pacman -S \
       gtk3 \
       gstreamer \
       gst-plugins-base \
       gst-plugins-base-libs \
       gst-plugins-good \
       gst-plugins-bad \
       gst-plugin-gtk \
       python \
       python-cairo \
       python-pillow \
       python-magic \
       python-send2trash

   and it is also recommended:

   pacman -S \
       gst-libav \
       gst-plugins-ugly

   Fedora

   dnf install \
       gtk3-devel \
       gstreamer1 \
       gstreamer1-plugins-base \
       gstreamer1-plugins-good \
       gstreamer1-plugins-bad-free \
       gstreamer1-plugins-good-gtk \
       python3 \
       python3-cairo \
       python3-gobject \
       python3-pillow \
       python3-file-magic \
       python3-send2trash

   and it is also recommended:

   dnf install \
       gstreamer1-plugin-libav \
       gstreamer1-plugins-ugly-free

   FreeBSD

   pkg install \
       gtk3 \
       gstreamer1 \
       gstreamer1-plugins-good \
       gstreamer1-plugins-bad \
       gstreamer1-plugins-gtk \
       python3 \
       py311-gstreamer1 \
       py311-cairo \
       py311-pillow \
       py311-magic
       py311-send2trash

   and it is also recommended:

   pkg install \
       gstreamer1-libav \
       gstreamer1-plugins-ugly

2. Run install.sh or main.py

Windows

1. Install MSYS2 .
2. Install the dependencies:

   MSYS2 console

   pacman -S \
       mingw-w64-ucrt-x86_64-gtk3 \
       mingw-w64-ucrt-x86_64-gst-plugins-base \
       mingw-w64-ucrt-x86_64-gst-plugins-good \
       mingw-w64-ucrt-x86_64-gst-plugins-bad \
       mingw-w64-ucrt-x86_64-gst-plugin-gtk \
       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

   and it is also recommended:

   pacman -S \
       mingw-w64-ucrt-x86_64-gst-libav \
       mingw-w64-ucrt-x86_64-gst-plugins-ugly

   Finally, install from Python:

   python -m pip install python-magic --break-system-packages

   
   
3. Run main.py from the MSYS2 UCRT console.

Mac

To be tested.