winetricks is a quick and dirty script to download and install various redistributable runtime libraries sometimes needed to run programs in Wine.
![/!\](/wiki/winehq/img/alert.png "/!\"){kind=small}
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/05/28:
Usage: $0 [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!
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
d3dx9 MS d3dx9_??.dll (from DirectX 9 user redistributable)
dcom98 MS DCOM (ole32, oleaut32); requires Win98 license!
dirac0.8 the obsolete Dirac 0.8 directshow filter
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)
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 RGB
fontsmooth-bgr Enables subpixel smoothing BGR
gdiplus MS gdiplus.dll (from powerpoint viewer)
gecko The HTML rendering Engine (Mozilla)
gecko-dbg The HTML rendering Engine (Mozilla), with debugging symbols
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)
mono20 mono-2.0.1
mono22 mono-2.2
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
pdh MS pdh.dll (Performance Data Helper)
quicktime72 Apple Quicktime 7.2
riched20 MS riched20 and riched32
riched30 MS riched30
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
vcrun6 MS Visual C++ 6 sp4 libraries (mfc42, msvcp60, msvcrt)
vcrun2003 MS Visual C++ 2003 libraries (mfc71,msvcp71,msvcr71)
vcrun2005 MS Visual C++ 2005 libraries (mfc80,msvcp80,msvcr80)
vcrun2005sp1 MS Visual C++ 2005 sp1 libraries
vcrun2008 MS Visual C++ 2008 libraries (mfc90,msvcp90,msvcr90)
vcrun2008sp1 MS Visual C++ 2008 sp1 libraries
vjrun20 MS Visual J# 2.0 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)
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)
firefox3 Firefox Version 3
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
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.
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