You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: hub/powertoys/workspaces.md
+27-25Lines changed: 27 additions & 25 deletions
Original file line number
Diff line number
Diff line change
@@ -1,14 +1,14 @@
1
1
---
2
2
title: PowerToys Workspaces utility for Windows
3
3
description: The PowerToys Workspaces utility is a desktop manager that can efficiently launch a set of applications to custom positions and configurations.
4
-
ms.date: 09/03/2024
4
+
ms.date: 12/05/2024
5
5
ms.topic: article
6
6
no-loc: [PowerToys, Windows, Win]
7
7
---
8
8
9
9
# Workspaces utility
10
10
11
-
PowerToys Workspaces is a desktop manager utility for launching a set of applications to custom positions and configurations with one-click, getting you into your ideal desktop state for any project or activity faster. You can capture your desktop state as a new workspace using the editor, add arguments to apps to configure their state on launch, and pin the workspace as a desktop shortcut for quick-launching. Launching the workspace will launch all apps to their assigned positions.
11
+
PowerToys Workspaces is a desktop manager utility for launching a set of applications to custom positions and configurations with a single click. This gets you into your ideal desktop state for any project or activity faster. You can capture your desktop state as a new workspace using the editor, add arguments to apps to configure their state on launch, and pin the workspace as a desktop shortcut for quick-launching. Launching the workspace will launch all apps to their assigned positions.
12
12
13
13
## Enabling
14
14
@@ -20,11 +20,11 @@ Open the editor using by selecting "Launch editor" from PowerToys Workspaces set
Click "+ Create workspace" to invoke the Capture experience - in this view, the desktop is fully functional and you are able to open, close, and reposition apps to get your apps into the desired layout. Once you have arranged the apps how you would like, select "Capture".
23
+
Click "+ Create workspace" to invoke the Capture experience - in this view, the desktop is fully functional and you are able to open, close, and reposition apps to get your apps into the desired layout. Once you have arranged the apps how you would like, select "Capture".
After capturing, you will enter the editor where you can name the workspace, adjust window sizes, add CLI arguments, remove apps, and create a desktop shortcut before finally saving the workspace.
27
+
After capturing, you will enter the editor where you can name the workspace, adjust window sizes, add command line interface (CLI) arguments, remove apps, and create a desktop shortcut before finally saving the workspace.
28
28
29
29
30
30
@@ -34,65 +34,68 @@ Launch a workspace by either selecting "Launch" from the list of workspaces in t
While the workspace launches, PowerToys will display a dialogue box presenting the status of each app. Each app will have one of the following statuses:
37
+
While the workspace launches, PowerToys will display a dialog box presenting the status of each app. Each app will have one of the following statuses:
38
38
39
39
| Symbol | Status |
40
40
|-------------|-----------|
41
41
|| The app has successfully launched and repositioned. |
42
42
|| The app is in the process of launching and moving to the correct position. |
43
43
|| The app has failed to launch. |
44
44
45
-
The dialogue box will dismiss itself once all apps have properly launched and been arranged in their desired positions. You can also dismiss the dialogue yourself at anytime, or use it to cancel the launch.
45
+
The dialog box will dismiss itself once all apps have properly launched and been arranged in their desired positions. You can also dismiss the dialog yourself at any time, or use it to cancel the launch.
46
46
47
47
## Editing a workspace
48
48
49
-
Start by launching the editor and selecting the workspace you would like to edit. Once in the edit view for that layout, you can remove apps, modify the window positions manually via each app's dropdown menu, or select "Launch & Edit" to launch the layout and re-enter the same Capture experience as when it was first created.
49
+
Start by launching the editor and selecting the workspace you would like to edit. Once in the edit view for that layout, you can remove apps, modify the window positions manually via each app's dropdown menu, or select "Launch & Edit" to launch the layout and re-enter the same Capture experience as when it was first created.
50
50
51
-
> [!NOTE]
51
+
> [!NOTE]
52
52
> Capturing the adjusted workspace will perform a clean re-capture, and all previous CLI arguments and settings will be removed. The re-capture can be reverted to return to the original workspace if necessary.
53
53
54
-
## Adding command line (CLI) arguments to applications
54
+
## Adding CLI arguments to applications
55
55
56
-
To launch apps in a desired state, CLI arguments can be added to each app in their respective dropdown menus. These arguments are specific to the app itself and are called alongside the app when launched. In the below example, VS Code is launched to the file provided at the path and Terminal is launched to the "Ubuntu" profile.
56
+
To launch apps in a desired state, CLI arguments can be added to each app in their respective dropdown menus. These arguments are specific to the app itself and are called alongside the app when launched. In the below example, Visual Studio Code (VS Code) is launched to the file provided at the path and Terminal is launched to the "Ubuntu" profile.
57
57
58
58
59
59
60
60
You can find more information on VS Code and Terminal CLI arguments can be found below:
> Each app will have its own set of command line arguments that can be used to modify the launch behaviour, but many apps use similar patterns. For example, try passing a comma-separated list of URLs to Edge and other browsers to launch the browser with those tabs open, or pass a filepath to an Office application, text editor or IDE to launch directly to that file.
66
+
> Each app will have its own set of command line arguments that can be used to modify the launch behavior, but many apps use similar patterns. For example, try passing a comma-separated list of URLs to Edge and other browsers to launch the browser with those tabs open, or pass a filepath to an Office application, text editor or IDE to launch directly to that file.
66
67
67
-
## Launching apps as admin
68
+
## Launching apps as admin
68
69
69
-
To launch apps as admin, select the "Launch as Admin" box in the respective app's dropdown menu. On launch, a UAC dialogue will be shown for each app that has been set to launch as admin.
70
+
To launch apps as admin, select the "Launch as Admin" box in the respective app's dropdown menu. On launch, a User Account Control (UAC) dialog will be shown for each app that has been set to launch as admin.
70
71
71
-
> [!IMPORTANT]
72
+
> [!IMPORTANT]
72
73
> There is a known issue where apps that launch as admin are unable to be repositioned to the desired layout. The team is actively working on a fix for an upcoming release.
73
74
74
75
## Opening new windows vs. repositioning existing windows
75
76
76
-
Different apps may behave differently on launch if there is already an existing instance of the application open on the desktop - some apps will reposition the existing instance, whereas others may launch a new instance by default. For tailoring to user preference, the recommendation is to handle launch behaviour via available CLI arguments.
77
+
Different apps may behave differently on launch if there is already an existing instance of the application open on the desktop - some apps will reposition the existing instance, whereas others may launch a new instance by default. If the "Move existing windows" option is enabled for the workspace, any existing apps are moved to the desired position in the workspace and the remaining apps are launched as usual. For tailoring to user preference, the recommendation is to handle launch behavior via available CLI arguments.
77
78
78
-
For example, VS Code will launch a new window by default, but should a user prefer to move the existing window, the `--reuse-window` CLI argument can be added to VS Code's CLI arguments.
79
+
For example, VS Code will launch a new window by default, but should a user prefer to move the existing window, the `--reuse-window` CLI argument can be added to VS Code's CLI arguments.
79
80
80
-
> [!NOTE]
81
-
> Some apps are "single-instance" applications, meaning that there may only be one active instance of the app open at a time. One example of this is the Windows Settings app. These apps, if already active, will be repositioned by default, and new instances cannot be launched.
81
+
> [!NOTE]
82
+
> Some apps are "single-instance" applications, meaning that there may only be one active instance of the app open at a time. One example of this is the Windows Settings app. These apps, if already active, will be repositioned by default, and new instances cannot be launched.
82
83
83
84
## Frequently Asked Questions
84
85
85
-
**Why do app windows launch and then jump to the positions I saved them in?**
86
+
The following are some common questions and answers about PowerToys Workspaces:
87
+
88
+
-**Why do app windows launch and then jump to the positions I saved them in?**
86
89
87
-
PowerToys cannot tell an app to launch to a specific position. What we can do is launch an app first, and then give an instruction to move and resize it to a certain position. However, this results in the user visibly seeing the process on-screen. To help with this, we added the dialogue box during launch to display the launch status of each app.
90
+
PowerToys cannot tell an app to launch to a specific position. What we can do is launch an app first, and then give an instruction to move and resize it to a certain position. However, this results in the user visibly seeing the process on-screen. To help with this limitation, we added the dialog box during launch, which displays the launch status of each app.
88
91
89
-
**My windows were snapped when I saved my workspace, but when I launch the workspace from a clean state they are not snapped. Why is this?**
92
+
-**My windows were snapped when I saved my workspace, but when I launch the workspace from a clean state they are not snapped. Why is this?**
90
93
91
-
PowerToys uses publicly available APIs and the [FancyZones](fancyzones.md) engine under the hood for positioning apps. Unfortunately, this does not include snapping capabilities.
94
+
PowerToys uses publicly available APIs and the [FancyZones](fancyzones.md) engine under the hood for positioning apps. Unfortunately, this does not include snapping capabilities.
92
95
93
-
**How can I pin to taskbar?**
96
+
-**How can I pin a workspace to the taskbar?**
94
97
95
-
You can create a desktop shortcut for your workspace first, and then pin it to the taskbar. Pinning a workspace to the taskbar directly is not currently supported.
98
+
You can create a desktop shortcut for your workspace first, and then pin it to the taskbar. Pinning a workspace to the taskbar directly is not currently supported.
96
99
97
100
## Settings
98
101
@@ -101,4 +104,3 @@ You can create a desktop shortcut for your workspace first, and then pin it to t
101
104
| Activation shortcut | To change the default hotkey, click on the control and enter the desired key combination. |
0 commit comments