Geierlein is a free (AGPL'ed) Elster client, i.e. an application that
allows to send VAT declaration to Germany's fiscal authorities.

Since this application is to be considered useful only for people living
in Germany, the rest of this README file is written in German language.

=============================================================================

Geierlein ist ein freier Elster-Client und letztlich eine vollständige
Neuentwicklung der beiden Vorgängerkomponenten libgeier & Taxbird.  Im
Gegensatz zu ebendiesen ist Geierlein vollständig in JavaScript und HTML5
entwickelt, sodass es weitestgehend plattformunabhängig sein sollte.
Hieraus resultiert ebenfalls, dass kein Kompilieren erforderlich ist.
Geierlein kann direkt ausgeführt werden.

Geierlein ist Teil des Taxbird Projekts.

Die Übermittlung der Jahreserklärungen (hauptsächlich Einkommen-
steuererklärungen) ist gegenwärtig noch nicht möglich, da die
Möglichkeit seitens der Finanzverwaltung bisher nicht eingeräumt
wurde. Wann und ob dies irgendwann mit freier Software zulässig sein
wird, ist momentan leider nicht abschätzbar.

=============================================================================

 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU Affero General Public License as
 published by the Free Software Foundation, either version 3 of the
 License, or (at your option) any later version.

 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU Affero General Public License for more details.

 You should have received a copy of the GNU Affero General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.

=============================================================================

Geierlein kann momentan in Form zweier verschiedener Oberflächen verwendet
werden

 a) Mozilla XUL-basierte grafische Desktop-Anwendung

 b) Kommandozeilenanwendung auf Basis von Node.js


Geierlein ist momentan noch in der Beta-Phase.  Die Übermittlung von
signierten bzw. authentifizierten Umsatzsteuervoranmeldungen ist momentan
noch NICHT möglich.


 Mozilla XUL-Anwendung
------------------------

Um Geierlein als XUL-Anwendung starten zu können, ist der XUL-Runner von
Mozilla erforderlich.  XUL-Runner kann direkt bei Mozilla unter
https://developer.mozilla.org/de/xulrunner heruntergeladen werden und
ist auch Teil der meisten GNU/Linux Distributionen.

Neuere Firefox-Versionen (alle ab Version 3) sind mit einem XUL-Runner
Paket ausgestattet, soll heißen, wer Firefox installiert hat kann
Geierlein direkt ausführen:

   $ firefox -app application.ini


Wer XUL-Runner installiert hat, kann beim Aufruf das Argument "-app" weg
lassen.

Mit Geierlein abgespeicherte Dateien können auch direkt von der
Kommandozeile aus aufgerufen werden:

   $ firefox -app application.ini -load pfad/zur/datei



 Kommandozeilenanwendung
--------------------------

Mit Node.js kann Geierlein auch direkt von der Kommandozeile genutzt
werden.  Erforderlich ist eine Node.js Installation mit den Zusatzpaketen
"iconv" und "optimist".  Diese sind nicht Teil der Geierlein Distribution,
können jedoch mit folgendem Aufruf installiert werden:

   $ npm install .

Sobald die Node.js Umgebung installiert ist, kann Geierlein wie folgt
verwendet werden:

Um eine Testübertragung einer Umsatzsteuervoranmeldung durchzuführen:

   $ bin/geierlein -t -f doc/examples/ustva

Um einen Echtfall zu übertragen (Achtung, ohne weitere Rückfrage!):

   $ bin/geierlein -f doc/examples/ustva

Das Übertragungsprotokoll wird direkt auf die Standardausgabe geschrieben.
Wenn das Protokoll gespeichert werden soll (also eigentlich immer), sollte
die Ausgabe umgeleitet werden:

   $ bin/geierlein -f doc/examples/ustva > protokoll/2012-04.xml

Das XML-Dokument referenziert ein Stylesheet, das Teil von Geierlein ist,
sodass moderne Browser dieses in einer druckbaren Form darstellen.

Google Chrome bzw. Chromium hat standardmäßig ein sehr, sehr, sehr
restriktives Sicherheitsmodell, das untersagt, dass eine Datei sich auf
eine Datei in einem Ordner (auf dem gleichen System) beziehen darf.
Heißt, dass Chrome in Standardeinstellung das Laden des Stylesheets
verhindert.  Dies kann mit der Option --allow-file-access-from-files
beim Start umgangen werden.

Die Kommandozeilenanwendung kann die von der GUI-Anwendung gespeicherten
Dateien öffnen.  Im Übrigen findet sich unter doc/examples/ustva eine
Beispiel-Datei.


 Installation der Git-Version
-------------------------------

Der Quellcode von Geierlein ist unter https://github.com/stesie/geierlein
verfügbar.  Wenn du Verbesserungen am Programm vornehmen möchtest, kannst
du dort auch einen eigenen Fork anlegen und anschließend über einen Pull
Request zur Verfügung stellen.

Geierlein verwendet momentan zwei Module, die zusätzlich zu installieren
sind:

   $ git clone git://github.com/stesie/geierlein.git
   $ git submodule init
   $ git submodule update


=============================================================================


Vielen Dank, dass Du Geierlein verwendest!