Progress Reader – NVDA-Addon

(C) 2025, Imam Kahraman

Lizenz: GNU General Public License v3 (GPL-3.0) (siehe LICENSE-Datei: https://www.gnu.org/licenses/gpl-3.0.txt)

Dieses NVDA-Addon ermöglicht es, Fortschrittsbalken (Progressbars) in verschiedenen Anwendungen auszulesen und den aktuellen Fortschritt per Sprachausgabe wiederzugeben. Die Erkennung erfolgt über mehrere Schnittstellen, um eine breite Kompatibilität mit unterschiedlichen Software-Technologien sicherzustellen. Zusätzlich bietet das Add-on ein eigenes Auto-Refresh-Fenster mit mehrzeiliger, schreibgeschützter Textbox, die den Fortschritt automatisch aktualisiert

Hier geht es zur aktuellen Version zum Download

Inhalt

1. Installation des Add-ons
2. Verwendung der Fortschrittsanzeige
3. Hinweise zur Funktionalität
4. Versionsverlauf
5. Lizenz & Haftungsausschluss

1) Installation des Add-ons

Installation über den NVDA Add-on Store

1. Öffne NVDA und navigiere zu Werkzeuge > Store für Addon-Erweiterungen.
2. Suche nach "Progress Reader" und wähle es aus.
3. Klicke auf "Installieren" und folge den Anweisungen.
4. Starte NVDA neu, um das Add-on zu aktivieren.

Manuelle Installation (.nvda-addon-Datei)

Falls das Add-on nicht im Store verfügbar ist:

1. Lade die .nvda-addon-Datei herunter. Hier geht es zur aktuellen Version zum Download
2. Öffne NVDA und navigiere zu Werkzeuge > Store für Addon-Erweiterungen.
3. Klicke auf „Aus externer Quelle installieren…“ und wähle die .nvda-addon-Datei aus.
4. Bestätige die Installation und starte NVDA neu, um das Add-on zu aktivieren.

2) Verwendung der Fortschrittsanzeige

1. Wechsle in eine Anwendung mit einer aktiven Fortschrittsanzeige (z. B. Dateiübertragung, Ladebalken, Softwareinstallation).
2. Drücke NVDA + Shift + R, um das Auto-Refresh-Fenster zu öffnen.
3. Beim Öffnen werden automatisch die gefundenen Progressbars gemerkt.
4. Das Fenster zeigt den Fortschritt kontinuierlich in einer mehrzeiligen Textbox an.
5. Der Fokus springt bei jeder Aktualisierung automatisch auf die erste Zeile.
6. Mit erneutem Drücken von NVDA + Shift + R wird das Fenster geschlossen.
7. Drücke NVDA + Shift + U, um das Aktualisierungsintervall (in Sekunden) zu ändern.

3) Hinweise zur Funktionalität

• Falls mehrere Fortschrittsbalken im aktiven Fenster vorhanden sind, werden alle gefundenen gemerkt und im Auto-Refresh-Fenster angezeigt.
• Wenn kein Progressbar erkannt wird, gibt NVDA die Meldung "Keine Progressbar gefunden" aus.
• Falls der Fortschrittswert oder das Maximum nicht ermittelt werden kann, wird ein Standardwert von 0–100% angenommen.
• Manche Anwendungen verwenden proprietäre UI-Elemente, die nicht standardmäßig erkannt werden können.
• Alle Tastenkombinationen sind über die NVDA-Eingabegesten konfigurierbar und können vom Benutzer angepasst werden.

4) Versionsverlauf

v0.4.0:

• Bump Version and tested in latest NVDA 2026.1.1

v0.3.0:

• Ausgabefenster auf mehrzeiliges, schreibgeschütztes Textfeld (TextCtrl) umgestellt
• Automatischer Fokus auf die Textbox beim Öffnen, Cursor springt bei Aktualisierung auf die erste Zeile
• Einstellungsdialog geändert: Eingabe des Intervalls in Sekunden (intern weiterhin Millisekunden)
• Reset-Button im Einstellungsdialog setzt Intervall auf Standardwert zurück
• Neuer „Spenden“-Button im Einstellungsdialog öffnet die PayPal-Seite im Standardbrowser
• Progressbar-Fenster/Objekte werden beim Öffnen des Refresh-Fensters automatisch gemerkt
• Alle Benutzeroberflächen-Strings für Übersetzung vorbereitet
• Gesten über @script-Decorator registriert, sodass sie im NVDA-Eingabegesten-Dialog vom Nutzer angepasst werden können

v0.2.5

• Für NVDA 2025.3.2 aktualisiert.
• Neue Sprache ukrainisch (uk_UA) hinzugefügt.

v0.2.4

• Für NVDA 2025.2 aktualisiert.

v0.2.3

• Für NVDA 2025.1.2 aktualisiert.
• Neue Sprache vereinfachtes Chinesisch (zh_CN) hinzugefügt.

v0.2.2

• Für NVDA 2025.1.1 aktualisiert.

v0.2.1

• Für NVDA 2024.4.2 aktualisiert.

v0.2.0

• Kommentarzeilen für den Übersetzer hinzugefügt.
• Codebereinigung: Debug-Methode entfernt, da sie nicht mehr benötigt wird.
• Kommentarzeilen hinzugefügt, die die Addon-Datei einschließlich der Dateiversion beschreiben.

v0.1.7

• Bugfix: Korrekte Erkennung von Fortschrittsbalken – verhindert fälschliche "0% Fortschritt"-Anzeigen.
• Anpassen der Sprachdateien.

v0.1.6

• Mehrere gefundene Fortschrittsbalken in einem Fenster werden in einem Textfenster ausgegeben
• Änderung der Tastenkombination über den Einstellungsdialog möglich: Addon wird in einer eigenen Kategorie angezeigt

v0.1.5

• Einrückungen im Code auf Tabs umgestellt
• englische Übersetzung hinzugefügt.
• Fehler in der readme-Datei behoben

v0.1.4

• Behoben: Erkennung von UI-Elementen im Kopier- und Verschiebedialog von Windows.

v0.1.3

• Tastenkombination umgestellt auf NVDA + SHIFT + U
• Update der Tastenkombination in ReadMe-Datei
• Code bereinigt
• Verwenden von GPL v3.0

v0.1.2

• ReadMe-Datei verbessert und Nutzungshinweise ergänzt.
• Erweiterte Unterstützung für verschiedene UI-Technologien:
• Native Windows-Controls (klassische Fortschrittsbalken)
• WPF / WinForms (Microsoft-.NET-Technologien)
• wxPython/wxWidgets (z. B. wx.Gauge)
• Java-Anwendungen (mit korrekter Accessibility-API)
• Webbasierte Progressbars (abhängig vom Browser und ARIA-Support)

v0.1.0

• Erste Version mit Basisfunktionalität für das Erkennen und Auslesen von Fortschrittsbalken.

5) Lizenz & Haftungsausschluss

Dieses Add-on wird unter der GNU General Public License v3 (GPL-3.0) veröffentlicht. Siehe die LICENSE-Datei für weitere Informationen. Diese Datei gibt es hier: https://www.gnu.org/licenses/gpl-3.0.txt

Lizenzbestimmungen:

• Dieses Add-on ist freie Software und darf verbreitet, verändert und weitergegeben werden, solange es Open Source bleibt.
• Jegliche Modifikationen müssen unter derselben Lizenz (GPLv3) veröffentlicht werden.
• Die Verwendung in proprietärer oder kommerzieller Software ist untersagt.

Haftungsausschluss:

Dieses Add-on wird ohne jegliche Garantie oder Gewährleistung bereitgestellt. Der Autor übernimmt keine Verantwortung für Schäden oder Datenverluste, die durch die Nutzung dieses Add-ons entstehen könnten.

(C) 2025, Imam Kahraman

Lizenz: GNU General Public License v3 (GPL-3.0) (siehe LICENSE-Datei: https://www.gnu.org/licenses/gpl-3.0.txt)

Spenden via PayPal