HUScroll

Scroll-Capture Plugin für Greenshot
Lange Webseiten und Fenster als ein Bild – automatisch gescrollt oder selbst gescrollt, zusammengesetzt und im Greenshot-Editor zum Zuschneiden.

Benutzung · Installation · Änderungen · Lizenz

---

HUScroll ist ein Plugin für Greenshot – Quellcode und Releases von Greenshot: github.com/greenshot/greenshot. Greenshot muss installiert sein.

Greenshot	Plugin-Variante	Gebaut gegen	Status
1.3.x	Greenshot-1.3 (.NET Framework 4.7.2)	1.3.323	Hauptvariante
1.4.x	Greenshot-1.4 (.NET Framework 4.8)	1.4.324 (Continuous Build)	getestet; Plugin-API kann sich noch ändern

Benutzung

Rechtsklick aufs Greenshot-Tray-Symbol:

Scroll-Capture automatisch (HUScroll) – HUScroll scrollt selbst bis zum Ende

Scroll-Capture manuell (HUScroll) – du scrollst selbst mit dem Mausrad; der Rahmen bleibt stehen (durchklickbar), HUScroll nimmt jede Position auf. Zurückscrollen ist erlaubt, angehängt wird erst wieder unterhalb der tiefsten Stelle. Roter Rahmen = kein Anschluss (zu weit auf einmal gescrollt) → etwas zurückscrollen.

Tastenkürzel (nur Greenshot 1.4): HUScroll bringt zwei Rezepte mit – Strg + Alt + Druck = automatisch, Strg + Alt + Shift + Druck = manuell, Ergebnis im Editor. Tasten ändern oder weitere Schritte anhängen (speichern, Zwischenablage, hochladen …) im Rezept-Editor von Greenshot; der Schritt heißt „Scroll-Capture (HUScroll)“. Greenshot 1.3 kennt keine Rezepte – dort nur über das Tray-Menü.

Auswahl (beide Modi):

• Klick: Fenster bzw. Seiteninhalt unter der Maus (bei Browsern wird der Seitenbereich erkannt, wenn er ein eigenes Fenster-Handle hat)
• Ziehen: freier Bereich (Rahmen)
• Shift gedrückt halten: ganzes Fenster statt Seiteninhalt
• Esc oder Fertig: Aufnahme beenden, das Ergebnis bis dahin geht in den Editor (Esc direkt nach der Auswahl, bevor das erste Bild aufgenommen ist, bricht ab)

Automatisch hört HUScroll von selbst auf, wenn sich der Inhalt nicht mehr bewegt (Seitenende); beide Modi stoppen bei 30 000 px Höhe oder 120 Bildern. Eine Info-Meldung gibt es nur bei Abbruch oder Problemen.

Installation

HUScroll-<Version>.zip aus den Releases in den Downloads-Ordner laden, dann in einer normalen PowerShell (Version im Dateinamen anpassen):

# Zielmaschine: der PC, auf dem Greenshot läuft
Expand-Archive "$env:USERPROFILE\Downloads\HUScroll-0.5.2.zip" -DestinationPath "$env:USERPROFILE\Downloads\HUScroll-0.5.2" -Force
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\Downloads\HUScroll-0.5.2\Install-HUScroll.ps1"

Das Script erkennt die Greenshot-Version und installiert die passende DLL:

• 1.3: nach %APPDATA%\Greenshot\Plugins\Greenshot.Plugin.HUScroll\ (keine Adminrechte nötig)
• 1.4: nach <Greenshot-Ordner>\Plugins\Greenshot.Plugin.HUScroll\ – 1.4 lädt Plugins nur aus dem eigenen Ordner; Adminrechte nur nötig, wenn Greenshot unter C:\Program Files liegt
• PortableApps (Ordner App\Greenshot neben der exe): nach App\Greenshot\Plugins\…

Eine bestimmte Greenshot-Installation (z. B. die portable 1.4 zum Testen): Install-HUScroll.ps1 -GreenshotPath "C:\Pfad\Greenshot.exe"

Deinstallation: denselben Befehl mit -Uninstall am Ende ausführen.

Verteilen mit Intune (für alle Benutzer)

Als Win32-App mit dem entpackten ZIP-Ordner als Inhalt:

Installieren	powershell.exe -NoProfile -ExecutionPolicy Bypass -File Install-HUScroll.ps1 -AllUsers
Deinstallieren	powershell.exe -NoProfile -ExecutionPolicy Bypass -File Install-HUScroll.ps1 -AllUsers -Uninstall
Ausführen als	System
Erkennung	Datei C:\Program Files\Greenshot\Plugins\Greenshot.Plugin.HUScroll\Greenshot.Plugin.HUScroll.dll
Abhängigkeit	Greenshot (für alle Benutzer installiert)
Rückgabecode	1618 = Wiederholen (Standard in Intune)

-AllUsers legt das Plugin immer in den Greenshot-Ordner (auch bei 1.3), entfernt Kopien in den Benutzerprofilen, fragt nie nach und beendet Greenshot nie mit Gewalt. Läuft Greenshot bei einem angemeldeten Benutzer, wird es in dessen Sitzung normal geschlossen und neu gestartet – das Plugin ist sofort da. Ist ein Editor mit ungespeichertem Bild offen, bleibt Greenshot offen und das Plugin kommt beim nächsten Start (-NoRestart: nie neu starten). Läuft Greenshot mit einer älteren HUScroll-Version, ist die Datei gesperrt: Exit-Code 1618, Intune versucht es später erneut. Protokoll: %ProgramData%\HUScroll\Install-HUScroll.log.

So funktioniert's

1. Auswahl: Vollbild-Overlay auf einem eingefrorenen Screenshot, Fenster unter der Maus werden hervorgehoben (WindowFinder, RegionSelectorForm).
2. Scrollen: Mausrad-Eingaben per SendInput in die Mitte des Bereichs, danach wird der Mauszeiger aus dem Bereich geparkt (keine Hover-Effekte). Die Schrittweite passt sich an: ca. 50 % des scrollenden Bereichs pro Schritt, der Rest ist Überlappung.
3. Warten: nach jedem Schritt wird so lange aufgenommen, bis zwei Aufnahmen identisch sind oder sich nur noch ein begrenzter Teil ändert (Smooth-Scrolling, Lazy Loading). Was sich ohne Scrollen ändert, gilt als Animation und wird beim Vergleich ausgeblendet (AnimationDetector).
4. Zusammensetzen (StitchEngine, plattformunabhängig und getestet):
   • Fixe Kopf-/Fußzeilen (Sticky Header, Browser-Leisten) werden erkannt und nur einmal übernommen.
   • Scrollbalken (rechter Rand) und feste Seitenleisten werden beim Vergleich ignoriert.
   • Verglichen wird ein Raster aus kleinen Zellen (32 px × 1 Zeile); Zellen mit bewegtem Inhalt in einem der beiden Bilder zählen nicht. Die Verschiebung mit den meisten übereinstimmenden Zellen gewinnt, nur neue Zeilen werden angehängt.
5. Übergabe: Greenshot-Surface mit dem Bild → Ziel Editor.

Bekannte Grenzen

• Bewegte Inhalte (GIFs, Videos, Karussells) werden erkannt und beim Vergleich ausgeblendet. Ändert sich trotzdem zu viel, schätzt der Automatik-Modus den Übergang aus der Scrollweite und meldet das am Ende („… geschätzt, bitte prüfen“) – an diesen Stellen kann eine kleine Naht entstehen.
• Seiten mit eigenem Scroll-Container: die Maus muss beim Start über dem scrollenden Bereich sein (Mitte des gewählten Bereichs).
• Programme, die als Administrator laufen, nehmen von Greenshot (ohne Adminrechte) keine Mausrad-Eingaben an.
• Fixe Elemente mitten im Inhalt (z. B. schwebende Buttons) erscheinen mehrfach – im Editor wegschneiden.

Bauen

Bauanleitung und Projektaufbau für Entwickler: docs/BUILD.md

Lizenz

HUScroll ist ein Plugin für Greenshot und nutzt dessen Programmbibliothek Greenshot.Base.dll. Greenshot steht unter der GPLv3 – deshalb steht auch HUScroll unter der GNU General Public License v3 (oder einer späteren Version).

• Programmcode: GPLv3 – Nutzung, Änderung und Weitergabe nach den Bedingungen der GPLv3
• Name und HU-Logo (Assets/): Die Dateien stehen ebenfalls unter der GPLv3, es werden aber keine Rechte an Name und Logo als Marke gewährt (GPLv3 §7 e). Forks brauchen einen eigenen Namen und ein eigenes Logo – Details in Assets/LICENSE-LOGO.txt.
• Quellcode: liegt jedem Release als HUScroll-src-<Version>.zip bei.
• Fremdkomponenten: Greenshot (GPLv3) und log4net (Apache 2.0) werden nur zum Bauen heruntergeladen und sind nicht im Repository oder in den Releases enthalten; zur Laufzeit verwendet HUScroll die Dateien der installierten Greenshot-Version.