Kevin C. O'Kane, Ph.D.

To run on Windows WSL2 with Ubuntu 24.04 you will need to do the full install shown below. Note: WSL for Windows still (as of this writing) has clock issues in its audio so you may have audio dropouts or static. In most cases, the audio works but don't challenge it with many concurrent processes. This is a Windows problem which they may fix in the next version.

sgr-player-1-august-2026.tgz

Full Installation The most reliable way to install on a Debian-based system is to download and decompress the distro file file (see below) onto your desktop and compile and build the system in its entirety. This should eliminate any library issues which sometimes occur. To do this, from the sgr-player directory, do the following:

sudo ./DebInstall.script
configure
make -B -j cpucount
sudo dpkg --install sgr-player-amd64.deb

Where cpucount is an integer giving the number of processors available.

The first script will download and install system libraries needed by the compile. It will take sometime to execute and produce many messages. If you are using Windows WSL2, you will also need VLC4 - see the README file for details.

The second command configures the source code to your system. The third command compiles the code. You may now run it with the command: sgr-player

See the README file for details on media and other directory locations.

Installers

Note: new versions on Linux usually include new versaions of libraries with slightly different names. The installers use specific names. If a new version uses a newer name, the installer must be updated and rebuilt. The location in the installer where this takes place is in: gr-player/sgr-player-amd64/DEBIAN/control on the Depends: line. Add new names as needed. Note the OR (|) signs. The intaller is rebuilt when you configure/make the system.

Note: you may see messages saying some software is missging after you run the dpkg command below. The second command, the apt command, should correct these issues.

To use an installer to install, download the installer for your version of Linux and, from a terminal window, type the following:

sudo dpkg --install sgr-player-amd64.deb
sudo apt install -f

The second command will install from standard system repositories any missing packages needed to run the sgr-player code. Do not be suprised if on most systems, many packages will be installed. (The DebInstall.script file ion the distro installs all needed libraries except VLC4 - see README)

This installer should work with Ubuntu 26.04.

sgr-player-amd64.deb
August 1, 2026

sgr-player --web-page "https://www.weather.gov/"

Examples:

Installion and Usage Videos

Windows 11

1. Installation on Windows 11 with WSL2

1. SGR Player installation
2. Create an SGR program list
3. How to play a file in SGR
4. SGR Player settings
5. Building SGR albums
6. SGR Player web browsers
7. Builtin SGR Player slide show
8. Drag and drop (recursively)
9. Player Glade layout file
10. Locating widgets in the code part 1
11. Locating widgets in the code part 2
12. Locating widgets in the code part 3
13. Locating widgets in the code part 4
14. Program tile widgets
15. Scrolling the tiles and entry boxes
16. Audio data
17. Converting audio data to visual metering
18. Creating and executing an instance of a VLC player.
19. Main Timer.

1. Ubuntu (with Wayland disabled)

   Ubuntu 21.04 uses Wayland by default. Wayland breaks many Xorg apps including this one. If you want to use the player with Ubuntu 21.04, you need, as root, to modify the file:

   /etc/gdm3/custom.conf

   and uncomment (remove #) from the line:

   #WaylandEnable=false

   and re-boot.

   The issue involves libvlc video embedding. This feature is not currently supported in Wayland by VLC. A version of the player without video embedding will be posted.

   If you are using Nvidia drivers, as of this writing, they are not compatible with Wayland and your system may already be in Xorg mode.

2. Linux Mint LMDE

   No problems.

3. Linux Mint Cinnamon

   No problems.

4. Linux Mint Mate

   No problems.

5. Linux Mint Xfce

   Use cut/paste to add file references to the Edit panel (rather than drag/drop).

6. MX Linux

   Change GTK3 from Breeze to Default Theme.

   The MX default GTK3 theme is called 'Breeze'. This theme generates errors when used with the Player and WebKit. These result in misalignment of widgets on the screen. To compensate, change the setting from Breeze to Default. To do so, go to:

   Settings -> System Settings -> Application Style -> Gnome Application Style (GTK)

   and change 'Select GTK3 Theme' from Breeze to Default.

   This error appears to be a Breeze issue and may be fixed in future releases. Attempts to create a workaround will also be tried in future releases of SGR Player.

7. Debian (with Wayland disabled)

   See notes above for Ubuntu. As above, Wayland needs to be disabled. Edit the file:

   /etc/gdm3/daemon.conf

   and uncomment (remove #) from the line:

   #WaylandEnable=false

For Linux, please run GeneralInstall.script as root. It will install (apt install) any standard system packages you may be missing. Compile scripts are provided. There is a 'Makefile' but it requires the system libraries which GeneralInstall.script installs.

All code is either GPL2 or MIT license.

Videos on the Windows project (development suspended due to MS removal of GTK3+) are at:

1. Large Scale Native Windows 10 GTK Application - Part 1

   https://youtu.be/AtUi7pJFRjs

2. Windows GTK App Part 2 Analysis of Glade file

   https://youtu.be/H96922tU_GQ

3. Windows GTK App Part3 - C/C++ Code Overview

   https://youtu.be/NJfO8PQ75_o

The following is a GTK frontend GUI for ffmpeg casting applications. Most of the documentation is in the tool tips which are shown if you mouse-over an object.

sgr-encoder-src-1.05.tgz