# **DOXA secreet**

**DOXA secret** je minimalistický nástroj pro šifrování a ochranu vašich tajných myšlenek z příkazové řádky. Umožňuje převádět zprávy do vlastní abecedy definované v JSON formátu, čímž zajišťuje soukromí bez nutnosti spoléhat se na složité a neznámé systémy. Aplikace je napsána v jazyce Go a nabízí přehledné terminálové uživatelské rozhraní (TUI) postavené na knihovně Bubbletea.

## **Předpoklady**

Před instalací **DOXA secret** se ujistěte, že máte na svém systému nainstalovaný **Go**. Doporučená verze je 1.20 nebo vyšší. Stáhnout Go můžete z oficiálního webu: [https://go.dev/doc/install](https://go.dev/doc/install)

## **Instalace**

Pro instalaci DOXA secreet na váš systém postupujte podle následujících kroků:

> 1. **Naklonujte repozitář:** Získejte nejnovější verzi kódu z Codebergu:  
>    Bash  
>    git clone https://codeberg.org/Kankys/doxa-secret.git  
>    cd doxa-secret \# Přejděte do adresáře projektu

> 2. **Spusťte instalační skript:**  
>    Bash  
>    chmod \+x install.sh  
>    ./install.sh

Instalační skript provede následující:

* Zkontroluje, zda máte nainstalované Go.  
* Stáhne všechny potřebné Go moduly a závislosti projektu (včetně Bubbletea).  
* Zkompiluje aplikaci pro váš operační systém.  
* Nainstaluje spustitelný soubor doxa-secret do adresáře $HOME/.local/bin/.  
* Vytvoří konfigurační adresář ~/.doxa-secret a výchozí soubor s abecedou, pokud neexistují.

**Přidání do PATH (pokud je nutné):**  
Po úspěšné instalaci byste měli být schopni spustit aplikaci odkudkoliv. Pokud příkaz není rozpoznán, přidejte následující řádek do svého shell profilu (např. ~/.bashrc, ~/.zshrc):

Bash  
export PATH=$PATH:$HOME/.local/bin

Po úpravě souboru profilu restartujte terminál nebo jej načtěte příkazem source ~/.bashrc.

## **Úklid po instalaci**

Jakmile je instalace úspěšně dokončena, zdrojové soubory v adresáři projektu již nejsou potřeba. Celou složku s klonovaným repozitářem můžete smazat:

Bash  
rm \-rf doxa-secret

## **Konfigurace abecedy**

Síla DOXA secret spočívá v tom, že si sami definujete vlastní pravidla a šifrovací klíč v souboru alphabet.json uvnitř konfiguračního adresáře ~/.doxa-secreet/. Aplikace se postará o překlad za vás, takže si složité kombinace nemusíte pamatovat.  
Ukázka struktury abecedy:

JSON  
{  
  "version": "1.0",  
  "mappings": {  
    "a": "x9\#m",  
    "b": "k2$p",  
    "ahoj": "z8\*9"  
  }  
}

## **Použití**

Po úspěšné instalaci můžete aplikaci spustit z jakéhokoliv adresáře zadáním:

Bash  
doxa-secret

Pro detailní ovládání v TUI rozhraní se řiďte nápovědou zobrazovanou přímo v aplikaci.

## **Záloha**

Pro zachování vašich šifrovacích klíčů a dat je nutné si uložit obsah konfiguračního adresáře ~/.doxa-secreet (především soubory s definicí abecedy) kamkoliv do vašeho záložního úložiště.

## **Odinstalace**

Pro odinstalaci DOXA secreet postupujte takto:

> 1. **Odstraňte spustitelný soubor:**  
>    Bash  
>    rm ~/.local/bin/doxa-secreet

> 2. **Odstraňte konfigurační adresář (volitelné):**  
>    Bash  
>    rm -rf ~/.doxa-secreet

>    *UPOZORNĚNÍ: Tento krok smaže vaše šifrovací klíče a nastavení.*

## **Licence**

Aplikace je open-source a licencována pod MIT licencí.  
> *"Skrýt tajemství za fasádou běžného zdání je prvním krokem k ochraně vnitřního klidu."*