PlayOnLinux - User contributions [en]

Installing PlayOnMac

2016-02-19T19:31:47Z

Stephenwb: /* Next? */

PlayOnMac installs on your computer is extremely easy. All you have to do is follow these four small steps that are described in the following section.

=== Installation ===

# Go [http://www.playonmac.com/en/download.html the download page PlayOnMac]
# Download the latest version of PlayOnMac
# Once download, install 'PlayOnMac_X.XXdmg' 'on your desktop (double click on the file)
# You will find inside an uninstall software (to remove PlayOnMac your computer) and the software. You simply drag-and-drop it in your '' Applications ''

=== Using GIT Version ===

The git repository will always have the latest version. It is only recommended for advanced users and programmers. It has the advantage of providing an automatic update button, unlike other versions of the program. To install it on your computer, first you must install and configure git. Once this is done, you can download PlayOnMac using the following command:

git clone https://github.com/PlayOnLinux/POL-POM-4

{{Info|This command will download the program to your current folder. Consider making use of 'cd' before running the command to get to where you want the files to be downloaded to. }}Unlike packaged installation, this method won't install PlayOnMac system-wide

{{Info|On Mac, the easier way to use the development version is to first deploy a stable version of PlayOnMac, then to replace the /Applications/PlayOnMac.app/Contents/Resources/playonlinux folder with a clone of the git repository.}}

=== Next? ===
Now that you have installed PlayOnMac on your computer, we suggest you read our [[First Use| guide for first use of the software]] which will explain the basics on how to install and uninstall Windows programs with PlayOnMac.

Installing PlayOnMac

2016-02-19T19:30:38Z

Stephenwb: /* Using GIT Version */ Fixing English-as-a-second-language awkward wording

PlayOnMac installs on your computer is extremely easy. All you have to do is follow these four small steps that are described in the following section.

=== Installation ===

# Go [http://www.playonmac.com/en/download.html the download page PlayOnMac]
# Download the latest version of PlayOnMac
# Once download, install 'PlayOnMac_X.XXdmg' 'on your desktop (double click on the file)
# You will find inside an uninstall software (to remove PlayOnMac your computer) and the software. You simply drag-and-drop it in your '' Applications ''

=== Using GIT Version ===

The git repository will always have the latest version. It is only recommended for advanced users and programmers. It has the advantage of providing an automatic update button, unlike other versions of the program. To install it on your computer, first you must install and configure git. Once this is done, you can download PlayOnMac using the following command:

git clone https://github.com/PlayOnLinux/POL-POM-4

{{Info|This command will download the program to your current folder. Consider making use of 'cd' before running the command to get to where you want the files to be downloaded to. }}Unlike packaged installation, this method won't install PlayOnMac system-wide

{{Info|On Mac, the easier way to use the development version is to first deploy a stable version of PlayOnMac, then to replace the /Applications/PlayOnMac.app/Contents/Resources/playonlinux folder with a clone of the git repository.}}

=== Next? ===
Now that you have installed on your computer PlayOnMac, I suggest you to read our [[First Use| guide for first use of the software]] who will explain the basics to know to install and uninstall Windows programs with PlayOnMac.

Installing PlayOnMac

2016-02-19T19:28:18Z

Stephenwb: /* Installation */ Fixed download link to point to English instead of French page

PlayOnMac installs on your computer is extremely easy. All you have to do is follow these four small steps that are described in the following section.

=== Installation ===

# Go [http://www.playonmac.com/en/download.html the download page PlayOnMac]
# Download the latest version of PlayOnMac
# Once download, install 'PlayOnMac_X.XXdmg' 'on your desktop (double click on the file)
# You will find inside an uninstall software (to remove PlayOnMac your computer) and the software. You simply drag-and-drop it in your '' Applications ''

=== Using GIT Version ===

The git version can always have the updated program. It is only recommended for advanced users and programmers. It has the advantage of providing automatic update button, unlike other version of the program. To install it on your computer, you must install and configure git. Once this is done, you can download PlayOnMac using the following command:

git clone https://github.com/PlayOnLinux/POL-POM-4

{{Info|This command will download the program to your current folder. Consider making use of 'cd' before running the command to get to where you want the files to be downloaded to. }}Unlike packaged installation, this method won't install PlayOnMac system-wide

{{Info|On Mac, the easier way to use the development version is to first deploy a stable version of PlayOnMac, then to replace /Applications/PlayOnMac.app/Contents/Resources/playonlinux folder with a clone of the git repository.}}

=== Next? ===
Now that you have installed on your computer PlayOnMac, I suggest you to read our [[First Use| guide for first use of the software]] who will explain the basics to know to install and uninstall Windows programs with PlayOnMac.

First Use

2016-02-19T19:13:42Z

Stephenwb: /* The main window */

You have just installed the software but you're not sure how to use it? This section is here to guide you in your first installations and teach you how to use the basic functions.

== PlayOnLinux and PlayOnMac, what's the difference? ==
In this wiki, we discuss both PlayOnLinux and PlayOnMac interchangeably. But what are the differences between the two programs?

Apart from the fact that the first is for Linux and the other is for Mac, they are the same. The only major differences between the two programs are the layout and some options that are only available on one or the other. For reasons of convenience, you will only find PlayOnLinux images on this page. However, any differences will be highlighted to avoid losing users of PlayOnMac.

For now, the only difference you need to remember is the location of the menu bar. Aside from that, this guide is suitable for users of both PlayOnLinux and PlayOnMac.

=== On Linux ===
The menu bar is located at the top of the software window, as you can see in the picture below:

http://www.playonlinux.com/images/uploads/230.jpg

=== On Mac ===
The menu bar is in the top bar of the system, as you can see in the picture below:

http://www.playonlinux.com/images/uploads/228.jpg

== The main window ==

The first time you launch the program, this window will seem a little empty -- this is normal. In this example, only one program is installed. This window lists the applications installed in PlayOnLinux / PlayOnMac.

http://www.playonlinux.com/images/uploads/231.jpg

The window is divided into three parts:
* [[#The Toolbar | Toolbar]]
* [[#The Actions panel | Actions panel]]
* [[#The Application List | Application List]]

=== The toolbar ===

http://www.playonlinux.com/images/uploads/235.jpg

The toolbar displays the five shortcuts you will use most often:
# [[#The Run button | Run]]
# [[#The Close button | Close]]
# [[#The Button install | Install]]
# [[#The Delete button | Delete]]
# [[#The Configure button | Configure]]

==== The run button ====
Launch the application selected in the [[#The Application List | Application List]].

==== The close button ====
Normally, when you quit an application, it should close normally, but sometimes it freezes. In this case, select it from [[#The Application List | Application List]] and press the button '' '' Close '' ''. This will force [[Wine; what is it?|Wine]] and the application to close fully without damaging your system.

==== Install button ====
This button provides access to the list of applications that PlayOnLinux / PlayOnMac can install on your computer. We will discuss this in detail later.

==== The delete button ====
This button uninstalls an existing application. We will see that later.

==== The Configure button ====
This button opens the configuration window of [[Wine; what is it?|WINEPREFIX]]. For more information on this menu, you can read the documentation about [[The Configuration Window| Configuration Window]].

=== The actions panel ===

http://www.playonlinux.com/images/uploads/236.jpg

The action panel may seem very empty at the moment and this is normal. This is where you will find actions related applications installed. It offers at this time to install a program and access the settings of PlayOnLinux / PlayOnMac.

When you select an application from the list, there are different actions:

* "Run" will run the selected application

* "Close" will close the selected application

* "Debug", which helps debug issues in an application

* "Configure" opens the [[The Configuration Window|Configure Window]], and automatically selects the application that is highlighted

* "Creating a shortcut" creates a shortcut to an application on your desktop

* "Open the directory", which opens the folder containing the executable in [[Wine; what is it?| WINEPREFIX]]

* "Uninstall" uninstalls the software, and offers an option to delete the WINEPREFIX (otherwise known as a "virtual drive".)

=== The Application List ===

http://www.playonlinux.com/images/uploads/237.jpg

This list will include all applications installed with PlayOnLinux or PlayOnMac, which is also a list of shortcuts. From here you can easily launch, uninstall or configure these applications. It also offers a right-click menu -- here are the options:

* [[Wine Configuration | Configure WINE]]

* [[The wine registry | Registry Editor]]

* Open the application folder

* Read the manual, if available

* Change the icon to change the launcher (useful if the application does not have one and want him to apply PlayOnLinux / PlayOnMac)

* Delete; simply uninstall the program

* Close applications, like the close button explained above

These are the basics for the interface. For more information on some of its features or menus, feel free to browse the rest of the wiki.

== Install Application ==

Installing an application is as simple as searching for it and following the installation wizard. To install an application:

* Click "Install" on the main window

* Either search for your program in the search bar, or choose from a category along the top

http://www.playonlinux.com/images/uploads/232.jpg

* Once you have found the application you are wanting to install, highlight it in the list, and click "Install" in the bottom-right corner of the PlayOnLinux Install Menu window

http://www.playonlinux.com/images/uploads/233.jpg

* Simply follow the on-screen instructions that pop up. They will guide you through the rest of the installation

http://www.playonlinux.com/images/uploads/234.jpg

That is all! It is really just that easy.

{{Info|At the top of the install Window, you will note some checkboxes. The one that says "No-cd needed" are for games that requires cracks. We absolutely do not support piracy or cracks of any kind. They are just there for posterity and for special circumstances. If you have issues with any installer in that category that has to do with piracy, we cannot help you.}}

First Use

2016-02-19T18:59:57Z

Stephenwb: /* PlayOnLinux and PlayOnMac, what difference? */ Made the wording more natural

You have just installed the software but you're not sure how to use it? This section is here to guide you in your first installations and teach you how to use the basic functions.

== PlayOnLinux and PlayOnMac, what's the difference? ==
In this wiki, we discuss both PlayOnLinux and PlayOnMac interchangeably. But what are the differences between the two programs?

Apart from the fact that the first is for Linux and the other is for Mac, they are the same. The only major differences between the two programs are the layout and some options that are only available on one or the other. For reasons of convenience, you will only find PlayOnLinux images on this page. However, any differences will be highlighted to avoid losing users of PlayOnMac.

For now, the only difference you need to remember is the location of the menu bar. Aside from that, this guide is suitable for users of both PlayOnLinux and PlayOnMac.

=== On Linux ===
The menu bar is located at the top of the software window, as you can see in the picture below:

http://www.playonlinux.com/images/uploads/230.jpg

=== On Mac ===
The menu bar is in the top bar of the system, as you can see in the picture below:

http://www.playonlinux.com/images/uploads/228.jpg

== The main window ==

The first time you launch the program, this window can seem a little empty. This is normal. In this example, you can see that only one program is installed. It is in this window you will find the list of installed applications with PlayOnLinux / PlayOnMac.

http://www.playonlinux.com/images/uploads/231.jpg

Note that this window is divided into three parts:
* [[#The Toolbar | toolbar]]
* [[#The Actions panel | the actions panel]]
* [[#The Application list | list of applications]]

=== The toolbar ===

http://www.playonlinux.com/images/uploads/235.jpg

The toolbar includes the shortcuts that you will most often use. There are five:
# [[#The Run button | Run]]
# [[#The Close button | Close]]
# [[#The Button install | Install]]
# [[#The Delete button | Delete]]
# [[#The Configure button | Configure]]

==== The run button ====
It will launch the application you selected in the [[#The list of applications| list of applications]].

==== The close button ====
Normally, when you quit an application, it should close properly, but sometimes it freezes. In this case, simply select it from [[#The list of applications| list of applications]] and press the button '' '' Close '' ''. This will force [[Wine; what is it?|Wine]] and the application to close fully without damaging your system.

==== Install button ====
This button will be most useful. It provides access to the list of applications that PlayOnLinux / PlayOnMac can install on your computer. But we will see this in detail later.

==== The delete button ====
This button allows you to uninstall an actual application. We will see that later.

==== The Configure button ====
Finally, this button opens the configuration window of [[Wine; what is it?|WINEPREFIX]]. For more information on this menu, you can read our documentation about [[The Configuration Window| Configuration Window]].

=== The actions panel ===

http://www.playonlinux.com/images/uploads/236.jpg

The action panel may seem very empty at the moment and this is normal. This is where you will find actions related applications installed. It offers at this time to install a program and access the settings of PlayOnLinux / PlayOnMac.

When you select an application from the list, there are different actions:

* "Run" will run the selected application

* "Close" will close the selected application

* "Debug", which helps debug issues in an application

* "Configure" opens the [[The Configuration Window|Configure Window]], but automatically selects the application that is highlighted

* "Creating a shortcut", which, as its name suggests, creates a shortcut on your desktop

* "Open the directory", which opens the folder containing the executable in the [[Wine; what is it?| WINEPREFIX]]

* "Uninstall" uinstalls the software, and offers an option to delete the WINEPREFIX (otherwise known as a "virtual drive".)

=== The list of applications ===

http://www.playonlinux.com/images/uploads/237.jpg

This list will include all applications installed with PlayOnLinux or PlayOnMac, which is also a list of shortcuts. From here you can easily launch, uninstall or configure these applications. It also offers a menu to the right click -- here are the options:

* [[Wine Configuration | Configure wine]]

* [[The wine registry | registry editor]]

* Open the application folder

* Read the manual, if available

* Change the icon to change the launcher (useful if the application does not have one and want him to apply PlayOnLinux / PlayOnMac)

* Delete; simply uninstall the program

* Close applications, like the close button explained above

These are the basics for the interface. For more information on some of its features or menus, feel free to browse the rest of the wiki.

== Install Application ==

Installing an application is as simple as searching for it and following the installation wizard. To install an application:

* Click "Install" on the main window

* Either search for your program in the search bar, or choose from a category along the top

http://www.playonlinux.com/images/uploads/232.jpg

* Once you have found the application you are wanting to install, highlight it in the list, and click "Install" in the bottom-right corner of the PlayOnLinux Install Menu window

http://www.playonlinux.com/images/uploads/233.jpg

* Simply follow the on-screen instructions that pop up. They will guide you through the rest of the installation

http://www.playonlinux.com/images/uploads/234.jpg

That is all! It is really just that easy.

{{Info|At the top of the install Window, you will note some checkboxes. The one that says "No-cd needed" are for games that requires cracks. We absolutely do not support piracy or cracks of any kind. They are just there for posterity and for special circumstances. If you have issues with any installer in that category that has to do with piracy, we cannot help you.}}