VMware ESXi and vSphere Cluster Management
Using Unity Mode in VMware Workstation Player
Learn how Unity Mode integrates guest application windows with the host desktop, its requirements, file-access limits, setup workflow, and troubleshooting steps.
What Unity Mode does
Unity Mode is a VMware Workstation Player display and desktop-integration mode for a powered-on virtual machine (VM). It presents application windows from the guest operating system directly on the host desktop, instead of keeping them inside the normal virtual machine console.
The host operating system is the operating system installed on the physical computer and running VMware Workstation Player. The guest operating system is the operating system installed inside the VM. Unity Mode changes how guest applications are displayed and accessed; it does not remove the guest operating system or convert guest software into host software.
For example, a Windows application running in a Windows guest can appear beside applications running natively on the host. The application still executes in the guest and still uses guest files, settings, user accounts, and permissions.
How the desktop changes
In the normal view, the virtual machine console is a VMware window containing the guest desktop. When Unity Mode is active, that standard console view is hidden while integrated guest application windows are shown on the host desktop.
- Guest application windows can visually coexist with native host windows.
- Open guest applications can appear on the host taskbar, similarly to host applications.
- The guest Start menu or Linux guest application menu can be exposed for launching additional guest applications.
- The guest desktop remains present in the VM even though the full desktop is not shown in the usual console window.
The host taskbar is only representing an open integrated window. Its entry does not mean that the application has been installed on the host or is executing natively there.
Requirements for Unity Mode
The VM must be running before Unity Mode can be used. The VM hardware and configuration generation must also be compatible with VMware Player 3.x or later. In addition, VMware Tools must be installed and functioning in the guest.
Supported guest families include Windows 2000 or later and supported Linux guests. Linux support also depends on the desktop and window-management environment. On applicable Linux host and guest systems, a sufficiently recent compatible Metacity or KDE environment is required. Metacity is a Linux window manager; KDE is a Linux desktop and window-management ecosystem.
| Requirement | Required state | Why it matters |
|---|---|---|
| Virtual machine power state | The VM is powered on. | Unity Mode integrates windows from a running guest. |
| VM compatibility generation | The VM is compatible with VMware Player 3.x or later. | Older or incompatible VM configurations may not provide the feature. |
| VMware Tools | Installed and operating in the guest. | Tools supplies guest integration needed for enhanced desktop interaction and Unity Mode. |
| Windows guest | Windows 2000 or later, where supported. | The guest must belong to a supported Windows family. |
| Linux guest | A supported Linux guest and desktop environment. | Unity behavior depends on guest desktop integration. |
| Linux Metacity or KDE support | A sufficiently recent compatible environment on applicable Linux host and guest systems. | The window manager must cooperate with VMware's integration features. |
Host and guest responsibilities
Unity Mode depends on cooperation between four parts: VMware Workstation Player, VMware Tools, the guest desktop environment, and the host desktop. Player controls the display mode, VMware Tools provides guest-side integration, the guest desktop manages guest windows, and the host desktop displays the integrated windows.
This division explains why an integrated window can look like a host application while still behaving like a guest application. The guest owns the application process, its menus, its installed components, its user profile, and its permissions. The host supplies the surrounding desktop surface and window-management experience.
| Area | Unity Mode behavior | Normal virtual machine console behavior |
|---|---|---|
| Application window placement | Guest windows appear directly among host desktop windows. | Guest windows appear inside the VM console or guest desktop. |
| Guest desktop console | The standard console is hidden while Unity Mode is active. | The VMware console displays the guest desktop as a contained screen. |
| Taskbar representation | Guest applications can have entries on the host taskbar. | The host generally represents the VMware console as the active application window. |
| Guest application menus | The guest Start menu or application menu can be accessed from the host desktop environment. | The menu is accessed inside the guest desktop shown in the console. |
| File dialog file-system view | Open and Save dialogs browse guest locations. | Open and Save dialogs also browse the guest file system inside the console. |
Enabling Unity Mode
Unity Mode is a VMware display and integration feature, not a setting in Windows or Linux. Use this general workflow:
- Power on the virtual machine.
- Verify that the VM is compatible with VMware Player 3.x or later.
- Confirm that VMware Tools is installed and operating in the guest.
- Confirm that the guest is a supported Windows or Linux system.
- For applicable Linux configurations, verify a compatible recent Metacity or KDE desktop and window-management environment.
- Wait for the guest desktop to finish starting.
- Use the Unity Mode control in VMware Workstation Player to switch from the console display to integrated application display.
After activation, launch or select guest applications through the exposed guest application menu, the host taskbar, or existing integrated windows. The exact control label and placement can vary with the Player version and host desktop.
Leaving Unity Mode
Use the VMware Workstation Player control for leaving Unity Mode. The normal virtual machine console view should become visible again, allowing the guest desktop to be used as a contained virtual-machine screen.
Leaving Unity Mode does not shut down the VM or close the guest operating system. It only changes the way the running guest is displayed.
File access in Unity Mode
A file dialog belongs to the application that opened it. Because a Unity-displayed application is still running in the guest, its Open and Save dialogs browse the guest file system.
Unity Mode does not make host folders directly available in a guest application's file picker. A guest application might show the guest user's home directory, profile folders, guest drives, or other locations permitted by the guest operating system. It will not automatically show the host's folders merely because its window is visible on the host desktop.
| Action | System primarily involved | Expected result |
|---|---|---|
| Open a file from a Unity-displayed guest application | Guest file system and guest permissions | The dialog browses guest folders and opens a file available to the guest. |
| Save a file from a Unity-displayed guest application | Guest file system and guest permissions | The file is saved to a guest-side path unless another supported transfer or sharing method is used. |
| Copy and paste a file between host and guest | Host and guest clipboard integration | A supported file transfer can move the file between systems; this does not add host folders to the guest file picker. |
Consequently, a document opened or saved from an integrated guest application remains subject to guest-side storage paths, account permissions, and available disk space.
Moving files between host and guest
When supported and enabled, clipboard integration allows users to copy and paste content, including file-transfer scenarios, between the host and guest. VMware Tools is central to this integration.
Clipboard-based transfer and direct file-system visibility are different capabilities:
- Copy and paste can transfer a file between systems through the integration layer.
- A guest application's file chooser still normally displays guest paths.
- Seeing a file in a guest dialog requires the file to exist in a guest-accessible location, such as a destination where it was transferred.
For example, copy a file on the host and paste it into a supported guest destination. Then use the guest application's Open dialog to browse to that guest destination. Do not expect the host drive or host folders to appear automatically in the dialog.
Unity Mode compared with native host applications
An application displayed in Unity Mode remains a guest application. Its menus come from the guest version of the software, its installed plug-ins and fonts come from the guest, and its settings normally come from the guest user profile.
- Execution: the guest runs the application.
- Storage: the guest controls the application's normal files and paths.
- Permissions: the guest account and guest security rules apply.
- Appearance: VMware integrates the window with the host desktop.
- Taskbar entry: the host can represent the integrated window without owning the application.
Troubleshooting Unity Mode
The Unity Mode option is unavailable
Common causes include a powered-off VM, missing or inactive VMware Tools, an incompatible VM configuration, an unsupported guest operating system, or an unmet Linux desktop and window-manager requirement.
- Start the VM and wait for the guest desktop to become ready.
- Verify VMware Tools installation and operation inside the guest.
- Review the VM's hardware compatibility settings.
- Confirm the guest Windows version or Linux distribution is supported.
- On Linux, identify the desktop and window manager and confirm that the applicable Metacity or KDE requirement is met.
A guest Open or Save dialog cannot find host files
This is expected when the application is running in the guest. The dialog is browsing the guest file system, not the host file system.
- Choose or create a destination within the guest file system.
- Use supported host-to-guest copy and paste to transfer the required file.
- Do not interpret the integrated window as evidence that host folders are directly mounted in the guest.
The application appears to be a host application
Unity Mode integrates the window visually but does not convert the application into native host software. Check which operating system owns the application, user profile, storage location, and permissions.
Unity Mode behaves incorrectly with Linux
Check whether VMware Tools is installed and active, then identify the Linux desktop and window manager on the relevant host and guest systems. An absent, outdated, or incompatible Metacity or KDE environment can prevent expected integration behavior.
Quick reference
Unity Mode requires a running, compatible VM, VMware Tools, and a supported Windows or Linux guest. It hides the usual console view and places guest application windows on the host desktop. Guest applications can appear on the host taskbar and can be launched through the guest application menu. However, their menus, files, paths, and permissions remain guest-side. Supported clipboard integration can transfer files, but it does not make host folders directly visible in guest Open or Save dialogs.
For related study, see Unity Mode in VMware Workstation Player.