Formatting code for Wine
{{image url="http://www.stable32.com/WineLogo.gif" title="WINE" alt="WINE"}}
[[http://www.winehq.org/ WINE]] runs Windows applications on Linux
===Wine {{color text="Software" c="green"}} [[SoftwareInstallation package(s)]]===
Download the .pet software package then single-left-mouse-click on it for automatic installation: [[http://www.megaupload.com/?d=UPF1FXO7 wine-1.1.30]]
==={{color text="How to activate/use WINE" c="black"}}===
__Use [[rox ROX-Filer]] to locate your Windows program's .exe file__
1) Navigate to: /root
1) View hidden files in that directory by clicking once on the eye icon in toolbar of ROX-Filer.
1) Navigate to: /root/.wine/drive_c/Program Files/
1) Find the .exe file in the relevant subdirectory.
__Start the Windows program by clicking on its .exe file__
WINE will then run the program. If it does not then you must associate .exe files with WINE by doing the following:
1) Right click on the .exe file.
1) Then select: ''Set Run Action''
1) Confirm that the radio button for: //Only for the type 'application/x-ms-dos-executiable'// is selected
1) Or type: ''wine "$@"'' in the field for //Enter a shell command//
1) Now click //Use Command// button.
An alternative method is explained in the //Appendix//.
==={{color text="Installing Windows software" c="black"}}===
Use the file manager to navigate to the directory that contains the program's set-up file //setup.exe// and click on it. This will only work if WINE has been activated first (see above).
When installing commences accept the defaults for where to install. Most installers will default to //C:\Program Files//.
Ensure that the size of the pup_save.2fs file is large enough to accommodate the Windows programs that you wish to install. If necessary increase the size of the personal storage file by going to: Menu > Utility > Resize - personal storage file
Note: Using WINE does not mean you will have success with all Windows Software (""Win32"" software). Some installed programs may not run, or if they do, may subsequently crash. One does not know if a particular software program designed for Windows will run under Linux+WINE until it is actually attempted. WINE is continually being developed and improved resulting in frequent new releases.
[[http://www.murga-linux.com/puppy/viewtopic.php?t=37783 Puppy Linux Forum thread]]
===={{color text="Appendix" c="green"}}====
[//full article for advanced users//]
==={{color text="Making WINE available to Puppy Linux" c="black"}}===
Choose one of the following four methods:
(.sfs files are intended for frugal installations only; .pet files are intended for either full or frugal installations)
1. __Automatic installation using a .pet software package__
The provision of .pet software packages of WINE which someone else has already kindly created means that this is the method //recommended for beginners//.
[user=puppy][password=linux]
http://www.murga-linux.com/puppy/viewtopic.php?p=266552#266552
http://puppylinux.asia/members/T/486_pet/wine-1.1.28-i486.pet (with JACK)
http://puppylinux.asia/members/coolpup/wine-1.1.26-s.pet (without JACK)
http://puppylinux.asia/members/coolpup/wine-1.1.20-prescott.pet (without JACK)
2. __Manual installation using the Slackware binary package for WINE__ (no compiling necessary)
Create a .pet in 5 easy steps:
- Download [[http://sourceforge.net/projects/wine/files/Slackware%20Packages/ latest available]] WINE binary package for Slackware to directory //~/my-documents//, or to any other directory of your choice.
- Navigate to this directory, using the file manager
- With this directory window open and active, press **`** key to open a console (terminal) window, or, alternatively, right-click and select //Window/Terminal Here//
- Type or copy e.g. //tgz2pet wine-1.1.29-i486-1kjz.tgz// into a terminal window; this command converts the .tgz binary package file into a .pet binary package file; to avoid typing the whole file name, type just the first few letters then the rest can be automatically completed by pressing the ''tab'' key, or, copy and then paste with middle-button mouse click
- Click on the created .pet file, and WINE will be installed automatically
3. __No installation by using a single .sfs file__ (for frugal Puppy installations only)
Either create your own or use what someone else has kindly created. Not for beginners unless they know how to follow instructions. ([[http://puppylinux.ca/members/coolpup/wine-1.1.20-prescott_421.sfs Download now]], [[http://www.puppylinux.ca/members/coolpup/wine-1.1.20-prescott_421.sfs-md5.txt md5sum]]; place the SFS file in directory ///mnt/home//; modify the filename suffix so that it corresponds with the version of Puppy Linux in use, e.g. wine-1.1.20_**421**.sfs, wine-1.1.20_**423**.sfs, etc.; go to //Menu > System > ""BootManager""//; click //Choose which extra SFS files to load at boot-up//; configure accordingly and un-tick the box).
4. __Manual installation by compiling the WINE source code__ (and then optionally creating a .pet software package)
If more control is required over the installation process then consult the next section where the alternative process of using the WINE source code (instead of binary packages) is outlined.
==={{color text="Compiling the WINE source code" c="black"}}===
WINE can be installed to Linux by compiling its source code. The process described here is different to the one outlined at the top of this page which was installing WINE by using the (pre-compiled) binary package for a particular operating system (in this case Slackware).
Sometimes the WINE binary packages do not fit one's needs exactly. Perhaps they are not available for ones computer architecture or Linux distribution; or perhaps one wants to build WINE using ones own compiler optimizations or with some options disabled; or perhaps one requires to modify a specific part of the source code before compilation. Being an open source project, one is free to do all of these things with WINE's source code, which is provided with every WINE release. This method of installation can be done by downloading a WINE source code archive and compiling from the command line. Compiling and installing WINE from source is slightly more complex than using a binary package, but not difficult. It will be explained in detail here.
Ensure that the devx_XXX.sfs file is in the same directory as the pup_save.2fs file. **__Otherwise it is not possible to compile anything__**. If that file is not present then it will be necessary to acquire it.
[[http://sourceforge.net/projects/wine/files/ Download]] the latest source file of WINE in compressed tar.bz2 format (known as a tarball).
Navigate to the directory that contains the source tarball. Open a terminal window and extract the WINE source tarball with the command:
%%(language-ref)
tar xfjv wine-1.1.40.tar.bz2
%%
{x main operation mode = extract files from an archive; f device selection = use archive file; j compression option = filter the archive through bzip2; v informative output = verbosely list files processed}
This creates a new directory with the extracted and expanded source code files. This directory will only be created if there is at least 350MB of space available. Now change to this directory that contains the extracted files, so, if the source file //wine-1.1.40.tar.bz2// was downloaded to ///mnt/home//, give the command:
%%(language-ref)
cd /mnt/home/wine-1.1.40
%%
Next, begin the compiling process. WINE contains a script that will automatically build and install WINE, do not use it as it will not install everything to where Puppy Linux would like it to. Using //--prefix=usr// ensures that everything is installed to the correct directories:
%%(language-ref)
./configure CFLAGS="-mtune=generic -O2 -pipe -fomit-frame-pointer" CXXFLAGS="${CFLAGS}" --prefix=/usr --sysconfdir=/etc --localstatedir=/var
%%
then
%%(language-ref)
make depend && make && make check
%%
and then
%%(language-ref)
make install
%%
Now __wait__ whilst it processes. Depending on the capability of the C.P.U. it could take more than an hour. If there are no errors reported then WINE has compiled and installed successfully.
__Do not delete the directory__ within which WINE was compiled (the source directory). Because when a new version of WINE is released the old one can be removed with ease: with that directory open and active open a terminal window and give the command:
%%(language-ref)
make uninstall
%%
The new version can then be compiled and installed. Installed version information can be obtained via:
%%(language-ref)
wine --version
%%
==={{color text="Compile and Install Summary" c="black"}}===
For WINE source file under Puppy Linux:
%%(language-ref)
./configure CFLAGS="-mtune=generic -O2 -pipe -fomit-frame-pointer" CXXFLAGS="${CFLAGS}" --prefix=/usr --sysconfdir=/etc --localstatedir=/var && make depend && make && make check && make install
%%
==={{color text="How to activate/use WINE" c="black"}}===
WINE makes it possible to run computer software, that was specifically written for the Microsoft Windows operating system, with any Unix-like operating system, particularly Linux. Running these Windows-dedicated software can be initiated via two methods.
==={{color text="Method A of running Windows software" c="black"}}===
Start the application by clicking on the program's .exe file, and WINE will run the program. If this does not happen, you can make it happen by associating .exe files with WINE. Do this by right-clicking on the .exe file; then select //Set Run Action...//; confirm that //only for the type 'application...// is selected; for //Enter a shell command:// type __wine "$@"__; click //Use Command//.
To locate your program's .exe file: navigate to ///root//; show hidden files in that directory by left-clicking once on the eye icon in the toolbar; navigate to ///root/.wine/drive_c/Program Files// and expect to find the .exe file in the relevant subdirectory.
==={{color text="Method B of running Windows software" c="black"}}===
Once installed, the program can be run from the command line. When invoking WINE, you may specify the entire path to the executable or a filename only. One of these commands should work [virtually all software written for the Microsoft Windows operating system will by default install to //C:\Program Files//, which in Linux equates to ///root/.wine/drive_c/Program Files//; if this was altered then amend the command accordingly):
%%(language-ref)
wine programname
%%
or
%%(language-ref)
wine programname.exe
%%
or, using DOS filename syntax
%%(language-ref)
wine c:\\program files\\programname\\programname.exe
%%
Start the application by clicking on the program's Menu (or desktop) icon (if it exists), and WINE will run the program.
Because one may have forgotten, or because some programs do not always use obvious naming for their directories or their .EXE file, it might be necessary to examine the ///root/.wine/drive_c// directory to obtain that information.
- Use the file manager to navigate to the directory containing the Windows program you want to run
- Open a console window by pressing the ` key, or, right-click and select //Window/Terminal Here//]
- Type __wine__ followed by the program's executable file, i.e. __wine fantasticprogram.exe__ or __wine fantasticprogram__
The command to run your program can be made into a script, semi-automating this process. Open a file manager window and navigate to ///root/my-applications/bin//. Then right-click and select //menu/new/script//. Give a name for your script. Open the script and add the appropriate lines:
%%(language-ref)
#!/bin/sh
wine c:\\Program Files\\fantasticprogram\\fantasticprogram.exe
%%
Since ///root/my-applications/bin// is in the path, one can now run fantasticprogram from the command line:
%%(language-ref)
nameofscript
%%
This script file can be dragged to the desktop where one can now simply click it to run the script.
==={{color text="Installing Windows Software under Linux" c="black"}}===
Install software designed for Windows in the same way one would under Microsoft Windows: by running the application's installer. Either use the file manager to navigate to the directory that contains the program's set-up file //setup.exe// and click on it, or, use the command line to run the set-up file.
For example, supposing that there is a Photoshop CD in the optical drive which is mounted at /mnt/sr0, then the command to install is:
%%(language-ref)
wine /mnt/sr0/Photoshop/Setup.exe
%%
When installing commences accept the defaults for where to install. Most installers will default to //C:\Program Files//. The application installer may ask permission to create icons on the desktop and in the applications menu. Those icons may not appear, but you can create them later.
Ensure that the size of the pup_save.2fs file is large enough to accommodate the Windows programs that may be installed.
==={{color text="Configuring WINE" c="black"}}===
After its installation, WINE can be configured. Most of the common configuration changes can be done by issuing the __winecfg__ command. The first time it runs it will create a directory //.wine// in ///root//. It will also set up a fake Windows drive inside //.wine//. A window opens where one can configure lots of options. Initially, do not configure anything. But if a particular Windows program does not run __configure WINE to use a different version of Windows__. Some programs will not even install unless WINE reports itself as Windows XP, while others will run better as Windows 98. To configure WINE enter into a terminal window:
%%(language-ref)
winecfg
%%
==={{color text="Using WINE Summary" c="black"}}===
Run the specified program:
%%(language-ref)
wine PROGRAM [ARGUMENTS...]
%%
Display help information and exit:
%%(language-ref)
wine --help
%%
Output version information and exit:
%%(language-ref)
wine --version
%%
[[http://www.winehq.org/docs/wineusr-guide/what-is-wine#AEN53 Wine features]]
[[http://ftp.winehq.org/pub/wine/docs/en/wineusr-guide.html">Official Wine User Guide]]
===Forum threads===
http://www.murga-linux.com/puppy/viewtopic.php?t=37783
http://www.murga-linux.com/puppy/viewtopic.php?t=20548
http://www.murga-linux.com/puppy/viewtopic.php?p=266552#266552
Free technical support is available at the [[http://www.murga-linux.com/puppy/index.php Puppy Linux Discussion Forum]]
----
==Categories==
CategorySoftware
[[http://www.winehq.org/ WINE]] runs Windows applications on Linux
===Wine {{color text="Software" c="green"}} [[SoftwareInstallation package(s)]]===
Download the .pet software package then single-left-mouse-click on it for automatic installation: [[http://www.megaupload.com/?d=UPF1FXO7 wine-1.1.30]]
==={{color text="How to activate/use WINE" c="black"}}===
__Use [[rox ROX-Filer]] to locate your Windows program's .exe file__
1) Navigate to: /root
1) View hidden files in that directory by clicking once on the eye icon in toolbar of ROX-Filer.
1) Navigate to: /root/.wine/drive_c/Program Files/
1) Find the .exe file in the relevant subdirectory.
__Start the Windows program by clicking on its .exe file__
WINE will then run the program. If it does not then you must associate .exe files with WINE by doing the following:
1) Right click on the .exe file.
1) Then select: ''Set Run Action''
1) Confirm that the radio button for: //Only for the type 'application/x-ms-dos-executiable'// is selected
1) Or type: ''wine "$@"'' in the field for //Enter a shell command//
1) Now click //Use Command// button.
An alternative method is explained in the //Appendix//.
==={{color text="Installing Windows software" c="black"}}===
Use the file manager to navigate to the directory that contains the program's set-up file //setup.exe// and click on it. This will only work if WINE has been activated first (see above).
When installing commences accept the defaults for where to install. Most installers will default to //C:\Program Files//.
Ensure that the size of the pup_save.2fs file is large enough to accommodate the Windows programs that you wish to install. If necessary increase the size of the personal storage file by going to: Menu > Utility > Resize - personal storage file
Note: Using WINE does not mean you will have success with all Windows Software (""Win32"" software). Some installed programs may not run, or if they do, may subsequently crash. One does not know if a particular software program designed for Windows will run under Linux+WINE until it is actually attempted. WINE is continually being developed and improved resulting in frequent new releases.
[[http://www.murga-linux.com/puppy/viewtopic.php?t=37783 Puppy Linux Forum thread]]
===={{color text="Appendix" c="green"}}====
[//full article for advanced users//]
==={{color text="Making WINE available to Puppy Linux" c="black"}}===
Choose one of the following four methods:
(.sfs files are intended for frugal installations only; .pet files are intended for either full or frugal installations)
1. __Automatic installation using a .pet software package__
The provision of .pet software packages of WINE which someone else has already kindly created means that this is the method //recommended for beginners//.
[user=puppy][password=linux]
http://www.murga-linux.com/puppy/viewtopic.php?p=266552#266552
http://puppylinux.asia/members/T/486_pet/wine-1.1.28-i486.pet (with JACK)
http://puppylinux.asia/members/coolpup/wine-1.1.26-s.pet (without JACK)
http://puppylinux.asia/members/coolpup/wine-1.1.20-prescott.pet (without JACK)
2. __Manual installation using the Slackware binary package for WINE__ (no compiling necessary)
Create a .pet in 5 easy steps:
- Download [[http://sourceforge.net/projects/wine/files/Slackware%20Packages/ latest available]] WINE binary package for Slackware to directory //~/my-documents//, or to any other directory of your choice.
- Navigate to this directory, using the file manager
- With this directory window open and active, press **`** key to open a console (terminal) window, or, alternatively, right-click and select //Window/Terminal Here//
- Type or copy e.g. //tgz2pet wine-1.1.29-i486-1kjz.tgz// into a terminal window; this command converts the .tgz binary package file into a .pet binary package file; to avoid typing the whole file name, type just the first few letters then the rest can be automatically completed by pressing the ''tab'' key, or, copy and then paste with middle-button mouse click
- Click on the created .pet file, and WINE will be installed automatically
3. __No installation by using a single .sfs file__ (for frugal Puppy installations only)
Either create your own or use what someone else has kindly created. Not for beginners unless they know how to follow instructions. ([[http://puppylinux.ca/members/coolpup/wine-1.1.20-prescott_421.sfs Download now]], [[http://www.puppylinux.ca/members/coolpup/wine-1.1.20-prescott_421.sfs-md5.txt md5sum]]; place the SFS file in directory ///mnt/home//; modify the filename suffix so that it corresponds with the version of Puppy Linux in use, e.g. wine-1.1.20_**421**.sfs, wine-1.1.20_**423**.sfs, etc.; go to //Menu > System > ""BootManager""//; click //Choose which extra SFS files to load at boot-up//; configure accordingly and un-tick the box).
4. __Manual installation by compiling the WINE source code__ (and then optionally creating a .pet software package)
If more control is required over the installation process then consult the next section where the alternative process of using the WINE source code (instead of binary packages) is outlined.
==={{color text="Compiling the WINE source code" c="black"}}===
WINE can be installed to Linux by compiling its source code. The process described here is different to the one outlined at the top of this page which was installing WINE by using the (pre-compiled) binary package for a particular operating system (in this case Slackware).
Sometimes the WINE binary packages do not fit one's needs exactly. Perhaps they are not available for ones computer architecture or Linux distribution; or perhaps one wants to build WINE using ones own compiler optimizations or with some options disabled; or perhaps one requires to modify a specific part of the source code before compilation. Being an open source project, one is free to do all of these things with WINE's source code, which is provided with every WINE release. This method of installation can be done by downloading a WINE source code archive and compiling from the command line. Compiling and installing WINE from source is slightly more complex than using a binary package, but not difficult. It will be explained in detail here.
Ensure that the devx_XXX.sfs file is in the same directory as the pup_save.2fs file. **__Otherwise it is not possible to compile anything__**. If that file is not present then it will be necessary to acquire it.
[[http://sourceforge.net/projects/wine/files/ Download]] the latest source file of WINE in compressed tar.bz2 format (known as a tarball).
Navigate to the directory that contains the source tarball. Open a terminal window and extract the WINE source tarball with the command:
%%(language-ref)
tar xfjv wine-1.1.40.tar.bz2
%%
{x main operation mode = extract files from an archive; f device selection = use archive file; j compression option = filter the archive through bzip2; v informative output = verbosely list files processed}
This creates a new directory with the extracted and expanded source code files. This directory will only be created if there is at least 350MB of space available. Now change to this directory that contains the extracted files, so, if the source file //wine-1.1.40.tar.bz2// was downloaded to ///mnt/home//, give the command:
%%(language-ref)
cd /mnt/home/wine-1.1.40
%%
Next, begin the compiling process. WINE contains a script that will automatically build and install WINE, do not use it as it will not install everything to where Puppy Linux would like it to. Using //--prefix=usr// ensures that everything is installed to the correct directories:
%%(language-ref)
./configure CFLAGS="-mtune=generic -O2 -pipe -fomit-frame-pointer" CXXFLAGS="${CFLAGS}" --prefix=/usr --sysconfdir=/etc --localstatedir=/var
%%
then
%%(language-ref)
make depend && make && make check
%%
and then
%%(language-ref)
make install
%%
Now __wait__ whilst it processes. Depending on the capability of the C.P.U. it could take more than an hour. If there are no errors reported then WINE has compiled and installed successfully.
__Do not delete the directory__ within which WINE was compiled (the source directory). Because when a new version of WINE is released the old one can be removed with ease: with that directory open and active open a terminal window and give the command:
%%(language-ref)
make uninstall
%%
The new version can then be compiled and installed. Installed version information can be obtained via:
%%(language-ref)
wine --version
%%
==={{color text="Compile and Install Summary" c="black"}}===
For WINE source file under Puppy Linux:
%%(language-ref)
./configure CFLAGS="-mtune=generic -O2 -pipe -fomit-frame-pointer" CXXFLAGS="${CFLAGS}" --prefix=/usr --sysconfdir=/etc --localstatedir=/var && make depend && make && make check && make install
%%
==={{color text="How to activate/use WINE" c="black"}}===
WINE makes it possible to run computer software, that was specifically written for the Microsoft Windows operating system, with any Unix-like operating system, particularly Linux. Running these Windows-dedicated software can be initiated via two methods.
==={{color text="Method A of running Windows software" c="black"}}===
Start the application by clicking on the program's .exe file, and WINE will run the program. If this does not happen, you can make it happen by associating .exe files with WINE. Do this by right-clicking on the .exe file; then select //Set Run Action...//; confirm that //only for the type 'application...// is selected; for //Enter a shell command:// type __wine "$@"__; click //Use Command//.
To locate your program's .exe file: navigate to ///root//; show hidden files in that directory by left-clicking once on the eye icon in the toolbar; navigate to ///root/.wine/drive_c/Program Files// and expect to find the .exe file in the relevant subdirectory.
==={{color text="Method B of running Windows software" c="black"}}===
Once installed, the program can be run from the command line. When invoking WINE, you may specify the entire path to the executable or a filename only. One of these commands should work [virtually all software written for the Microsoft Windows operating system will by default install to //C:\Program Files//, which in Linux equates to ///root/.wine/drive_c/Program Files//; if this was altered then amend the command accordingly):
%%(language-ref)
wine programname
%%
or
%%(language-ref)
wine programname.exe
%%
or, using DOS filename syntax
%%(language-ref)
wine c:\\program files\\programname\\programname.exe
%%
Start the application by clicking on the program's Menu (or desktop) icon (if it exists), and WINE will run the program.
Because one may have forgotten, or because some programs do not always use obvious naming for their directories or their .EXE file, it might be necessary to examine the ///root/.wine/drive_c// directory to obtain that information.
- Use the file manager to navigate to the directory containing the Windows program you want to run
- Open a console window by pressing the ` key, or, right-click and select //Window/Terminal Here//]
- Type __wine__ followed by the program's executable file, i.e. __wine fantasticprogram.exe__ or __wine fantasticprogram__
The command to run your program can be made into a script, semi-automating this process. Open a file manager window and navigate to ///root/my-applications/bin//. Then right-click and select //menu/new/script//. Give a name for your script. Open the script and add the appropriate lines:
%%(language-ref)
#!/bin/sh
wine c:\\Program Files\\fantasticprogram\\fantasticprogram.exe
%%
Since ///root/my-applications/bin// is in the path, one can now run fantasticprogram from the command line:
%%(language-ref)
nameofscript
%%
This script file can be dragged to the desktop where one can now simply click it to run the script.
==={{color text="Installing Windows Software under Linux" c="black"}}===
Install software designed for Windows in the same way one would under Microsoft Windows: by running the application's installer. Either use the file manager to navigate to the directory that contains the program's set-up file //setup.exe// and click on it, or, use the command line to run the set-up file.
For example, supposing that there is a Photoshop CD in the optical drive which is mounted at /mnt/sr0, then the command to install is:
%%(language-ref)
wine /mnt/sr0/Photoshop/Setup.exe
%%
When installing commences accept the defaults for where to install. Most installers will default to //C:\Program Files//. The application installer may ask permission to create icons on the desktop and in the applications menu. Those icons may not appear, but you can create them later.
Ensure that the size of the pup_save.2fs file is large enough to accommodate the Windows programs that may be installed.
==={{color text="Configuring WINE" c="black"}}===
After its installation, WINE can be configured. Most of the common configuration changes can be done by issuing the __winecfg__ command. The first time it runs it will create a directory //.wine// in ///root//. It will also set up a fake Windows drive inside //.wine//. A window opens where one can configure lots of options. Initially, do not configure anything. But if a particular Windows program does not run __configure WINE to use a different version of Windows__. Some programs will not even install unless WINE reports itself as Windows XP, while others will run better as Windows 98. To configure WINE enter into a terminal window:
%%(language-ref)
winecfg
%%
==={{color text="Using WINE Summary" c="black"}}===
Run the specified program:
%%(language-ref)
wine PROGRAM [ARGUMENTS...]
%%
Display help information and exit:
%%(language-ref)
wine --help
%%
Output version information and exit:
%%(language-ref)
wine --version
%%
[[http://www.winehq.org/docs/wineusr-guide/what-is-wine#AEN53 Wine features]]
[[http://ftp.winehq.org/pub/wine/docs/en/wineusr-guide.html">Official Wine User Guide]]
===Forum threads===
http://www.murga-linux.com/puppy/viewtopic.php?t=37783
http://www.murga-linux.com/puppy/viewtopic.php?t=20548
http://www.murga-linux.com/puppy/viewtopic.php?p=266552#266552
Free technical support is available at the [[http://www.murga-linux.com/puppy/index.php Puppy Linux Discussion Forum]]
----
==Categories==
CategorySoftware
