Qt4 GUI for Wine
***********************************************
 
Q4Wine is a Qt4 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
without any warranty. Feel free to change or distribute this software.

Notes
***********************************************
This software 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 Alexey S. Malakhov (also known as John Brezerk).
 
The general idea came from WineTools, which was initially written by Frank Hendriksen.
 
Dependencies:
***********************************************
cmake
sudo
wine
>=sqlite-3.5.6
>=which-2.19
>=icoutils-0.26.0
>=qt-4.4.0
>=qt-sql-4.4.0		NOTE: qt-sql might have sqlite drivers support!
>=qt-gui-4.4.0
>=qt-core-4.4.0
>=qt-network-4.4.0
>=qt-dbus-4.4.0
>=qt-sdk-4.4.0
wget
fuseiso 		***optional***

Installation
***********************************************

1. $ tar -xvzf q4wine-x.xxx-rx.tar.gz
2. $ cd q4wine
3. $ mkdir build
4. $ cd build
5. $ cmake -DCMAKE_INSTALL_PREFIX=/usr ..
 
   q4wine build options:

       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                   : "en_us;ru_ru;uk_ua;pt_br;es_es;it_it;cs_cz;he_il;fo_ds;fa_ir"

       Optional buils flags:     : Default | Possible

       DEBUG                     : OFF | ON
       RELEASE                   : OFF | ON
       QT5                       : OFF | ON
       WITH_ICOUTILS             : ON  | OFF
       WITH_SYSTEM_SINGLEAPP     : OFF | ON
       WITH_WINEAPPDB            : ON  | OFF
       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;
       QT5                       : If ON, then q4wine will be built with Qt 5.x.
       WITH_ICOUTILS             : If ON, then build q4wine with icoutils support;
       WITH_SYSTEM_SINGLEAPP     : If ON, then use system QtSingleApplication library instead building one;
       WITH_WINEAPPDB            : If ON, then build q4wine with Wine AppDB browser support;
       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;

6. $ make
7. $ make install
8. $ q4wine
9. Enjoy :)

Known Issues:
***********************************************
1. Non-standard directories

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

2. Problem with dual qt3 and qt4 qmake installations

CMake, by default, will search for a qmake binary.
On distributions with both qt3 and qt4 libraries installed, you may
need to create symbolic link from "qmake" to "qmake-qt4".

ls /usr/bin:
lrwxrwxrwx 1 root root 23 2011-07-05 21:07 qmake -> qmake-qt4
-rwxr-xr-x 1 root root 1901408 2011-04-01 19:04 qmake-qt3
-rwxr-xr-x 1 root root 3444152 2011-06-24 17:52 qmake-qt4

3. Problem with dual qt4 and qt5 installations
Make sure you select Qt4 as default Qt version. Install relevant package (e.g. qt4-default in Ubuntu 13.04) if necessary.

Uninstall:
***********************************************
To uninstall q4wine, run the following command from within q4wine's build root:
xargs rm < install_manifest.txt

Changelog
***********************************************
See changelog file for details

-- 
Regards,
 
Alexey S. Malakhov
q4wine (http://q4wine.brezblock.org.ua) lead developer
BrezBlock (http://brezblock.org.ua) maintainer
E-mail address: brezerk@gmail.com
Website: http://brezblock.org.ua
BrezBlock, Kiev, Ukraine

