mlliarm / WineGui

Finally, a user-friendly WINE graphical interface (mirror from Gitlab)

WineGUI

Finally, a user-interface friendly WINE (A compatibility layer capable of running Windows applications under Linux) Manager.

User-interface is created by using GTK+ (gtkmm c++-interface) and C++ code.

Download

You can find the latest version on the Releases page.

Download the WineGUI package you require for your Linux distribution (we provided .deb, .rpm and .tar.gz files). Typically you should use .deb file for Ubuntu and Linux Mint distros.

Install the package and you are ready to go! WineGUI should be listed in your menu.

Development

Development has been done in VSCcodium, using the following extensions:

• C/C++
• CMake
• CMake Tools
• GitLab Workflow

Documentation

See latest WineGUI Developer Docs.

Requirements

Dependencies should be met before build:

• gcc/g++ (adviced: v7.3 or later)
• cmake (adviced: v3.10 or later)
• ninja-build
• libgtkmm-3.0-dev (implicit dependency with libgtk-3-dev)
• libjson-glib-dev
• pkg-config

Optionally:

• doxygen
• graphviz
• rpm
• cppcheck

Hint: You could execute ./scripts/deps.sh script for Debian based systems (incl. Ubuntu and Linux Mint) in order to get all the dependencies installed automatically.

Build

Run: ./scripts/build.sh

Or execute: mkdir -p build && cd build && cmake -GNinja .. && ninja

Run

Execute within the build directory: ninja run

Or:

./build/bin/winegui

Rebuild

Cmake is only needed once, after that you can often use:

ninja

Clean the build via: ninja clean

Hint: Run ninja help for all available targets.

Debug

You can use the helper script: ./scripts/build_debug.sh

Start debugging in GDB (GNU Debugger):

cd build_debug
gdb -ex=run bin/winegui

Production

For production build and DEB file package, you can run: ./scripts/build_prod.sh

Or use:

cmake -DCMAKE_BUILD_TYPE=Release
ninja

Build Doxygen

Or build with generated doxygen files locally:

cmake -GNinja -Ddoc=ON
ninja

Releasing

Before you can make a new release, align the version number in WineGUI with the version you want to release. Then create a new tagged version in Gitlab with the same version name.

Note: Only a release tag on the master branch will trigger the publish task.

Coding standard

We follow the Google C++ Style Guide.

CI

For continuous integration we use our Dockerfile to create a Docker image. This image (danger89/gtk3-docker-cmake-ninja) is hosted on Dockerhub.

A helper script can be used: ./scripts/build_and_upload_image.sh, after successfully identified via docker login --username=<username>.