blob: b4b47850e808d29b424384a8ced9cf875f5084ea [file] [log] [blame] [edit]
.TH win7appid 1
.SH NAME
win7appid - Windows 7 (and up) shortcut application id tool
.SH SYNOPSIS
.B win7appid \fIshortcut\fP [\fInew_app_id\fP]
.SH DESCRIPTION
.P
This is a fairly basic console application for setting the application id (System.AppUserModel.ID property) of a Windows 7 shortcut.
.P
In Windows 7, taskbar items are grouped by a string known as the application id or AppId. This can be set in the shortcut that launches a program, or by the application itself. For more information, see:
.P
.nf
.RS
https://msdn.microsoft.com/en-us/library/dd378459%28VS.85%29.aspx
.RE
.fi
.P
This tool allows you to pin an application and then have another application's windows group under the same icon without modifying the applications themselves. It only works if you can launch both apps via a shortcut, child processes will have the default behaviour of having their own taskbar entry.
.P
If the \fInew_app_id\fP is omitted, it simply prints the current app id.
.SH EXAMPLE
.P
I made the tool so I could pin a shortcut to start a Putty session with X forwarding, start gnome-terminal and have it's X window (running under Xming) group under the pinned icon.
.P
I issued the commands:
.P
.nf
.RS
Win7AppId xming.lnk putty-xming
Win7AppId puttysession.lnk putty-xming
.RE
.fi
.P
And then put the xming shortcut in my Startup folder and pinned puttysession to the taskbar.
.SH AUTHOR
.nf
David Roe (didroe)
https://code.google.com/p/win7appid/
.fi