ImageGlass.Tools 1.9070.0

dotnet add package ImageGlass.Tools --version 1.9070.0
NuGet\Install-Package ImageGlass.Tools -Version 1.9070.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="ImageGlass.Tools" Version="1.9070.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add ImageGlass.Tools --version 1.9070.0
#r "nuget: ImageGlass.Tools, 1.9070.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install ImageGlass.Tools as a Cake Addin
#addin nuget:?package=ImageGlass.Tools&version=1.9070.0

// Install ImageGlass.Tools as a Cake Tool
#tool nuget:?package=ImageGlass.Tools&version=1.9070.0

ImageGlass.Tools - Build tools for ImageGlass

ImageGlass.Tools is a set of APIs to integrate third-party software with ImageGlass. With ImageGlass.Tools, developers can extend the functionality of ImageGlass by integrating their own software solutions, making it a highly customizable and versatile tool for all image viewing needs.

You can download tools for ImageGlass 9 at: https://imageglass.org/tools

ImageGlass.Tools

Getting started

Here are the simple steps to use APIS from ImageGlass.Tools. You can check out the DemoApp project for complete sample.

  1. To get started, you need to download or clone this repo.
  2. Create a new project in Visual Studio.
  3. Add ImageGlass.Tools.csproj as a reference project into your software.
  4. Create a new instance of ImageGlassTool:
private readonly ImageGlassTool _igTool = new ImageGlassTool();
  1. Add event listeners to ImageGlass:
_igTool.ToolMessageReceived += IgTool_ToolMessageReceived;
_igTool.ToolClosingRequest += IgTool_ToolClosingRequest;
  1. Handle event from ImageGlass:
private void IgTool_ToolMessageReceived(object? sender, MessageReceivedEventArgs e)
{
  if (string.IsNullOrEmpty(e.MessageData)) return;

  if (e.MessageName == ImageGlassEvents.IMAGE_LOADED)
  {
    Trace.WriteLine("Image is loaded");
    Trace.WriteLine(e.MessageData);
  }
}
  1. Start connecting to ImageGlass:
await _igTool.ConnectAsync();

Add an external tool to ImageGlass 9

Use ImageGlass Settings

  1. Open ImageGlass Settings, click on tab "Tools"
  2. Click "Add..." button to add a new tool
  3. Fill in all the fields accordingly
    • In Argument text box, fill <file> so that ImageGlass will send the full path of the current viewing image file to the tool
    • Check the option Integrated with ImageGlass.Tools if the tool has implementation of ImageGlass.Tools
    • Check command preview to make sure your inputs are correct
  4. Click "OK" button to close the dialog, click "OK" or "Apply" button to apply the changes <img width="600" src="https://user-images.githubusercontent.com/3154213/273207911-a90270fb-02fb-4b90-aee4-bd58109365bf.png" />

Use igconfig.json

  1. Open igconfig.json file with a text editor such as NotePad or VS Code.
  2. Ensure that ImageGlass app is not running.
  3. In the Tools section of the igconfig.json file, add the following code:
// in igconfig.json
"Tools": [
  {
    "ToolId": "Tool_MyDemoApp", // a unique ID
    "ToolName": "My Demo app", // name of the tool
    "Executable": "path\\to\\the\\DemoApp.exe",
    "Argument": "<file>", // file path to pass to the tool
    "Hotkeys": ["X", "Ctrl+E"], // press X or Ctrl+E to open/close the tool
    "IsIntegrated": true|false // true: if the tool supports 'ImageGlass.Tools'
  }
]
  1. Save the file, and you're done!
Product Compatible and additional computed target framework versions.
.NET net6.0-windows7.0 is compatible.  net7.0-windows was computed.  net7.0-windows7.0 is compatible.  net8.0-windows was computed.  net8.0-windows7.0 is compatible. 
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.
  • net6.0-windows7.0

    • No dependencies.
  • net7.0-windows7.0

    • No dependencies.
  • net8.0-windows7.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on ImageGlass.Tools:

Repository Stars
d2phap/ImageGlass
🏞 A lightweight, versatile image viewer
Version Downloads Last updated
1.9070.0 413 11/16/2023
1.9060.0 100 10/6/2023
1.9050.0 164 7/25/2023
1.9040.0 190 4/23/2023