# openXJV
Viewer for XJustiz files used for file / data transfers between courts, lawyers, agencies, unions, citizens, etc. in  Germany's ERV-System

openXJV ist ein **kostenloses Anzeigeprogramm für XJustiz-Dateien (XJustiz Viewer)**, die im Rahmen des elektronischen Rechtsverkehrs bei der Übertragung von Dokumenten Verwendung finden.

Dies ist z. B. **für die Akteneinsicht in Akten der Bundesanstalt für Arbeit (BA)** relevant, 
  da diese auf elektronischem Wege lediglich Einzeldateien mit einem begleitenden XJustiz-Datensatz übermittelt. Erst das Auslesen des Datensatzes erzeugt aus der übermittelten "Dateisammlung" wieder eine sinnvolle Aktendarstellung.

**Es eignet sich auch zur Anzeige beliebiger XJustiz-Datensätze der "Schriftgutübermittlung" über beA, eBO, beN, etc.** 

**openXJV unterstützt den XJustiz-Standard in den Versionen 3.6.2, 3.5.1, 3.4.1, 3.3.1, 3.2.1 sowie 2.4.1**. Es werden die wichtigsten Datentypen und Strukturen unterstützt - eine vollständige und abolut fehlerfreie Anzeige kann jedoch nicht garantiert werden. 
**Fachverfahren werden nicht unterstützt.**

**Um die Texerkennungsfunktionalität nutzen zu können, müssen tesseract-ocr, tesseract-ocr-deu und jbig2dec separat installiert werden und über die Umgebungsvariable PATH erreichbar sein.**

[🍕 Unterstützen auch Sie das Projekt – gönnen Sie dem Entwickler eine Pizza (oder gleich mehrere)](https://buymeacoffee.com/digidigital)

Schulungsanfragen richten Sie bitte an [support@digidigital.de](mailto:support@digidigital.de?subject=Schulungsanfrage)

**Hinweis:** Klassische EXE-Installer für Windows und AppImage für Linux finden Sie unter [https://openxjv.de](https://openxjv.de) 

## Installation als Python Package (plattformunabhängig)

### Voraussetzungen
Stellen Sie sicher, dass Python 3 und pip installiert sind:
```bash
python3 -m ensurepip --upgrade
```

### Installation via PyPI
Installieren Sie openXJV mit folgendem Befehl:
```bash
python3 -m pip install openXJV
```

### Programmstart
Das Programm kann auf zwei Arten gestartet werden:
```bash
python3 -m openXJV
```
oder einfach:
```bash
openxjv
```

### Deinstallation
Um das Programm zu deinstallieren:
```bash
python3 -m pip uninstall openXJV
```

## Tipp für macOS-Nutzer

### App-Starter erstellen (ohne Terminal)
Um openXJV auf macOS nach erfolgter Installation wie eine normale Anwendung zu starten, können Sie mit dem Automator einen Launcher erstellen:

1. Öffnen Sie **Automator.app** (zu finden im Launchpad unter „Andere")
2. Klicken Sie auf **„Neues Dokument"**
3. Wählen Sie als Dokumenttyp **„Programm"** aus
4. Suchen Sie in der Aktionsliste (2. Spalte) nach **„AppleScript ausführen"**
5. Ersetzen Sie den Platzhaltertext durch:
   ```applescript
   do shell script "python3 -m openXJV"
   ```
6. Speichern Sie über **Menüleiste: „Ablage" > „Sichern"** als Programm unter **„Programme"**

Danach können Sie openXJV wie jede andere App über das Launchpad starten.

## Dokumentation / Anleitung
Das Benutzerhandbuch finden Sie:
- In der Anwendung unter **„Hilfe"**
- Auf GitHub im Verzeichnis [docs](docs/)
- Zum Download auf [https://openxjv.de](https://openxjv.de)  
