diff --git a/README.html b/README.html index ac51b77..4202942 100644 --- a/README.html +++ b/README.html @@ -852,22 +852,38 @@ href="https://www.msys2.org">https://www.msys2.org/. Accept the default installation location C:\mysys64.

  • MSYS2 packages are installed with a variant of the “pacman” package manager used by -Arch Linux. Open a “MSYS2 MINGW64” terminal from the MSYS2 tab in the -Windows Start menu, and update the new MSYS2 installation with “pacman --Syu”. Then install the MinGW-64 compiler and -cmake

    -
    pacman -S mingw-w64-x86_64-cmake mingw-w64-x86_64-gcc
    -

    The compiler with all required dependencies will be installed in the -msys64 directory, with default path C:/msys64/mingw64. Here -we will simply build UxPlay from the command line in the MSYS2 -environment (this uses “ninja” in place of -“make” for the build system).

  • +Arch Linux. Open a “MSYS2” terminal from the MSYS2 tab in the Windows +Start menu, and update the new MSYS2 installation with “pacman +-Syu”.

    + +
      +
    1. change the MSYS2 terminal type from UCRT64 to MINGW64; (2) modify +mingw-w64-ucrt-x86_64-* package names to mingw-w64-x86_64-*, (just omit +“-ucrt”);
    2. +
    3. replace ucrt64 by mingw64 in directory +names._
    4. +
    +

    Open a new MSYS2 UCRT64 terminal, and install the gcc compiler and +cmake:

    +

    pacman -S mingw-w64-ucrt-x86_64-cmake mingw-w64-ucrt-x86_64-gcc

    +

    We will simply build UxPlay from the command line in the MSYS2 +environment (using “ninja” in place of “make” +for the build system).

  • Download the latest UxPlay from github (to use git, install it with pacman -S git, then “git clone https://github.com/FDH2/UxPlay”), then install UxPlay dependencies (openssl is already installed with MSYS2):

    -

    pacman -S mingw-w64-x86_64-libplist mingw-w64-x86_64-gstreamer mingw-w64-x86_64-gst-plugins-base

    +
    `pacman -S mingw-w64-ucrt-x86_64-libplist mingw-w64-ucrt-x86_64-gstreamer mingw-w64-ucrt-x86_64-gst-plugins-base`

    If you are trying a different Windows build system, MSVC versions of GStreamer for Windows are available from the official GStreamer @@ -884,19 +900,23 @@ build UxPlay with

  • Assuming no error in either of these, you will have built the uxplay executable uxplay.exe in the current (“build”) directory. The “sudo make install” and “sudo make uninstall” features -offered in the other builds are not available on Windows; instead, the -MSYS2 environment has /mingw64/... available, and you can -install the uxplay.exe executable in C:/msys64/mingw64/bin -(plus manpage and documentation in -C:/msys64/mingw64/share/...) with

    -

    cmake --install . --prefix /mingw64

    +offered in the other builds are not available on Windows; instead, you +can install the uxplay.exe executable in +C:/msys64/ucrt64/bin (plus manpage and documentation in +C:/msys64/ucrt64/share/...) with

    +

    cmake --install . --prefix $HOME/../../ucrt64

    +

    You can later uninstall uxplay by returning to the build directory +and running

    +

    ninja uninstall

    +

    (This assumes that certain files in the build directory were not +deleted since building UxPlay).

    To be able to view the manpage, you need to install the manpage viewer with “pacman -S man”.

  • To run uxplay.exe you need to install some gstreamer plugin packages with -pacman -S mingw-w64-x86_64-gst-<plugin>, where the -required ones have <plugin> given by

    +pacman -S mingw-w64-ucrt-x86_64-gst-<plugin>, where +the required ones have <plugin> given by

    1. libav
    2. plugins-good
    3. @@ -913,9 +933,9 @@ Settings->Update and Security->Windows Security->Firewall & network protection -> allow an app through firewall. If your virus protection flags uxplay.exe as “suspicious” (but without a true malware signature) you may need to give it an exception.

      -

      Now test by running “uxplay” (in a MSYS2 terminal -window). If you need to specify the audiosink, there are two main -choices on Windows: the older DirectSound plugin +

      Now test by running “uxplay” (in a MSYS2 UCRT64 terminal +window. If you need to specify the audiosink, there are two main choices +on Windows: the older DirectSound plugin “-as directsoundsink”, and the more modern Windows Audio Session API (wasapi) plugin “-as wasapisink”, which supports device” is not specified, the default audio device is used.

      If you wish to specify the videosink using the -vs <videosink> option, some choices for -<videosink> are d3d11videosink, -d3dvideosink, glimagesink, -gtksink.

      +<videosink> are d3d12videosink, +d3d11videosink, d3dvideosink, +glimagesink, gtksink, +autovideosink. If you do not specify the videosink, the +d3d11videosink will be used (users have reported segfaults of the newer +d3d12 videodecoder on certain older Nvidia cards when the image +resolution changes: d3d11 will used by default until this is fixed).

      The executable uxplay.exe can also be run without the MSYS2 environment, in the Windows Terminal, with -C:\msys64\mingw64\bin\uxplay.

      +C:\msys64\ucrt64\bin\uxplay.

      Usage

      Options: