winetricks is a quick and dirty script to download and install various redistributable runtime libraries sometimes needed to run programs in Wine.
Note: Although using winetricks may be very useful for getting some programs working in Wine, doing so may limit your ability to get support though WineHQ. In particular, reporting bugs may not be possible. See Reporting bugs after you have used Winetricks below.
Note: Some of the packages listed below may not work well with older versions of Wine. As always we recommend you use the latest version of Wine.
Getting winetricks
The script is maintained and hosted by DanKegel at http://www.kegel.com/wine/winetricks. Right-click on that link and use 'save as' to save a fresh copy. Or you can get it from the commandline with the command:
wget http://www.kegel.com/wine/winetricks
The latest winetricks can also be found at http://winezeug.googlecode.com/svn/trunk/winetricks should Dan's link lag behind a few versions.
Also, some winetricks "packages" require the cabextract tool to be installed. The cabextract tool is for extracting Microsoft cabinet files, also called .CAB files. Linux users can usually get it via their distribution's package management system, or visit http://www.cabextract.org.uk/ to download.
Using winetricks
Once you've obtained winetricks you can run it simply by typing sh winetricks at the console. If ran without parameters a winetricks displays a GUI with a list of available packages. If you know the name of the package(s) you wish to install, you can append the name(s) to the winetricks command line and it will immediately start the installation process. For example,
sh winetricks corefonts vcrun6
will install both the corefonts and vcrun6 packages.
Options
Here is its help text as of 2009/10/22:
Usage: /usr/bin/winetricks [options] package [package] ...
This script can help you prepare your system for Windows applications
that mistakenly assume all users' systems have all the needed
redistributable runtime libraries or fonts.
Some options require the Linux 'cabextract' program.
Options:
-q quiet. You must have already agreed to the EULAs.
-v verbose
-V display Version
Packages:
art2kmin MS Access 2000 runtime. Requires Access 2000 Dev license!
atmlib Adobe Type Manager. Needed for Adobe CS4
cmake CMake, the cross-platform, open-source build system
colorprofile Standard RGB color profile
comctl32 MS common controls 5.80
comctl32.ocx MS comctl32.ocx and mscomctl.ocx, comctl32 wrappers for VB6
controlpad MS ActiveX Control Pad
corefonts MS Arial, Courier, Times fonts
cygwin Unix apps for Windows (needed by some build scripts)
d3dx9 MS d3dx9_??.dll (from DirectX 9 user redistributable)
dcom98 MS DCOM (ole32, oleaut32); requires Win98 license!
dinput8 MS dinput8.dll (from DirectX 9 user redistributable)
dirac0.8 the obsolete Dirac 0.8 directshow filter
directplay MS DirectPlay (from DirectX 9 user redistributable)
directx9 MS DirectX 9 user redistributable (not recommended! use d3dx9 instead)
divx divx video codec
dotnet11 MS .NET 1.1 (requires Windows license)
dotnet20 MS .NET 2.0 (requires Windows license)
dotnet30 MS .NET 3.0 (requires Windows license, does not work yet)
droid Droid fonts (on LCD, looks better with fontsmooth-rgb)
ffdshow ffdshow video codecs
flash Adobe Flash Player ActiveX and firefox plugins
fm20 MS Forms 2.0 Object Library
fontfix Fix bad fonts which cause crash in some apps (e.g. .net).
fontsmooth-disable Disables font smoothing
fontsmooth-gray Enables grayscale font smoothing
fontsmooth-rgb Enables subpixel smoothing for RGB LCDs
fontsmooth-bgr Enables subpixel smoothing for BGR LCDs
gdiplus MS gdiplus.dll (from powerpoint viewer)
gecko The HTML rendering Engine (Mozilla)
gecko-dbg The HTML rendering Engine (Mozilla), with debugging symbols
glsl-disable Disable GLSL use by Wine Direct3D
glsl-enable Enable GLSL use by Wine Direct3D (default)
hosts Adds empty C:\windows\system32\drivers\etc\{hosts,services} files
icodecs Intel Codecs (Indeo)
jet40 MS Jet 4.0 Service Pack 8
liberation Red Hat Liberation fonts (Sans, Serif, Mono)
mdac25 MS MDAC 2.5: Microsoft ODBC drivers, etc.
mdac27 MS MDAC 2.7
mdac28 MS MDAC 2.8
mfc40 MS mfc40 (Microsoft Foundation Classes from Visual C++ 4)
mfc42 MS mfc42 (same as vcrun6 below)
mingw Minimalist GNU for Windows, including GCC for Windows!
mingw-gdb GDB for MinGW
mono20 mono-2.0.1
mono22 mono-2.2
mono24 mono-2.4
mozillabuild Mozilla build environment
msi2 MS Installer 2.0
mshflxgd MS Hierarchical Flex Grid Control
msls31 MS Line Services 3.1 (needed by native riched?)
msmask MS Masked Edit Control
msscript MS Script Control
msxml3 MS XML version 3
msxml4 MS XML version 4
msxml6 MS XML version 6
ogg ogg filters/codecs: flac, theora, speex, vorbis, schroedinger
ole2 MS 16 bit OLE
openwatcom Open Watcom C/C++ compiler (can compile win16 code!)
pdh MS pdh.dll (Performance Data Helper)
physx NVIDIA/AGEIA PhysX runtime
psdk2003 MS Platform SDK 2003
psdkvista MS Vista SDK (does not install yet)
psdkwin7 MS Windows 7 SDK (installing just headers and c++ compiler works)
python26 Python 2.6.2 (and pywin32)
quicktime72 Apple Quicktime 7.2
riched20 MS riched20 and riched32
riched30 MS riched30
shockwave Adobe Shockwave Player
tahoma MS Tahoma font (not part of corefonts)
urlmon MS urlmon.dll
vb2run MS Visual Basic 2 runtime
vb3run MS Visual Basic 3 runtime
vb4run MS Visual Basic 4 runtime
vb5run MS Visual Basic 5 runtime
vb6run MS Visual Basic 6 runtime
vc2005sp1 MS Visual C++ 2005 Service Pack 1 (install trial 1st)
vc2005trial MS Visual C++ 2005 Trial
vc2005express MS Visual C++ 2005 Express
vc2005expresssp1 MS Visual C++ 2005 Express SP1 (does not work yet)
vcrun6 MS Visual C++ 6 sp4 libraries (mfc42, msvcp60, msvcrt)
vcrun2003 MS Visual C++ 2003 libraries (mfc71,msvcp71,msvcr71)
vcrun2005 MS Visual C++ 2005 sp1 libraries (mfc80,msvcp80,msvcr80)
vcrun2008 MS Visual C++ 2008 libraries (mfc90,msvcp90,msvcr90)
vjrun20 MS Visual J# 2.0 SE libraries (requires dotnet20)
wininet MS wininet.dll (requires Windows license)
wme9 MS Windows Media Encoder 9 (requires Windows license)
wmp9 MS Windows Media Player 9 (requires Windows license)
wmp10 MS Windows Media Player 10 (requires Windows license)
wenquanyi WenQuanYi CJK font (on LCD looks better with fontsmooth-rgb)
wsh56 MS Windows Scripting Host 5.6
wsh56js MS Windows scripting 5.6, jscript only, no cscript
wsh56vb MS Windows scripting 5.6, vbscript only, no cscript
xact MS XACT Engine (x3daudio?_?.dll, xactengine?_?.dll)
xvid xvid video codec
Apps:
autohotkey Autohotkey (open source gui scripting language)
firefox Firefox
ie6 Microsoft Internet Explorer 6.0
kde KDE for Windows installer
mpc Media Player Classic
vlc VLC media player
Pseudopackages:
allfonts All listed fonts (corefonts, tahoma, liberation)
allcodecs All listed codecs (xvid, ffdshow, icodecs)
fakeie6 Set registry to claim IE6sp1 is installed
native_mdac Override odbc32 and odbccp32
native_oleaut32 Override oleaut32
nocrashdialog Disable the graphical crash dialog
sandbox Sandbox the wineprefix - remove links to ~
nt40 Set windows version to nt40
win98 Set windows version to Windows 98
win2k Set windows version to Windows 2000
winxp Set windows version to Windows XP
vista Set windows version to Windows Vista
winver= Set windows version to default (winxp)
volnum Rename drive_c to harddiskvolume0 (needed by some installers)
Tip: Winetricks knows about the WINEPREFIX environment variable. This is useful for using winetricks on other prefixes. For example,
env WINEPREFIX=~/.winetest winetricks mfc40
installs the mfc40 package for the ~/.winetest prefix.
Tip: Users with more than one version of Wine on their system (for example, an installed package and an uninstalled Wine built from git) can specify which version winetricks should use. For example,
env WINE=~/wine-git/wine winetricks mfc40
installs the mfc40 package using the Wine in the ~/wine-git directory.
Reporting bugs after you have used Winetricks
Please do not report bugs if you have used winetricks to install native (ie non Wine) files, as we cannot support Microsoft dlls.
Using winetricks to install gecko, mono19, and fakeie6 options is acceptable for bug reports - just be sure to mention that's what you've done.
Additionally if you found it necessary to use winetricks for an application please mention it when submitting to the AppDB, mailing lists, and other Wine resources.
Reporting bugs *in* Winetricks
Winetricks has a bug tracking system at http://code.google.com/p/winezeug/issues/list though sending email to wine-devel at winehq.org is usually good enough.
Installing winetricks
Winetricks doesn't need to be installed, but some people like to do it anyway so they can just type 'winetricks' instead of 'sh winetricks'. Here's how:
chmod +x winetricks sudo mv winetricks /usr/local/bin
Some Linux distributions (Suse?) include winetricks in their Wine packages, so you don't have to download or install it. (You might still want to if their version is old.)
See Also
http://www.cabextract.org.uk/ -- cabextract is a tool for extracting MS cabinet files under Unix environments.
http://mike.kronenberg.org/index.php?s=trix (Darwine now comes bundled with trix, a gui that invokes winetricks)
Translations
Winetricks de Deutsch
Winetricks pl Polish
Winetricks ro Romanian
Winetricks es EspaƱol
Winetricks ru Russian
