konarev / wine-launcher-creator

Automatically exported from code.google.com/p/wine-launcher-creator
14 stars 1 forks source link

About

WLCreator is a Python program (script) that creates Linux desktop launchers for Windows programs (using Wine). The program does the following tasks:

  1. Find/extract ico files (using icoutils)
  2. Convert ico files to png files (using icoutils)
  3. Present the user with graphical interface, where he/she can choose the icon for launcher, and
  4. Create desktop launcher

Usage

WLCreator will try to extract icons from exe file, and to search for all ico files in exe's directory and its subdirectories, and to convert them to png files. Additionaly, it will search for png files in application's main directory. After that, the user is presented with a graphical interface where he/she can choose the icon and launcher's name. A few options are also available:

* Toplevel application path - path to search for program's icon
  (Windows games often have their executable in some subdirectory under the
  main game directory - usually you should choose main game directory for
  icon search)
* Path for launcher creation (default is ~/Desktop/)
  (a copy of launcher is also created in ~/.local/share/applications/wlcreator/)
* Path for icon (default is ~/.local/share/icons/wlcreator/)
* Wine command for launching (default is wine)
* Path for wine configuration directory (default is ~/.wine)

Options are saved in ~/.config/wlcreator/ directory.

WLCreator uses wrestool (icoutils) to extract icons from exe files, and icotool (icoutils) to convert ico files to png files. It uses Qt framework and PyQt bindings for Python, and also some bash commands.

Sometimes wrestool cannot extract icons, and this is the situation where icon extraction/finding must be done separately by the user. When ico/png file is obtained, just put it alongside exe file and start wlcreator.

Also, icotool sometimes cannot extract png from ico, and in this situation, easy solution is to open ico file with GIMP, and save as png (for this, wlcreator will save all extracted ico files in exe's directory).

Integration

To use it as nautilus action, you need to install nautilus-actions package. After that, you can use appropriate option in Settings section to install this script as nutilus action:

To use it as nautilus script, you need to have nautilus-scripts-manager package installed. You can enable it using appropriate option in Settings section, or alternatively, you can enable it using System->Preferences->Nautilus scripts manager

To use it as a KDE 4 Dolphin Service, select appropriate option in Settings section.

IMPORTANT: Gnome 3 users need to logout/login before new launcher is active, or alternatively, press ALT+F2 and enter "r" to restart the shell.

Integration is tested on Ubuntu 12.04 (Unity), OpenSUSE 12.3 (KDE 4) and Fedora 17 (Gnome 3).

Command line

You can also run it from command line with:

wlcreator.py [path_to_exe_file [path_to_application_toplevel_directory]]

Disabling network access

Additional information about restricting internet access to (untrusted) (Windows) application can be found in NoInternet.txt (/usr/local/share/wlcreator/NoInternet.txt)