Greenshot Discord Plugin

Send screenshots directly from Greenshot to Discord with one destination click.

Features

• Destination Integration: Adds a Send to Discord destination in the Greenshot destination list.
• Auto Paste + Optional Send: Copies the capture to clipboard, focuses Discord, pastes, and optionally sends with Enter.
• Focus Restore: Returns focus back to the previously active window after sending.
• State Restore: Returns Discord to its previous window state (minimized/normal/maximized) after sending.
• Tray/Minimized Support: Works when Discord is running but minimized or tray-hidden.
• Client Variant Support: Detects Discord Stable, PTB, and Canary process variants.
• Safe Fallback: If Discord is not running, no app is launched and Greenshot returns to destination selection.
• Mid-Send Exit Handling: Detects if Discord closes during automation and fails safely.
• Clipboard Safe: Preserves and restores previous clipboard contents after sending.
• Zero Configuration: No webhooks, bot tokens, or API keys.

Compatibility

Built for Greenshot 1.3.x+ plugin architecture. Not compatible with Greenshot 1.2.x.

Installation

1. Navigate to the Releases page of this repository.
2. Download the latest GreenshotDiscordPlugin-vX.Y.Z.zip file.
3. Extract the contents of the ZIP file.
4. Copy the extracted Discord folder into:
   • %AppData%\Local\Programs\Greenshot\Plugins
5. Ensure this file exists after copy:
   • %AppData%\Local\Programs\Greenshot\Plugins\Discord\Greenshot.Plugin.Discord.dll
6. Restart Greenshot.

Usage

1. Open a Discord channel or DM where you want to send screenshots.
2. Keep Discord running (it can be minimized or in the system tray).
3. Take a Greenshot screenshot (for example Print Screen).
4. Select Send to Discord from Greenshot’s destination menu.
5. The plugin restores Discord if needed, pastes the capture, optionally presses Enter (based on settings), then restores your previous window and Discord state.
6. If Discord is closed, Greenshot shows the destination menu again.

Plugin Settings

Configure the plugin from Greenshot's plugin configuration UI:

• EnterToSend: When enabled, the plugin presses Enter after paste. When disabled, it only pastes.
• Restore Original Window: When enabled, focus returns to your previous app after send. When disabled, Discord stays focused.
• Restore Discord State: When enabled, Discord returns to its previous window state after send. When disabled, Discord remains open/foreground.
• Show Status Toast: When enabled, shows a notification for success/failure (including when Discord is not running).
• Require Chat Screen: When enabled, sending is blocked if Discord appears to be on non-chat screens (Friends/Library/Shop/etc). This check is heuristic.
• Delay Profile: Controls key timing used for activation/paste:
  • Fast (lowest delay)
  • Normal (default)
  • Slow (highest delay; best for slower systems)
• Paste Mode: Chooses which key combination is used to paste:
  • CtrlV (default)
  • ShiftInsert

Settings are persisted to:

• %AppData%\Roaming\Greenshot\Plugins\Greenshot.Plugin.Discord.settings

Building from Source

CI builds and releases from git tags (v*) and injects the tag version into both the plugin DLL version and .gsp metadata.

Local build

1. Download Greenshot 1.3.x dependencies into lib/:
   • macOS/Linux: ./scripts/download-greenshot-1.3.sh
   • Windows (PowerShell): .\scripts\download-greenshot-1.3.ps1
2. Build:
   • msbuild GreenshotDiscordPlugin.csproj /p:Configuration=Release /p:Platform=AnyCPU
3. Optional explicit version:
   • msbuild GreenshotDiscordPlugin.csproj /p:Configuration=Release /p:Platform=AnyCPU /p:PluginVersion=1.2.3 /p:PluginAssemblyVersion=1.2.3.0

License

The source code for this plugin is authored by LTDev LLC and released under the permissive MIT License.

Note: The compiled release binaries link against Greenshot's core libraries, which are licensed under the GNU General Public License (GPL). By distributing the compiled binaries alongside this open-source repository, this project complies with the GPL derivative work requirements.