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: README.md
+13-5
Original file line number
Diff line number
Diff line change
@@ -1,15 +1,17 @@
1
1
# VirtualDesktop
2
2
C# command line tool to manage virtual desktops in Windows 10 and Windows 11
3
3
4
-
**Pre-compiled binaries in Releases now**
4
+
**Pre-compiled binaries in Releases**
5
5
6
-
**Version 1.19, 2024-09-01**
7
-
- faster API call FindWindow instead of EnumWindows
8
-
- Windows 11: animated switch to new desktop
6
+
**Version 1.20, 2025-01-18**
7
+
- new parameters /PinActiveWindow and /UnPinActiveWindow
8
+
- Windows 11: new parameter /Amimation to enable or disable animated desktop switches
9
+
- nicer icon :-)
10
+
- window handles can be negative
9
11
10
12
(look for a powershell version here: https://github.com/MScholtes/PSVirtualDesktop or here: https://www.powershellgallery.com/packages/VirtualDesktop)
11
13
12
-
**With Windows 11 23H2 Release 3085 Microsoft did change the API (COM GUIDs) for accessing the functions for virtual desktops again. I provide five versions of virtualdesktop.cs now: virtualdesktop.cs is for Windows 10, virtualdesktop11.cs is for Windows 11, virtualdesktop11-24h2.cs for Windows 11 24H2 Insider, virtualdesktopserver2022.cs is for Windows Server 2022, virtualdesktopserver2016.cs is for Windows Server 2016. Using Compile.bat all executables will be generated.**
14
+
**With Windows 11 23H2 Release 3085 Microsoft did change the API (COM GUIDs) for accessing the functions for virtual desktops again. I provide five versions of virtualdesktop.cs now: virtualdesktop.cs is for Windows 10, virtualdesktop11.cs is for Windows 11, virtualdesktop11-24h2.cs for Windows 11 24H2, virtualdesktopserver2022.cs is for Windows Server 2022, virtualdesktopserver2016.cs is for Windows Server 2016. Using Compile.bat all executables will be generated.**
13
15
14
16
## Generate:
15
17
Compile with Compile.bat (no visual studio needed, but obviously Windows 10 or 11)
@@ -26,6 +28,8 @@ Virtual desktop numbers start with 0.
26
28
27
29
**/Break /Continue** break (default) or continue on error (short: /b and /co).
28
30
31
+
**/Animation:<s>** Enable switch animations (default) with 'On' or '1' and disable switch animations with 'Off' or '0' (short: /anim)(only VirtualDesktop11.exe).
32
+
29
33
**/List** list all virtual desktops (short: /li).
30
34
31
35
**/Count** get count of virtual desktops to pipeline (short: /c).
@@ -84,10 +88,14 @@ Virtual desktop numbers start with 0.
84
88
85
89
**/PinWindow:<s|n>** pin process with name <s> or id <n> to all desktops (short: /pw).
86
90
91
+
**/PinActiveWindow** pin active window to all desktops (short: /paw).
92
+
87
93
**/PinWindowHandle:<s|n>** pin window with text <s> in title or handle <n> to all desktops (short: /pwh).
88
94
89
95
**/UnPinWindow:<s|n>** unpin process with name <s> or id <n> from all desktops (short: /upw).
90
96
97
+
**/UnPinActiveWindow** unpin active window from all desktops (short: /upaw).
98
+
91
99
**/UnPinWindowHandle:<s|n>** unpin window with text <s> in title or handle <n> from all desktops (short: /upwh).
92
100
93
101
**/IsWindowPinned:<s|n>** check if process with name <s> or id <n> is pinned to all desktops (short: /iwp). Returns 0 for yes, 1 for no.
With Windows 11 23H2 Release 3085 Microsoft did change the API (COM GUIDs) for
19
21
accessing the functions for virtual desktops again. I provide five versions of
20
22
virtualdesktop.cs now: virtualdesktop.cs is for Windows 10, virtualdesktop11.cs
21
-
is for Windows 11, virtualdesktop11-24h2.cs for Windows 11 24H2 Insider,
23
+
is for Windows 11, virtualdesktop11-24h2.cs for Windows 11 24H2,
22
24
virtualdesktopserver2022.cs is for Windows Server 2022,
23
25
virtualdesktopserver2016.cs is for Windows Server 2016. Using Compile.bat all
24
26
executables will be generated.
@@ -38,6 +40,7 @@ Parameters (leading / can be omitted or - can be used instead):
38
40
/Help /h /? this help screen.
39
41
/Verbose /Quiet enable verbose (default) or quiet mode (short: /v and /q).
40
42
/Break /Continue break (default) or continue on error (short: /b and /co).
43
+
/Animation:<s> Enable switch animations (default) with 'On' or '1' and disable switch animations with 'Off' or '0' (short: /anim)(only VirtualDesktop11.exe).
41
44
/List list all virtual desktops (short: /li).
42
45
/Count get count of virtual desktops to pipeline (short: /c).
43
46
/GetDesktop:<n|s> get number of virtual desktop <n> or desktop with text <s> in name to pipeline (short: /gd).
@@ -67,8 +70,10 @@ Parameters (leading / can be omitted or - can be used instead):
67
70
/ListWindowsOnDesktop[:<n|s>] list handles of windows on desktop number <n>, desktop with text <s> in name or desktop with number in pipeline (short: /lwod).
68
71
/CloseWindowsOnDesktop[:<n|s>] close windows on desktop number <n>, desktop with text <s> in name or desktop with number in pipeline (short: /cwod).
69
72
/PinWindow:<s|n> pin process with name <s> or id <n> to all desktops (short: /pw).
73
+
/PinActiveWindow pin active window to all desktops (short: /paw).
70
74
/PinWindowHandle:<s|n> pin window with text <s> in title or handle <n> to all desktops (short: /pwh).
71
75
/UnPinWindow:<s|n> unpin process with name <s> or id <n> from all desktops (short: /upw).
76
+
/UnPinActiveWindow unpin active window from all desktops (short: /upaw).
72
77
/UnPinWindowHandle:<s|n> unpin window with text <s> in title or handle <n> from all desktops (short: /upwh).
73
78
/IsWindowPinned:<s|n> check if process with name <s> or id <n> is pinned to all desktops (short: /iwp). Returns 0 for yes, 1 for no.
74
79
/IsWindowHandlePinned:<s|n> check if window with text <s> in title or handle <n> is pinned to all desktops (short: /iwhp). Returns 0 for yes, 1 for no.
0 commit comments