Steuer-Spar-Erklärung

What works

- installation (Express-Installation tested, USB/portabel did not work in earlier installation tests)

- data import

- printing to PDF

- data transfer from (VaST) and to ELSTER

What does not

- program updates

Workarounds

- requirements (archlinux description):

#!/bin/bash

## choose your prefix
export WINEPREFIX=~/.wineSSE27-2022-01-03

## Install wine and necessary libraries once, then comment out
# /etc/pacman.conf: remove the comments
# -> [multilib]
# -> Include = /etc/pacman.d/mirrorlist
# sudo pacman -Syu
# sudo pacman -S wine
# sudo pacman -S wine-gecko wine-mono (evtl. optional)
# sudo pacman -S lib32-gnutls (evtl. optional)

- create a new wine environment and install necessary libraries

## create a new wine environment once, then comment out
wineboot -u
winetricks -f vcrun2019 crypt32
winetricks fontsmooth=rgb
winetricks win10

- install the program

 
 ## install the program from your disk or download path once, then comment out
 wine ~/Win-SteuerSparErklaerung_27.22.44.exe
 
 

- run the program, workarounds for graphic errors

## if screen blanks partly, you can try to use software rendering
## see https://wiki.archlinux.org/title/OpenGL for possible options for GALLIUM_DRIVER
# export LIBGL_ALWAYS_SOFTWARE=1 GALLIUM_DRIVER=swrast LIBGL_DEBUG=1

## with my Intel GMA using software rendering does not work since 2020
## see https://wiki.archlinux.org/title/Intel_graphics#DRI3_issues helped me
export LIBGL_DRI3_DISABLE=1

wine $WINEPREFIX/drive_c/Program\ Files\ \(x86\)/Akademische\ Arbeitsgemeinschaft/SteuerSparErklaerung\ */SSE.exe

What was not tested

- printing to printer

Hardware tested

Graphics:

• GPU: Intel
• Driver: open source

Additional Comments

- you can put all the code snippets together in one file "steuer2021.sh" if you want and run and debug from the console if it does not run out of the box

- check out: https://wiki.winehq.org/3D_Dri... if the program does not start 

- the wine version 8.1 was automatically installed from the multilib in arch. Older wine-Versions (e.g. using playonlinx) might also work.

- was initially tested using the then current wine version 7.0-rc3 

Hallo alle! 
Bei der schwachen Unterstützung des Maintainer-Teams durch die Akademische Arbeitsgemeinschaft hält sich die Bereitschaft unseres Teams in Grenzen, viel Zeit in die jährlichen Aktualisierungen zu stecken.

Wir übernehmen die Installationsanleitungen daher normalerweise vom Vorjahr.
Falls sich etwas Elementares ändert und uns das nicht aufgefallen ist gibt es für euch einen guten und einen weniger guten Weg, das mitzuteilen.

Der gute Weg:
Sich z.B. als Supermaintainer anmelden (gilt dann auch für die zukünftigen Jahrgänge) und die Erkenntnisse übersichtlich einbauen:
How-to's, geschrieben in grün, nennen grundlegende Standardarbeiten.
Notes, in blau, geben ergänzende Infos.
Warnings, rot, nennen Reparaturen.
Die Reihenfolge könnt ihr oben rechts über "Manage notes" optimieren.
Und scheut euch nicht, diese Anleitung hier, auch die grüne, grundlegend zu ändern. Wenn ihr z.B. rausgefunden habt, dass nach neuen Wine-Versionen manche winetricks nicht mehr gebraucht werden, usw.

Der weniger gute Weg, aber immer noch besser als gar nichts:
Ihr postet eure Erkenntnisse als Comment.
Oder ihr informiert die Maintainer.

Gemeinsam sind wir stark.

Herzlichen Dank für die Mitarbeit an alle!

Diese Installationstipps stammen aus einem der beiden SSE 2020-Tests von Stephan Windm�ller. Wer die Anleitung erg�nzen oder �ndern will, meldet sich bitte als Maintainer an und schreibt seine Erkenntnisse dazu. So entsteht eine homogene Anleitung, und die User m�ssen sich ihren Weg nicht aus den vielen Comments zusammen suchen. 
WICHTIG: Formuliert eure Tipps bitte so, dass ein nicht-Linux-Freak, also z.B. ein Super-Windows-DAU (=d�mmster anzunehmender User) die Sachen auch in die Tat umsetzen kann ;-)

1. Installation in einem separaten 64bit-Wine-Prefix, der zuvor mit winecfg auf "Windows 10" konfiguriert wurde. (Also im Terminal "winecfg" eingeben. Nat�rlich vorher Wine installieren)
2. Verbesserung der Schriftanzeige mit "winetricks fontsmooth=rgb".
   Abgesehen von diesem Workaround sind keine weiteren Anpassungen notwendig.
3. Die aktuelle Installationsdatei der SSE downloaden und installieren. Dazu nach dem Download im Teminal in den Download-Ordner wechseln (siehe cd-Befehl). Die Installation wird gestartet mit dem Befehl "wine namedergedownloadetenversion.exe", z.B. "wine Win-SteuerSparErklaerung_25.36.82.exe"
   Es kann die normale Installationsweise gew�hlt werden, �fter muss man unerwartet lange warten, also ca. 1 Minute.
4. Beim Abschluss der Installation kann das Setup-Programm h�ngen bleiben. Einfach mit Strg+C beenden.
5. Der Starter findet sich auf dem Desktop oder im Wine-Ordner des Startmen�s. Name "SteuerSparErkl�rung 2022". 
6. Falls der neue Dialog "Vorbereiten Ihrer Steuererkl�rung" beim ersten Start ohne Schriften angezeigt wird, einfach mit der Maus das Fenster bewegen. Alternativ den zweiten Knopf dr�cken (Einstieg �berspringen).

Bisher ist es bei Updates h�ufig dazu gekommen, dass nichts mehr ging. Falls jemand austesten will, ob das immer noch so ist, darf er das gerne machen und seine Ergebnisse hier als Maintainer eintragen.

Oft passiert es so, dass die Programmoberfl�che meldet, dass es eine neue Version gibt, und man klickt einfach auf die Update-Schaltfl�che. 

Oder man wird vor dem ELSTER-Versand aufgefordert, ein Update durchzuf�hren, damit ELSTER richtig funktioniert, und man l�sst sich so zum Update �ber die Programmoberfl�che verleiten. 
H�ufiges Ergebnis ist dann, dass das Programm beim Startversuch einfriert, und auf keine Taste mehr reagiert.

Kein Problem, die L�sung ist sehr einfach:

Die ersten Schritte aus der Kurzanleitung fallen weg.

Die aktuelle Version in den Homeordner downloaden.
Diese mit $ wine SteuerSparErklaerung_AB.CD.EF.exe installieren

Die Neuinstallation greift auf die von der Vorversion angelegten Daten zu; z.B. ist der Code nicht mehr einzugeben, und auch die Pfadeinstellungen werden �bernommen
Die weiteren Schritte aus der Kurzanleitung fallen ebenfalls weg; die f�r die Vorversion angelegten Starter sollten funktionieren.

Direkt nach der Installation:

• Falls der neue Dialog "Vorbereiten Ihrer Steuererkl�rung" beim ersten Start ohne Schriften angezeigt wird, einfach mit der Maus das Fenster bewegen. Alternativ den zweiten Knopf dr�cken (Einstieg �berspringen).
• Oft funktioniert die Internetverbindung nicht, z.B. um auf Updates zu �berpr�fen und diese dann herunterzuladen. Siehe dazu weiterer Hinweis "Das Update-Problem"

Falls das Programm nicht startet:

• im Terminal das Programm starten, z.B. so

  export WINEPREFIX="~/.wineSSE27-2023-02-10" 
  wine "C:\Program Files (x86)\Akademische Arbeitsgemeinschaft\SteuerSparErklaerung 2022\SteuertippsCenter.exe"

  wobei man das WINEPREFIX nur braucht, wenn man die Empfehlung beherzigt hat, eine solche Umgebung festzulegen, ansonsten reicht wine "C:\Program Files (x86)\Akademische Arbeitsgemeinschaft\SteuerSparErklaerung 2022\SteuertippsCenter.exe"
• Wenn man den Fehler nicht erkennen kann, kann man hier nach Hilfe suchen, falls es sich um Grafikprobleme handelt: https://wiki.winehq.org/3D_Driver_Issues

Wenn der Bildschirm teilweise schwarz wird:

• Zus�tzliche Export-Befehle ausf�hren: Folgende Exportbefehle auf dem Terminal vorher ausf�hren.

  export LIBGL_ALWAYS_SOFTWARE=1 GALLIUM_DRIVER=swrast LIBGL_DEBUG=1

  Hier kann man nachlesen, welche Optionen man probieren kann: https://wiki.archlinux.org/title/OpenGL
  

Bei Darstellungsfehler / Nichtstarten mit �lteren Intel Grafikkarten:

• Wie weiter oben beschrieben, mit zus�tzlichem Export-Befehl auf einem Terminal, weil ich eine Intel GMA Grafikkarte habe, nachzulesen hier: https://wiki.archlinux.org/title/Intel_graphics#DRI3_issues helped me

  export LIBGL_DRI3_DISABLE=1

Achtung: Wenn man mit weiteren Export-Befehlen Erfolg hatte, werden diese von den bei der Installation erstellten Startsymbolen nicht beherzigt. Daher ist es in solchen F�llen ratsam die Steuersparerkl�rung immer auf dem Terminal (nach Eingabe aller notwendigen Export-Befehle) zu starten, z.B. so

export LIBGL_ALWAYS_SOFTWARE=1 GALLIUM_DRIVER=swrast
export WINEPREFIX="~/.wineSSE27-2023-02-10" 
wine "C:\Program Files (x86)\Akademische Arbeitsgemeinschaft\SteuerSparErklaerung 2022\SteuertippsCenter.exe"