v0.15.0

Neu: Mietfuchs als eigenes Programm

Unter Windows und macOS ist Mietfuchs jetzt ein eigenes Programm mit eigenem Fenster, statt im Browser zu laufen. Es hat ein Symbol in Taskleiste und Dock, und wenn Sie das Fenster schließen, ist Mietfuchs beendet. Die Abrechnung druckt überall gleich, mit Briefpapier und „Seite x von y“, auch auf dem Mac. Der bisherige Hinweis zum Drucken aus Safari entfällt damit.

Unter Linux, auf dem Raspberry Pi und in Docker ändert sich nichts: Dort läuft Mietfuchs weiter im Browser.

Welche Datei für wen

Ihr Rechner	Was Sie laden	Updates
Windows 10 oder 11, auch mit ARM-Chip (z. B. Snapdragon)	Microsoft Store (empfohlen): Mietfuchs im Store	von selbst, ohne Warnung beim Start
Windows ohne Store	Mietfuchs-Setup-0.15.0.exe (eine Datei für Intel/AMD und ARM, ohne Adminrechte)	mit Ihrer Zustimmung von selbst
Mac mit Apple-Chip (M1 und neuer)	Mietfuchs-0.15.0-apple-silicon.dmg	von Hand, Mietfuchs sagt Bescheid
Mac mit Intel-Prozessor	Mietfuchs-0.15.0-intel.dmg	von Hand, Mietfuchs sagt Bescheid
Linux, Raspberry Pi	mietfuchs-linux*.tar.gz oder das Paket (.deb, .rpm, Arch) wie bisher	wie bisher
Docker	ghcr.io/speedone/mietfuchs:0.15.0 wie bisher	wie bisher

Welchen Mac Sie haben, steht im Apple-Menü unter „Über diesen Mac“. Die Schritte für jede Fassung stehen im README.

Docker und Prüfsummen (für Fortgeschrittene)

docker run -d -p 3001:3001 -v mietfuchs-data:/app/server/data \
  --name mietfuchs ghcr.io/speedone/mietfuchs:0.15.0

Ein bestehender Container: docker pull, Container entfernen und mit demselben Volume neu starten, die Daten bleiben erhalten (README).

Die Prüfsummen aller Dateien stehen in SHA256SUMS.txt (README).

Hinweis zum Microsoft Store: Microsoft prüft jede neue Version, bevor der Store sie ausliefert. Das dauert meist einige Tage. Bis dahin liefert der Store noch Version 0.14.1 aus, auch über den Knopf im Hinweis im Cockpit, und diese Fassung kann Ihre Daten noch nicht übernehmen. Arbeiten Sie bis zum Store-Update mit Ihrer bisherigen Programmdatei weiter, oder nehmen Sie gleich den Installer. Später zum Store wechseln geht trotzdem: Installer-Fassung unter „Einstellungen → Apps“ deinstallieren (der Datenordner bleibt), dann aus dem Store installieren. Beide nutzen denselben Datenordner und dürfen nicht gleichzeitig laufen.

Umstieg von der bisherigen Programmdatei

Haben Sie bisher mietfuchs-win.exe oder mietfuchs-macos-… benutzt, übernimmt das neue Programm Ihre Daten selbst:

1. Das neue Programm installieren: aus dem Microsoft Store, mit dem Installer oder auf dem Mac das passende .dmg öffnen und Mietfuchs in „Programme“ ziehen.
2. Das alte Mietfuchs beenden, mit „Mietfuchs beenden“ unten in der Seitenleiste. Vergessen Sie es, bietet das neue Programm „Altes Mietfuchs beenden“ an.
3. Das neue Mietfuchs starten. Es findet Ihre bisherigen Daten (dort, wo die Programmdatei zuletzt lief, sonst in Downloads, Schreibtisch und Dokumente) und zeigt Ort und letzte Änderung. Auf Daten übernehmen klicken.
4. Findet es nichts, fragt es „Haben Sie Mietfuchs schon einmal benutzt?“. Dann „Ja, Daten übernehmen“ wählen und entweder den Ordner der alten Programmdatei auswählen oder das alte Mietfuchs noch einmal starten, unter „Einstellungen“ auf Backup herunterladen (ZIP) klicken und die Datei im neuen über Backup einspielen übernehmen. Beim Weg über das Backup: Haken Sie „Verlauf der Änderungen mitsichern“ an, wenn Sie den Verlauf mitnehmen möchten, tragen Sie Schlüssel für einen KI-Dienst danach neu ein, und starten Sie das alte Mietfuchs nicht mehr.

Mietfuchs kopiert Ihre Daten (Datenbank, Belege und Briefpapier) und vergleicht die Kopie mit dem Original, bevor es umschaltet. Der alte Ordner bleibt unverändert liegen. Beim Weg über den Ordner zeigt die alte Programmdatei ihn danach nur noch zum Ansehen, damit es keine zwei Bestände gibt. Das gilt auch für die Fassung aus dem Microsoft Store. Lag Ihre alte Mac-Programmdatei im Ordner „Programme“, nutzt das neue Programm ihre Daten direkt, ohne Umzug; starten Sie die alte danach nicht mehr.

Handy und zweiter Rechner: Das neue Programm ist zunächst nur auf diesem Rechner erreichbar. Für den Zugriff vom Handy setzen Sie in den Einstellungen das Häkchen „Zugriff aus dem Heimnetz“; die Karte nennt dann die neue Adresse (Port 17517 statt 3001), ein altes Lesezeichen funktioniert nicht mehr. Fragt Windows danach, ob Mietfuchs ins Netz darf, lassen Sie nur „Private Netzwerke“ zu. Kommt das Handy dann nicht durch, führt Windows Ihr WLAN vermutlich als öffentliches Netz: unter „Einstellungen → Netzwerk und Internet → WLAN → Ihr Netz“ den Netzwerkprofiltyp auf „Privates Netzwerk“ stellen. Das gilt auch für die Fassung aus dem Microsoft Store: Wer sie bisher vom Handy aus geöffnet hat, setzt ebenfalls das Häkchen und legt das Lesezeichen neu an.

Beim ersten Start

• Windows, Installer: Hält Ihr Browser die Datei beim Herunterladen zurück, weil sie selten geladen wird, wählen Sie in seiner Download-Liste, dass Sie sie behalten möchten. Beim Start warnt Windows „Der Computer wurde durch Windows geschützt“, weil die Datei nicht kostenpflichtig signiert ist. Klicken Sie auf „Weitere Informationen“ und dann auf „Trotzdem ausführen“. Aus dem Microsoft Store gibt es diese Warnung nicht.
• Mac: macOS blockiert den ersten Start, weil Mietfuchs nicht kostenpflichtig bei Apple signiert ist. Schließen Sie den Dialog, öffnen Sie „Systemeinstellungen → Datenschutz & Sicherheit“ und klicken Sie unten bei der Meldung zu Mietfuchs auf „Dennoch öffnen“. Seit macOS 15 geht das nur noch so, der frühere Weg mit Ctrl-Klick auf „Öffnen“ klappt dort nicht mehr. Sucht Mietfuchs Ihre bisherigen Daten, fragt macOS außerdem, ob es auf Downloads, Schreibtisch und Dokumente zugreifen darf; erlauben Sie es, die Daten verlassen Ihren Mac nicht.

Was mit der bisherigen Programmdatei ist

Die Programmdateien für Windows und macOS gibt es mit diesem Release weiter, mit denselben Namen wie bisher. Wer sie startet, sieht im Cockpit einen Hinweis zum Umstieg mit den Schritten oben; „Später“ blendet ihn bis zum nächsten Update aus. Ein Wechsel ist nicht Pflicht, aber das neue Programm ist der empfohlene Weg.

Bekannte Grenzen

• Mac ab macOS 13 (Ventura): Das neue Programm läuft erst ab macOS 13, die bisherige Programmdatei ebenso. Auf einem älteren Mac öffnen Sie Mietfuchs im Browser, während es auf einem anderen Gerät läuft, etwa unter Windows, Linux, auf einem Raspberry Pi oder in Docker (README).
• Mac ohne automatische Updates: Das ginge nur mit einer kostenpflichtigen Signatur bei Apple. Erlauben Sie die Update-Prüfung, sagt Mietfuchs Bescheid; dann Mietfuchs beenden, das neue .dmg laden und Mietfuchs in „Programme“ ersetzen. Den ersten Start geben Sie danach noch einmal frei.
• Warnungen beim ersten Start bleiben beim Installer und auf dem Mac, siehe oben. Ohne Warnung geht es unter Windows nur über den Microsoft Store.
• Größer als die Programmdatei: Der Installer ist rund 230 MB groß, ein .dmg rund 130 MB, und das Fenster braucht mehr Arbeitsspeicher.
• Store und Installer nicht gleichzeitig: Beide nutzen unter Windows denselben Datenordner %USERPROFILE%\Mietfuchs.
• Store-Fassung 0.14.1 nach dem Umstieg: Hat das neue Programm die Daten einmal geöffnet, sind sie auf dem Stand von 0.15; die Store-Fassung 0.14.1 öffnet sie dann nicht mehr, bis der Microsoft Store 0.15 liefert (die Prüfung dort dauert einige Tage). Ihre Daten sind dabei unverändert.
• Virenschutz: Sperrt ein Virenschutzprogramm eine Datei von Mietfuchs, sagt Mietfuchs beim Start, welche, und wie Sie sie freigeben.

Hinzugefügt

• Download prüfen: Jedes Release hat eine Datei SHA256SUMS.txt mit der Prüfsumme jeder Datei und einen signierten Herkunftsnachweis, dass die Dateien in der Release-Automatik dieses Repos gebaut wurden (prüfbar mit gh attestation verify <Datei> -R speedone/mietfuchs). Anleitung im README unter „Download prüfen“.
• Eigenes Programm für Windows und macOS (#517): Mietfuchs öffnet sich in einem eigenen Fenster statt im Browser, mit Symbol in Taskleiste und Dock. Fenster zu heißt Mietfuchs zu, gedruckt wird mit Briefpapier und „Seite x von y“ auch auf dem Mac. Zum Herunterladen als Mietfuchs-Setup-<Version>.exe für Windows (eine Datei für x64 und ARM64, Installation ohne Adminrechte) und als Mietfuchs-<Version>-apple-silicon.dmg bzw. -intel.dmg für den Mac. Der Mac verlangt beim ersten Start eine Freigabe unter „Systemeinstellungen → Datenschutz & Sicherheit“ und aktualisiert Mietfuchs nicht von selbst, weil es nicht kostenpflichtig bei Apple signiert ist; unter Windows warnt der Installer beim ersten Start, ohne Warnung geht es über den Microsoft Store. Die Daten liegen im Benutzerordner (Windows %USERPROFILE%\Mietfuchs wie im Store, macOS ~/Library/Application Support/Mietfuchs); im Menü öffnet „Datenordner zeigen“ ihn, „Im Browser öffnen“ zeigt Mietfuchs zusätzlich im Browser. Das Programm ist nur auf diesem Rechner erreichbar (http://127.0.0.1:17517), deshalb fragt beim Start keine Firewall. Die bisherigen Programmdateien gibt es weiter; unter Linux, auf dem Raspberry Pi und in Docker bleibt alles, wie es war. Dazu, gefunden beim Test auf echten Rechnern:
  • Der Server liegt als eine einzige Datei im Programmarchiv, dessen Echtheit Mietfuchs beim Lesen prüft, statt als Tausende einzelner Dateien. Das spart beim Download und beim Installieren (Windows rund 230 MB, Mac rund 130 MB), und Installation und Start gehen schneller. Sperrt ein Virenschutz trotzdem eine Datei von Mietfuchs oder entfernt sie, sagt die Meldung beim Start das, nennt die Datei und rät, sie dort freizugeben oder Mietfuchs neu zu installieren.
  • Der Installer prüft mit einem kurzen Blick in die Prozessliste, ob Mietfuchs noch läuft, statt mehrmals PowerShell zu starten; das kostete mit dem Virenschutz von Windows jedes Mal Sekunden. Installieren, Aktualisieren und Deinstallieren gehen so deutlich schneller. Hält Windows gleich nach dem Installieren noch eine Datei offen, versucht es das Deinstallationsprogramm noch einige Male, statt den Programmordner halb gelöscht liegen zu lassen. Wie lange jeder Schritt dauert, steht in %TEMP%\mietfuchs-installation.log. Ein noch offenes Mietfuchs schließt der Installer erst sanft und wartet bis 15 Sekunden, damit es seine Daten zu Ende schreibt; erst dann beendet er es hart. Auch beim Schließen des Fensters wartet Mietfuchs jetzt wirklich, bis der Server fertig geschrieben hat; bisher endete er dabei mitunter mittendrin.
  • Ein beliebig gesetztes CI in der Umgebung (manche Entwicklungsumgebungen setzen es dauerhaft, unter Windows auch als CI=false) schaltet im Programm nichts mehr ab und keine Prüfhilfe ein, etwa den Umzug der Daten oder die Quelle der Updates. Auch bei der Programmdatei zählt CI nur noch mit 1 oder true.
• Automatische Updates unter Windows (#517): Mit dem Häkchen „Beim Öffnen nach neuen Versionen schauen“ lädt das Programm aus dem Installer eine neue Version im Hintergrund von GitHub und meldet dann „Version x ist bereit“; die Frage nach der Zustimmung sagt das dort auch. „Jetzt neu starten“ beendet Mietfuchs sauber, installiert und startet die neue Version; „Beim nächsten Start“ installiert, wenn Sie Mietfuchs beenden. Ungefragt startet Mietfuchs nie neu, und ohne das Häkchen fragt es nicht bei GitHub nach; dann lädt man den neuen Installer selbst von der Release-Seite. Vor dem Umstellen der Datenbank legt Mietfuchs wie bei jedem Update eine Sicherung an. Vorabversionen bietet es nie an. Damit nur die geänderten Teile geladen werden, legt der Installer eine Kopie von sich unter %LOCALAPPDATA%\mietfuchs-updater ab; das Deinstallieren entfernt sie. Aus dem Microsoft Store aktualisiert der Store. Auf dem Mac führt der Update-Hinweis direkt auf das passende Abbild für Apple Silicon oder Intel, und läuft Mietfuchs nicht aus dem Ordner „Programme“, bietet es beim ersten Start einmal an, sich dorthin zu verschieben.
• Umzug der Daten ins neue Programm (#517): Beim ersten Start des Programms unter Windows oder macOS (auch aus dem Microsoft Store) ohne Daten fragt Mietfuchs genau einmal. Findet es Daten der bisherigen Programmdatei (über den gemerkten Ort oder in Downloads, Schreibtisch und Dokumente, auch in OneDrive), nennt es Ort, letzte Änderung und Zahl der Objekte und Mietverhältnisse und bietet „Daten übernehmen“ an; sonst fragt es „Haben Sie Mietfuchs schon einmal benutzt?“ und führt bei „Ja“ zum Backup aus dem alten Mietfuchs („Backup herunterladen (ZIP)“ dort, „Backup einspielen“ hier) oder zur Wahl des Ordners, bei „Nein“ gleich los. Übernommen wird als Kopie: Datenbank, Belege und Briefpapier, auch eine alte db.json aus den ersten Fassungen; die Kopie wird mit dem Original verglichen, erst dann wird umgeschaltet. Läuft das alte Mietfuchs noch, beendet es ein Knopf zuerst; bei großen Beständen zeigt Mietfuchs den Fortschritt und lässt sich abbrechen. Der alte Ordner bleibt unverändert liegen und bekommt beim Weg über den Ordner nur einen Vermerk; eine aktuelle Programmdatei zeigt ihn danach nur noch an. Wird im alten Mietfuchs trotzdem noch etwas geändert, sagt es das neue und bietet an, den neueren Stand noch einmal zu übernehmen; dass eine ältere Programmdatei den alten Ordner nur auf ihren Stand bringt, zählt dabei nicht. Der Papierkorb gelöschter Belege kommt mit, automatische Vorversionen und Sicherungen vor Updates bleiben im alten Ordner, und Mietfuchs sagt das. Wird das Programm beim Umschalten beendet, wartet es, bis die Übernahme fertig ist; endet es trotzdem mittendrin, holt der nächste Start den Vermerk im alten Ordner nach. Später geht das jederzeit in den Einstellungen unter „Daten aus bisherigem Mietfuchs übernehmen …“; vorhandene Daten werden dabei nur nach Rückfrage ersetzt und vorher gesichert.
• Zwei Mietfuchs auf denselben Daten werden erkannt (#517): Laufen das neue Programm und eine Programmdatei oder die bisherige Store-Fassung auf demselben Datenordner (auf dem Mac etwa eine Programmdatei unter „Programme“, unter Windows Store und Installer), startet das zweite nicht mehr daneben. Das Programmfenster sagt „Mietfuchs läuft bereits mit denselben Daten … Bitte beenden Sie das andere Mietfuchs zuerst.“, die Programmdatei öffnet stattdessen das laufende. Bisher konnte so ein eingespieltes Backup im einen die Datenbank des anderen ins Leere laufen lassen. Dafür liegt während des Laufs die Datei mietfuchs.laeuft.json im Datenordner; eine nach einem Absturz liegengebliebene stört nicht.
• Zugriff aus dem Heimnetz (#517): Im neuen Programm lässt sich in den Einstellungen erlauben, Mietfuchs auch auf dem Handy oder einem anderen Rechner im selben WLAN zu öffnen; die Karte nennt dann die Adressen dafür (Port 17517, also eine andere als bei der Programmdatei). Fragt Windows danach, ob Mietfuchs ins Netz darf, rät die Karte, nur „Private Netzwerke“ zuzulassen. Mietfuchs hat kein Passwort, deshalb gilt die Erlaubnis für jeden im Heimnetz. Solange sie an ist, steht in der Seitenleiste „Im Heimnetz erreichbar“ und führt zur Karte. Beenden, KI-Schlüssel, die Bestätigung eines KI-Dienstes im Internet und das Ein- und Ausschalten der Update-Prüfung gehen nur am Rechner selbst, nicht vom Handy.
• Hinweis auf das neue Programm (#517): Wer die Programmdatei unter Windows oder macOS nutzt, sieht im Cockpit eine Karte zum Umstieg: unter Windows mit „Aus dem Microsoft Store laden“ (empfohlen) und „Oder den Installer herunterladen“, auf dem Mac mit „Neues Mietfuchs herunterladen“, dazu die vier Schritte bis „Daten übernehmen“. „Später“ blendet sie bis zum nächsten Update der Programmdatei aus. Die Anleitung zum Aktualisieren der Programmdatei bleibt und nennt den Umstieg mit. Mietfuchs fragt dafür nirgends nach, die Links sind fest.
• Website: Mietfuchs hat eine eigene Website, mietfuchs-app.de, mit Download für jedes System und Ratgebern zur Nebenkostenabrechnung. Der Link steht in den Einstellungen unter „Über Mietfuchs“.
• NKA_HOST legt fest, auf welcher Adresse Mietfuchs lauscht, etwa 127.0.0.1 für nur diesen Rechner; ohne Angabe wie bisher auf allen.

Geändert

• Bindestrich statt Geviertstrich. In Texten, Hinweisen, Fenstertitel und Abrechnung steht als Gedankenstrich jetzt ein Bindestrich („Mietfuchs - Nebenkosten im Griff“), Auswahlfelder zeigen „Bitte wählen“.
• Microsoft Store: Mietfuchs öffnet sich im eigenen Fenster (#517) statt im Browser, wie das neue Programm oben. Die Daten bleiben, wo sie sind (%USERPROFILE%\Mietfuchs). Die Adresse ist jetzt http://127.0.0.1:17517 statt localhost:3001; wer Mietfuchs zusätzlich im Browser aufruft, nimmt die neue Adresse (Menü „Im Browser öffnen“). Vom Handy oder einem zweiten Rechner aus geht es erst mit dem Häkchen „Zugriff aus dem Heimnetz“ in den Einstellungen, dann unter neuer Adresse.
• Microsoft Store: Der Store-Eintrag zeigt die Website mietfuchs-app.de; Website, Datenschutzrichtlinie und Supportkontakt gehen jetzt bei jedem Release mit, und die Beschreibung sagt zusätzlich, dass Mietfuchs ohne Gewähr bereitgestellt wird.
• Mietfuchs antwortet nur noch unter seiner IP-Adresse, localhost und Namen im Heimnetz (etwa raspberrypi, nas.local, pi.fritz.box), und Änderungen nimmt es nur von seiner eigenen Seite an. Das schützt davor, dass eine fremde Webseite im Browser Mietfuchs erreicht oder darin speichert. Wer Mietfuchs unter einem anderen Namen aufruft, trägt ihn in NKA_ALLOWED_HOSTS ein. Im Docker-Image und beim Start aus dem Quellcode bleibt alles wie bisher, solange NKA_ALLOWED_HOSTS nicht gesetzt ist.
• Knöpfe führen an die Stelle, nicht nur auf die Seite (#554): „Wohnung anlegen“, „Mietverhältnis anlegen“ und „Kosten erfassen“ öffnen auf der Zielseite gleich das Formular, mit dem Cursor im ersten Feld. „Prüfen“ und „Beheben“ in der Checkliste des Cockpits und in Hinweisen holen die betroffene Karte ins Bild und heben sie hervor (etwa „Zu prüfen“ in der Abrechnung, die Wohnungen in den Stammdaten, die KI-Belegauswertung in den Einstellungen); betrifft es nur eine Wohnung, einen Zähler oder eine Position, öffnet sich dieser Eintrag. „Hier eintragen → Stammdaten“ in der Steuerübersicht öffnet das Objekt bei „Für die Steuer (Anlage V)“, ein fehlender Absender oder eine falsche IBAN des Objekts bei „Abweichender Vermieter oder Bankverbindung“.

Behoben

• Updates des Programmfensters sind signiert (#551). Unter Windows lädt Mietfuchs eine neue Version nur noch, wenn ihre Beschreibung mit dem Schlüssel von Mietfuchs unterschrieben ist, der im Programm steht. Bisher schützte nur die Prüfsumme, die im selben Release lag wie das Update selbst; ein untergeschobenes Release fing sie nicht ab. Ohne gültige Unterschrift lädt Mietfuchs nichts, und „Über Mietfuchs“ sagt warum.
• Update-Hinweis auf Handy, Tablet und zweitem Rechner ohne falschen Download. Öffnen Sie Mietfuchs über das Heimnetz auf einem anderen Gerät, nannte der Hinweis die Datei des Rechners, auf dem Mietfuchs läuft, und der Knopf lud sie aufs Handy. Dort steht jetzt nur, dass es eine neue Version gibt und dass sie am Rechner installiert wird; der Hinweis auf das neue Programm erscheint nur noch am Rechner selbst.
• Belege laufen abgeschottet von der Oberfläche (#517). Mietfuchs liefert Belege so aus, dass der Browser darin kein Programm ausführt, und nimmt SVG-, HTML- und XML-Dateien nicht mehr als Beleg an; Belege sind PDFs und Bilder. Eine solche Datei, die schon im Belegordner liegt (etwa aus einem Backup), lädt der Browser nur noch herunter. Im eigenen Programmfenster öffnet ein Beleg in einem Fenster ohne Zugriff auf Drucken, Heimnetz und Updates. Die Oberfläche selbst führt nur noch Skripte von Mietfuchs aus.
• Lässt sich die Datenbank nicht öffnen, steht der Grund jetzt in Mietfuchs selbst. Bisher hieß es nur „keine Verbindung zu seiner Datenbank“ mit dem Verweis auf die Meldung beim Start und das Cockpit, wo der Grund aber nicht stand; ohne Konsole (Store, Startmenü, Programmfenster) blieb er unsichtbar. Jetzt nennt jede Fehlermeldung ihn, etwa dass die Datenbank schon von einer neueren Mietfuchs-Version stammt, und oben auf jeder Seite steht er ebenfalls.
• „Mietfuchs beenden“ fehlte, wenn sich die Datenbank nicht öffnen ließ. Aus dem Store und als Programmdatei ging Mietfuchs dann nur noch über den Task-Manager zu beenden. Der Knopf steht jetzt auch in diesem Fall in der Seitenleiste.
• Umzug ins Programmfenster verständlicher (#517). Funde heißen etwa „Ordner „mietfuchs-0.14.1“ in Downloads“, der neueste ist hervorgehoben, beschädigte oder zu neue Daten zeigt die Karte schon vor dem Klick. Danach steht „Ihre Daten sind da“, und Mietfuchs zeigt das Jahr mit den zuletzt erfassten Kosten. Ein Abbruch ist kein Fehler mehr, und eine Datenbank, die sich nicht öffnen lässt, nennt ihren Grund nur noch einmal, mit „Mietfuchs beenden“.

Alle Änderungen: v0.14.1...v0.15.0