Winetricks is an easy way to work around problems in Wine
Shell Other
Latest commit a864b06 Dec 7, 2017 @mihaitodor mihaitodor committed with austin987 winetricks: Fix font duplication

README.md

Winetricks

Homepage of Winetricks, previously hosted at https://code.google.com/p/winetricks.

Winetricks is an easy way to work around problems in Wine.

It has a menu of supported games/apps for which it can do all the workarounds automatically. It also lets you install missing DLLs or tweak various Wine settings individually.

The latest version can be downloaded here: https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks

Tagged releases are accessible here: https://github.com/Winetricks/winetricks/releases

Installing

If available and up to date, you should use the winetricks package, available in most distributions:

If it's not available, outdated (e.g., Ubuntu LTSs), or you want the bleeding edge version, you can manually install winetricks:

wget https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks
chmod +x winetricks
sudo mv winetricks /usr/local/bin

or if you don't have wget, you can use curl:

curl -O https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks
chmod +x winetricks
sudo mv winetricks /usr/local/bin

Note: /usr/local/bin must be in your $PATH for this to work.

You can then keep winetricks up to date in the future by doing:

winetricks --self-update

Custom .verb files

You can pass winetricks a custom .verb (format below), that can be used to add new dlls/settings/programs.

Example icecat.verb:

w_metadata icecat apps \
    title="GNU Icecat 38.8.0" \
    publisher="GNU Foundation" \
    year="2016" \
    media="download" \
    file1="icecat-38.8.0.en-US.win32.zip" \
    installed_exe1="${W_PROGRAMS_X86_WIN}/icecat/icecat.exe"

load_icecat()
{
    w_download https://ftp.gnu.org/gnu/gnuzilla/38.8.0/${file1} e5f9481e78710c25eb3a271d81aceb19ef44ff6e8599da7d5f7a2da584c01213
    w_try_unzip "${W_PROGRAMS_X86_UNIX}" "${W_CACHE}/${W_PACKAGE}/${file1}"
}

Note that the file prefix (icecat.verb) and command name (icecat) must match. All metadata fields are optional, only command name and category required.

Tests

The tests need bashate, checkbashisms, and shellcheck>=0.4.4 installed. Makefile supports a few test targets:

  • check - runs './tests/winetricks-tests quick' (without first clearing $WINETRICKS_CACHE)
  • shell-checks - runs './tests/shell-checks'
  • test - runs './tests/winetricks-tests full' (and clears $WINETRICKS_CACHE first)
  • xvfb-check - runs './tests/winetricks-tests xvfb-check' (without first clearing $WINETRICKS_CACHE first)

Support