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. Perhaps the fastest and easiest way to get it is to open a console and:
wget http://www.kegel.com/wine/winetricks
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.
Here's its help text as of 2008/05/02 :
Usage: ./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 Access 2000 runtime. License required! cc580 Install native common controls 5.80, override comctl32 colorprofile Install standard RGB color profile corefonts Install MS Arial, Courier, Times fonts dcom98 Install native DCOM, override the Wine implementation dotnet11 Install native .NET 1.1 (requires Windows license) dotnet20 Install native .NET 2.0 (requires Windows license) ffdshow Install ffdshow video codecs flash Install Adobe Flash Player activex gdiplus Install gdiplus.dll from pp viewer (got a better idea?) gecko Install the HTML rendering Engine (Mozilla) icodecs Intel Codecs jet40 Install Jet 4.0 Service Pack 8 liberation Install Red Hat's Liberation fonts (Sans, Serif, Mono) mdac25 MDAC 2.5: Microsoft ODBC drivers, etc. mdac27 MDAC 2.7 mdac28 MDAC 2.8 mfc40 mono19 mono-1.9.1-gtksharp-2.10.4-win32-2 msi2 Microsoft Installer 2.0 msls31 Microsoft Line Services 3.1 (needed by native riched?) msxml3 Microsoft XML version 3 msxml4 Microsoft XML version 4 msxml6 Microsoft XML version 6 pdh Install pdh.dll (Performance Data Helper) riched20 Use Microsoft's riched20 and riched32 riched30 Use Microsoft's riched30 tahoma Install MS Tahoma font (not part of corefonts) vb3run Visual Basic 3 runtime vb4run Visual Basic 4 runtime vb5run Visual Basic 5 runtime vb6run Visual Basic 6 runtime vcrun6 vc6redist from VS6sp4 (mfc42, msvcp60, msvcrt) vcrun2003 Visual C++ 2003 redistributables (mfc71,msvcp71,msvcr71) vcrun2005 Visual C++ 2005 redistributable libraries (mfc80,msvcp80,msvcr80) vcrun2005sp1 Visual C++ 2005sp1 redistributable libraries vcrun2008 Visual C++ 2008 redistributable libraries (mfc90,msvcp90,msvcr90) wmp9 Windows Media Player 9 (requires Windows license) wmp10 Windows Media Player 10 (requires Windows license) wsh51 Windows Scripting Host 5.1 wsh56 Windows Scripting Host 5.6 (install vcrun6 first) wsh56js Windows scripting 5.6, jscript only, no cscript wsh56vb Windows scripting 5.6, vbscript only, no cscript xvid Install xvid video codecs Pseudopackages: allfonts Install all listed fonts (corefonts, tahoma, liberation) allcodecs Install all listed codecs (xvid, ffdshow, icodecs) fakeie6 Set registry to claim IE6sp1 is installed native_mdac Override odbc32 and odbccp32 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.
See Also
http://www.cabextract.org.uk/ -- cabextract is a tool for extracting MS cabinet files under Unix environments.