Library for parsing and creating Windows shortcut files (.lnk)
Partial implementation of Shell Link (.LNK) Binary File Format
This library allows you create new and read and modify existing .lnk files. It can edit most properties of the link such as working directory, tooltip text, icon, command line arguments, hotkeys, create links to LAN shared files and directories but following features are not implemented:
- extra data blocks: Darwin, IconEnvironment, KnownFolder, PropertyStore, Shim, SpecialFolder
- some options in LinkTargetIDList because this section is not documented
- environment variables: you can use it in target path but it resolves while creating link and not stored in the lnk file (the reason is previous item)
Easiest way to create link with default parameters: ShellLink.createLink("targetfile", "linkfile.lnk")
Following example demonstrates creating link for .bat file and setting working directory, icon and setting up font parameters for console
package mslinks;
import java.io.IOException;
public class Main {
public static void main(String[] args) throws IOException {
ShellLink sl = ShellLink.createLink("pause.bat")
.setWorkingDir("..")
.setIconLocation("%SystemRoot%\\system32\\SHELL32.dll");
sl.getHeader().setIconIndex(128);
sl.getConsoleData()
.setFont(mslinks.extra.ConsoleData.Font.Consolas)
.setFontSize(24)
.setTextColor(5);
sl.saveTo("testlink.lnk");
System.out.println(sl.getWorkingDir());
System.out.println(sl.resolveTarget());
}
}
Final example creates cyclic link that blocks explorer on Windows 7 while trying to get into the containing directory
package mslinks;
import java.io.IOException;
public class Main {
public static void main(String[] args) throws IOException {
ShellLink sl = ShellLink.createLink("test.lnk");
sl.getHeader().getLinkFlags().setAllowLinkToLink();
sl.saveTo("test.lnk");
}
}
Following uses the methods createLinkToFile and createLinkToDirectory, allowing shortcuts to be created on a Linux server to be downloaded and used on a Windows machine.
package mslinks;
import java.io.IOException;
public class Main {
public static void main(String[] args) throws IOException {
ShellLink sl = ShellLink.createLinkToFile("C:\\Program Files (x86)\\Mozilla Firefox\\firefox.exe")
.setCMDArgs("-devtools")
.setWorkingDir("C:\\Program Files (x86)\\Mozilla Firefox");
sl.saveTo("testlink.lnk");
System.out.println(sl.getWorkingDir());
System.out.println(sl.resolveTarget());
}
}