com.erigir.mslinks

MSLinks - library for creating native Windows links

License

License

GroupId

GroupId

com.erigir
ArtifactId

ArtifactId

mslinks
Last Version

Last Version

0.0.2+5
Release Date

Release Date

Type

Type

jar
Description

Description

com.erigir.mslinks
MSLinks - library for creating native Windows links
Project URL

Project URL

https://github.com/BlackOverlord666/mslinks
Project Organization

Project Organization

BlackOverlord666
Source Code Management

Source Code Management

https://github.com/BlackOverlord666/mslinks

Download mslinks

How to add to project

<!-- https://jarcasting.com/artifacts/com.erigir/mslinks/ -->
<dependency>
    <groupId>com.erigir</groupId>
    <artifactId>mslinks</artifactId>
    <version>0.0.2+5</version>
</dependency>
// https://jarcasting.com/artifacts/com.erigir/mslinks/
implementation 'com.erigir:mslinks:0.0.2+5'
// https://jarcasting.com/artifacts/com.erigir/mslinks/
implementation ("com.erigir:mslinks:0.0.2+5")
'com.erigir:mslinks:jar:0.0.2+5'
<dependency org="com.erigir" name="mslinks" rev="0.0.2+5">
  <artifact name="mslinks" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.erigir', module='mslinks', version='0.0.2+5')
)
libraryDependencies += "com.erigir" % "mslinks" % "0.0.2+5"
[com.erigir/mslinks "0.0.2+5"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

mslinks

Summary

Library for parsing and creating Windows shortcut files (.lnk)

Description

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)

Examples

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");
	}
}

Download

Versions

Version
0.0.2+5