Q4Wine is a Qt GUI for Wine that helps manage Wine prefixes and installed applications.
This software is published under the terms of the GNU GPL V3 and comes with absolutely no warranty. You will NOT get any support or help for WineTools, Wine, software installations, Linux, Microsoft Windows, and so forth from the author.
If you need help with Wine, send a message to the mailing lists at: http://www.winehq.org/site/forums.
If you want support, buy the commercial versions of Wine: CodeWeavers CrossOver Office http://www.codeweavers.com for Desktop Applications.
Q4Wine was initially written by Oleksii S. Malakhov (also known as John Brezerk).
The general idea came from WineTools, which was initially written by Frank Hendriksen.
- sqlite
- sudo
- which
- cmake >= 3.24
- qt6 >= 6.2.1 (core, gui, svg, network, xml, widgets)
- wine
- wget
- fuseiso
- icoutils
$ tar -xvzf q4wine-x.xxx-rx.tar.gz
$ cd q4wine
$ mkdir build
$ cd build
$ cmake -DCMAKE_INSTALL_PREFIX=/usr ..
By default, q4wine will install all files into these directories:
CMAKE_INSTALL_PREFIX : /usr/local
DESKTOP_ENTRY_PATH : /usr/local/share/applications
PIXMAPS_ENTRY_PATH : /usr/local/share/pixmaps
MANPAGE_ENTRY_PATH : /usr/local/share/man
LIBS_ENTRY_PATH : /usr/local/lib/q4wine (for x86 systems)
LIBS_ENTRY_PATH : /usr/local/lib64/q4wine (for x86_64 systems)
By default, q4wine will build and install all translations:
LINGUAS : "af;cs;de;en;es;fa;fr;he;it;ja;pl;pt_BR;ru;uk;zh_TW"
Optional build flags: : Default | Possible
DEBUG : OFF | ON
RELEASE : ON | OFF
WITH_SYSTEM_SINGLEAPP : ON | OFF
WITH_ICOUTILS : ON | OFF
WITH_WINEAPPDB : OFF | ON
USE_BZIP2 : OFF | ON
USE_GZIP : OFF | ON
WITH_DBUS : ON | OFF
DEBUG : If ON, then q4wine will send debug messages to STDOUT.
: Use it for development or bug reportint purposes;
RELEASE : If OFF, then force q4wine to use APP_BUILD as CMAKE_INSTALL_PREFIX.
: Use it for development purposes;
WITH_ICOUTILS : If ON, then build q4wine with icoutils support;
WITH_SYSTEM_SINGLEAPP : If ON, then use system SingleApplication library instead building one;
WITH_WINEAPPDB : If ON, then build q4wine with Wine AppDB browser support (OBSOLETE);
USE_BZIP2 : Use bzip2 to compress man pages;
USE_GZIP : Use gzip to compress man pages;
WITH_DBUS : If ON, then build q4wine with QtDBus notification support;
$ make
$ make install
$ q4wine
- Enjoy :)
NOTE: These instructions may be outdated, so please see the latest version of this howto here: https://q4wine.brezblock.org.ua/documentation/en_us/02-post-installation.html
If you plan to use kdesu
, gksu
or xdg-su
, then you may wish to add the following lines to /etc/sudoers
(using visudo
). This will allow one to run /sbin/losetup
, which is used for building the mounted .iso
menu lists without prompting for root password.
#---------- Cut here -------------------------
Cmnd_Alias Q4WINE_COMMS=/sbin/losetup
User_Alias Q4WINE_USERS=%games,%users
Q4WINE_USERS ALL=(ALL) NOPASSWD: Q4WINE_COMMS
#---------- End of Cut -----------------------
To uninstall q4wine, run the following command from within q4wine's build root:
xargs rm < install_manifest.txt
You may wish to remove Desktop menu structure as well:
$HOME/.local/share/applications/q4wine
Use kbuildsycoca or kbuildsycoca6 (for KDE) to refresh application menu.
If you have installed q4wine in a non-standard directory, and you get the following error message: "error while loading shared libraries: libq4wine-core.so", then you need to override LD_LIBRARY_PATH variable.
LD_LIBRARY_PATH={$path_to_q4wine_prefix}/lib/ q4wine
You may wish to remove Desktop menu structure as well:
$HOME/.local/share/applications/q4wine
Use kbuildsycoca or kbuildsycoca6 (for KDE) to refresh application menu.
See ChangeLog file for details