Nápověda k Moony

První spuštění

Moony nepotřebuje účet. Nainstalujte ho, otevřete a průvodce nastavením vytvoří šifrovanou databázi v tomto počítači.

Instalace

Aplikace pro Mac je podepsaná a notarizovaná společností Apple a otevře se normálně. Instalátor pro Windows zatím podepsaný není, takže Windows při prvním spuštění zobrazí upozornění; aplikace není poškozená. Postup pro každý systém je na stránce Stáhnout: macOS, Windows, Linux.

Heslo a obnovovací klíč

• Heslo. Odemyká Moony pokaždé. Alespoň 8 znaků, delší fráze je lepší. Moony vám ho nedokáže zobrazit.
• Obnovovací klíč. 24 znaků v šesti skupinách po čtyřech, zobrazí se jednou při nastavení. Je pro krajní případ: když zapomenete heslo, umožní vám zvolit nové (jak). Uložte si ho mimo tento počítač, do správce hesel nebo na papír. Uložit do souboru… vytvoří prostý textový soubor moony-recovery-key.txt; uschovejte ho na externím disku, ne vedle svých dat.

Průvodce nastavením

Přivítání, které můžete přeskočit, vede do pěti kroků:

1. Soukromí: hlavní měna a země bankovnictví (země určuje kategorizační pravidla a při importu řadí její banky na začátek). Už Moony používáte jinde? Zvolte tady raději Obnovit ze zálohy (jak).
2. Účet: jméno, e-mail pro vaši potřebu (nikam se neposílá) a heslo dvakrát.
3. Klíč: váš obnovovací klíč. Uložte si ho, opište dvě skupiny, které Moony požaduje, a klikněte na Vytvořit šifrovanou databázi.
4. Co sledovat: účty, investice, nemovitosti, úvěry a pojištění. Později to změníte v Nastavení → Obecné → Viditelnost v menu; skryté stránky dál fungují.
5. První účet: název, měna a aktuální zůstatek, potom importujte výpis nebo klikněte na Zatím přeskočit. Zůstatky se zadávají ručně; importy je nemění.

Přehled potom zobrazí kontrolní seznam Začínáme.

Zapomenuté heslo a obnovovací klíč

Zadní vrátka neexistují. Moony nemá účet ani server, takže vám heslo nemůže obnovit nikdo, ani autor. Heslo a obnovovací klíč jsou dvě samostatné cesty ke stejným šifrovaným datům. Když nemáte ani jedno z nich, nedá se otevřít nic: ani záznamy, ani připojené fotografie a dokumenty.

Obnovení zapomenutého hesla

1. Na zamykací obrazovce klikněte na Zapomenuté heslo?
2. Zadejte 24znakový obnovovací klíč. Na velikosti písmen, mezerách a pomlčkách nezáleží.
3. Zvolte nové heslo dlouhé alespoň 8 znaků. Ověření klíče trvá několik sekund.
4. Moony zobrazí nový obnovovací klíč. Než budete pokračovat, uložte si ho: starý už nefunguje. Potom klikněte na Pokračovat do aplikace.

Co obnovovací klíč nedělá

• Neprozradí staré heslo, jen umožní nastavit nové.
• Funguje jen s klíčovými soubory salt a recovery.enc, které patří k vašim datům a jsou ve složce s daty i v každé záloze ZIP. Samotné zkopírování moony.db nezachrání nic, co by šlo otevřít; vytvořte raději zálohu (jak).
• Záloha obsahuje klíčové soubory z doby, kdy vznikla. Pokud jste heslo později změnili nebo obnovili, otevře se heslem nebo obnovovacím klíčem, které platily v ten den.

Uschovejte obojí

Obnovovací klíč mějte ve správci hesel nebo na papíře a čerstvou zálohu ZIP na externím disku nebo ve vlastním cloudovém úložišti. S klíčem zacházejte jako s heslem: kdo má klíč i váš zálohový ZIP, může otevřít vaše data.

Když se dovnitř nedostanete nadobro

Bez hesla, obnovovacího klíče a použitelné zálohy jsou stará data ztracená. Chcete-li začít znovu, ukončete Moony a složku s daty (kde je) místo mazání přejmenujte, kdyby se heslo našlo. Při dalším spuštění Moony zobrazí průvodce nastavením a vytvoří prázdný profil.

Import výpisů

Nic se nezapíše, dokud to nepotvrdíte: nejdřív uvidíte náhled, řádky, které už existují, se přeskočí jako duplicity a každý import lze vrátit.

Bankovní výpisy

1. Otevřete Bankovní účty (skupina Peníze) a klikněte na Importovat výpis, v seznamu účtů nebo na stránce účtu.
2. Soubor: přetáhněte výpis nebo ho vyberte. V seznamu Banka zvolte svou banku, nebo nechte Rozpoznat automaticky.
3. Sloupce: u CSV zkontrolujte, který sloupec je který (rozpoznaná banka se vyplní). Ostatní formáty tento krok přeskočí.
4. Náhled a kategorie: zkontrolujte data, částky a kategorie a řádkům, které pravidla nechala bez kategorie, jednu přiřaďte.
5. Hotovo: souhrn ukáže, co se naimportovalo. Vrátíte to v Historii importů účtu tlačítkem Vrátit import.

Import nikdy nemění zůstatek účtu. Pokud výpis uvádí konečný zůstatek, poslední krok nabídne Nastavit zůstatek účtu na ….

Které soubory fungují

• CSV a TXT se 16 předvolbami bank, rozpoznanými podle řádku záhlaví: Revolut, Wise, N26, Sparkasse, DKB, ING (Germany), UK banks (Debit / Credit columns), Chase (US) a v České republice Fio banka, Česká spořitelna, Komerční banka, Air Bank, ČSOB, MONETA Money Bank, mBank a Raiffeisenbank (v jejich českých exportních formátech). Předvolby pro DKB, ING, Komerční banku, Air Bank, ČSOB, MONETA, mBank a Raiffeisenbank zatím nejsou potvrzené skutečným exportem: pokud některá přiřadí sloupce špatně, opravte mapování ručně.
• CAMT.053 (XML), MT940, OFX/QFX a QIF z jakékoli banky, bez přiřazování sloupců. Moony ukáže, ke kterému účtu výpis patří, a pokud soubor uvádí oba zůstatky, zkontroluje, že platby sedí.

CSV z jiné banky

Funguje jakékoli CSV s datem a částkou. V kroku Sloupce:

• Zvolte sloupec s datem a s částkou, nebo sloupec debet a kredit, pokud banka částku dělí. Volitelně přidejte popis, protistranu, její číslo účtu nebo IBAN, měnu, zůstatek a ID transakce.
• Moony zjistí oddělovač, kódování textu, desetinný oddělovač a pořadí data. Pokud Náhled po zpracování vypadá špatně, změňte je: rozbitá diakritika znamená špatné kódování, prohozené dny a měsíce špatné pořadí data. Řádek záhlaví je řádek s názvy sloupců; řádky nad ním se ignorují.
• Výdaje musí vyjít záporné a příjmy kladné. Před importem zkontrolujte pár řádků, které znáte.

Když vaše banka v seznamu není

1. V internetovém bankovnictví hledejte CAMT.053, MT940, OFX, QFX nebo QIF: přiřazování sloupců nepotřebují.
2. Jinak sloupce CSV přiřaďte, jak je popsáno výše; zabere to minutu.
3. Nebo transakce přidejte ručně (Přidat transakci na stránce účtu), případně nechte výpis přečíst volitelného AI asistenta a zkontrolujte, co přečetl, než cokoli uloží (AI asistent).
4. Chcete předvolbu pro svou banku? Otevřete issue na GitHubu (EN) jen s řádkem záhlaví, nikdy se skutečnými transakcemi. Předvolba je jeden malý soubor JSON; návod pro přispěvatele (EN) ukazuje, jak na to.

Obchody z brokerů

Obchody z bankovního výpisu se neimportují; použijte import z brokera. Otevřete Akcie (skupina Investice), klikněte na Importovat CSV a zvolte, odkud export pochází. Každý zdroj ukáže, jak soubor získat, a nabídne vzorek:

• XTB: Historie účtu → Peněžní operace → Exportovat jako CSV, za období od prvního obchodu. Importují se jen nákupy a prodeje akcií a ETF, ne vklady, dividendy ani poplatky.
• Trading 212: Historie → ikona exportu, zaškrtněte Objednávky. Jeden export pokryje nejvýš 12 měsíců, nahrajte tedy více souborů; duplicity se poznají.
• Degiro: Aktivita → Transakce → Export → CSV. Ne výpis z účtu.
• Interactive Brokers: Flex Query (Client Portal → Performance & Reports → Flex Queries) typu Activity se sekcí Trades a poli Symbol, ISIN, TradeDate, Buy/Sell, Quantity, TradePrice, CurrencyPrimary, AssetClass a TradeID, ve formátu CSV.
• Vlastní tabulka nebo jiný broker: stáhněte si vzor Moony, nebo sloupce přiřaďte sami (datum, nákup nebo prodej, symbol nebo ISIN, počet kusů, cena za kus, měna). Moony si mapování může pro příště zapamatovat. Soubory z Excelu nejdřív uložte jako CSV.

Krok Kontrola vypíše, co se naimportuje a které řádky jsou duplicity, přeskočené nebo chybné. Ověří také cenné papíry na Yahoo Finance; toto vyhledání posílá symboly a ISIN ze souboru a nic jiného (Soukromí (EN)). Import vrátíte tlačítkem Vrátit v části Poslední importy nebo přes Historii importů na stránce Akcie.

Záloha, obnovení a nový počítač

Vytvoření zálohy

Otevřete Nastavení → Data a zálohy a klikněte na Zálohovat nyní. Vyberte, kam ZIP uložit (Moony navrhne moony-backup-RRRR-MM-DD.zip).

Obsahuje šifrované kopie vašich záznamů a příloh a klíčové soubory salt, key.enc a recovery.enc a zůstává šifrovaný: otevře ho jen heslo platné v době zálohy nebo obnovovací klíč z té doby.

Jednu kopii mějte mimo tento počítač, na externím disku nebo ve vlastním cloudovém úložišti. Moony nic nenahrává; Přehled připomene, že je poslední záloha stará. Zálohujte před aktualizací a po velkém importu.

Obnovení ze zálohy

Začněte v Nastavení → Data a zálohy → Obnovit ze zálohy…, na zamykací obrazovce (Máte zálohu? Obnovit ze zálohy…) nebo v prvním kroku průvodce nastavením (Obnovit ze zálohy). Potom:

1. Vyberte ZIP. Moony ukáže jeho datum, verzi Moony, počet příloh a velikost.
2. Potvrďte. Stávající data se nemažou: Moony je nejdřív přesune do složky pre-restore-<čas> ve složce s daty.
3. Moony se zamkne. Odemkněte ho heslem, které platilo při vytvoření zálohy, nebo klikněte na Zapomenuté heslo? a použijte obnovovací klíč z té doby.

Zálohu vytvořenou novější verzí Moony starší verze obnovit neumí, takže nejdřív aktualizujte. Zálohy ze starších verzí se obnovují bez potíží.

Přechod na nový počítač

1. Na starém počítači klikněte na Zálohovat nyní a ZIP zkopírujte na nový (USB disk nebo vlastní cloudové úložiště).
2. Na novém počítači nainstalujte stejnou nebo novější verzi Moony (Stáhnout).
3. V prvním kroku průvodce zvolte Obnovit ze zálohy, vyberte ZIP a potvrďte.
4. Odemkněte heslem z doby zálohy.

Moony mezi počítači nesynchronizuje, takže se stará a nová kopie rozejdou, jakmile používáte obě, a změny po záloze v ní nejsou. Až nový počítač funguje, data ze starého odstraňte (jak).

Exportovat JSON na stejné stránce zapíše všechny tabulky do nešifrovaného souboru JSON bez příloh. Není to záloha; zacházejte s ním jako s bankovním výpisem. Ověřit databázi zkontroluje integritu databáze.

Aktualizace, složka s daty a odinstalace

Aktualizace

Po odemknutí se Moony zeptá GitHubu, zda existuje novější verze, a nabídne Aktualizovat a restartovat. Stažený soubor se ověří proti veřejnému klíči projektu; Moony se restartuje a vy ho znovu odemknete. Data zůstanou, kde jsou, a požadavek žádná neposílá.

Ručně zkontrolovat nebo automatickou kontrolu vypnout můžete v Nastavení → Zabezpečení → Aktualizace (platí jen pro tento počítač).

Před aktualizací, která mění databázi, ji Moony zkopíruje vedle sebe (moony.db.bak-<čas>; uchovávají se nejnovější tři). To je pojistka, ne záruka: starší verze databázi, kterou novější převedla, neotevře, proto nejdřív vytvořte zálohu. Návrat na starší verzi znamená obnovit zálohu vytvořenou touto verzí.

Přecházíte z verze 0.10.0 nebo starší? Složka s daty se ve verzi 0.11.0 přejmenovala: před prvním spuštěním si přečtěte část Where your data lives na stránce Soukromí (EN).

Kde jsou vaše data

Všechno je v jedné složce pro každého uživatele:

Nastavení → Data a zálohy ukazuje přesnou cestu a tlačítko Otevřít složku.

Obsahuje moony.db a attachments.db (vaše záznamy a fotografie a dokumenty, šifrované), klíčové soubory salt, key.enc a recovery.enc, kopie .bak-<čas> vytvořené před aktualizací databáze a složky pre-restore-<čas> po obnovení ze zálohy.

Místo ručního kopírování souborů použijte Zálohovat nyní; Moony složku sám nikdy nepřesouvá. Co je a co není šifrované, uvádí stránka Soukromí (EN).

Odinstalace

Odinstalace odstraní aplikaci, ale ve výchozím stavu ne vaše data, která zůstanou ve složce s daty. macOS: ukončete Moony a přetáhněte ho do Koše. Windows: odinstalujte ho v Nastavení → Aplikace. Linux: smažte soubor AppImage nebo odeberte balíček .deb či .rpm správcem balíčků.

Chcete-li odstranit i data, udělejte to před odinstalací: Nastavení → Účet → Smazat data… a napište DELETE. Odstraní se databáze, klíčové soubory a přílohy a nelze to vrátit, takže pokud je možná budete chtít zpět, nejdřív vytvořte zálohu.

Zůstanou složky pre-restore-<čas>, zálohy a exporty, které jste uložili, a logy; smažte je ručně, nebo smažte celou složku s daty. Na žádném serveru není co mazat, protože Moony žádný nemá.

AI asistent (MCP)

Moony může přes malý server zabudovaný v aplikaci poskytovat vaše data AI asistentovi, například Claudovi. Ve výchozím stavu je vypnuto, naslouchá jen na 127.0.0.1 a vyžaduje odemčené Moony a osobní přístupový token. Asistent může vaše data číst a některými nástroji i měnit a zpracovává, co přečte, obvykle v cloudu svého poskytovatele: zapínejte ho jen pro klienty, kterým důvěřujete. K používání Moony ho nepotřebujete.

Zapnete ho v Nastavení → Integrace → AI Asistent (MCP Server). Připojovací příkaz, nastavení klientů a podrobnosti jsou na stránce AI propojení.

Nenašli jste odpověď?

Zeptejte se v diskuzích na GitHubu (EN) nebo u chyby otevřete issue (EN). Nikdy tam nevkládejte zůstatky ani výpisy. Bezpečnostní problémy hlaste podle zásad zabezpečení (EN), ne veřejným issue.