# DOXA

MIT license Go JavaScript Platforms

English | Čeština

--- ## 🌍 DOXA **DOXA** is a collection of six minimalist, locally-focused applications for note management, message encryption, task management, Pomodoro productivity and habit tracking. All projects share a common philosophy: **complete independence, privacy, and control over your data**. No cloud services, no tracking, no external dependencies. Your data belongs only to you. --- ## 📌 Projects in the DOXA Collection ### 1. 📝 [DOXA Notes](doxa-notes/) **Web and desktop application for note management** - **Description**: A minimalist note-taking application built on pure web standards (HTML5, CSS3, Vanilla JavaScript). Allows creating, editing, organizing, and exporting notes in an open JSON format. - **Philosophy**: Local-first, no cloud databases, no tracking. Data is stored in the browser (LocalStorage/IndexedDB) or in local files. - **Technologies**: Vanilla JavaScript (ES6+), HTML5, CSS3, JSON. - **Platforms**: Web (browser), Linux (AppImage). - **Features**: - Tag support for note organization. - Auto-save and manual JSON export/import. - Dark/light mode and system settings. - Drag & drop for reordering notes. 📖 [Read detailed documentation](doxa-notes/README.md) --- ### 2. 💻 [DOXA CLI](doxa-cli/) **Command-line application for note management** - **Description**: A command-line interface (CLI) version of DOXA Notes. Written in Go, it offers a modern Terminal User Interface (TUI) for managing notes directly from the terminal. - **Philosophy**: Same philosophy as DOXA Notes – fully local, no external dependencies, data in JSON format. - **Technologies**: Go (Golang), Bubble Tea (TUI framework). - **Platforms**: Linux, FreeBSD. - **Features**: - Add, view, edit, delete, and search notes. - Export and import notes in JSON format. - Full compatibility with DOXA Notes (shared JSON format). - Tag and filter support. 📖 [Read detailed documentation](doxa-cli/README.md) --- ### 3. 🔐 [DOXA Secret](doxa-secret/) **Tool for encrypting and protecting secret messages** - **Description**: A minimalist tool for encrypting text messages using custom alphabets defined in JSON. Each character is converted into a unique 5-character code. - **Philosophy**: Local encryption, no data sent to servers. Your secrets remain only on your device. - **Technologies**: Go (Golang), Bubble Tea (TUI framework). - **Platforms**: Linux, FreeBSD. - **Features**: - Custom encryption alphabets (JSON format). - Support for multiple ciphers and switching between them. - Automatic diacritic normalization (basic Latin only). - Import and export of encrypted messages (TXT format). - Bilingual interface (Czech/English). ⚠️ **Important**: The application works only with basic Latin characters (no diacritics). Czech diacritics are automatically normalized (e.g., "ž" → "z", "á" → "a"). 📖 [Read detailed documentation](doxa-secret/README.md) --- ### 4. ✅ [DOXA TODO](doxa-todo/) **Terminal-based todo manager for task organization** - **Description**: A minimalist terminal application for managing your tasks with support for categories, priorities, and tags. Built with Go and Bubble Tea TUI framework. - **Philosophy**: Local-first task management. Your todos are stored locally in JSON format, giving you complete control over your data. - **Technologies**: Go (Golang), Bubble Tea (TUI framework), Lip Gloss (styling). - **Platforms**: Linux, FreeBSD. - **Features**: - Dual language support (Czech/English) with `l` key toggle. - Two categories: Personal (🏠) and Work (💼). - Three priority levels: Low (🟢), Medium (🟠), High (🔴). - Tag support for task organization. - Automatic timestamp for creation and modification. - Search and filter by text, tags, or category. - Export individual todos to text files. - Data stored in `~/.doxa-todo/doxa_todo.json`. 📖 [Read detailed documentation](doxa-todo/README.md) --- ### 5. ⏱️ [DOXA Timer](doxa-timer/) **Pomodoro timer for the terminal with productivity statistics** - **Description**: A minimalist Pomodoro timer for the terminal. Helps you focus using the Pomodoro technique — alternating work sessions with short and long breaks. Tracks your daily and total completed Pomodoros. - **Philosophy**: Local-first productivity. No cloud apps, no subscriptions — just clean focus. Data stored in `~/.doxa-timer/`. - **Technologies**: Go (Golang), Bubble Tea (TUI framework), Lip Gloss (styling). - **Platforms**: Linux, FreeBSD. - **Features**: - Pomodoro technique: work session (25 min), short break (5 min), long break (15 min). - Live countdown timer with ASCII progress bar. - Configurable session lengths. - Daily and total Pomodoro statistics. - Bilingual interface (Czech/English) with `l` key toggle. - Data stored in `~/.doxa-timer/doxa_timer.json`. 📖 [Read detailed documentation](doxa-timer/README.md) --- ### 6. 🎯 [DOXA Habit](doxa-habit/) **Habit tracker for the terminal with streak tracking** - **Description**: A minimalist terminal application for building and tracking habits. Monitor your daily and weekly habits, track streaks and visualize progress with ASCII heatmaps. - **Philosophy**: Local-first personal growth. No gamification traps, no notification manipulation — just your data and your progress. Data stored in `~/.doxa-habit/`. - **Technologies**: Go (Golang), Bubble Tea (TUI framework), Lip Gloss (styling). - **Platforms**: Linux, FreeBSD. - **Features**: - Daily and weekly habits with completion tracking. - Streak counter (consecutive days completed). - ASCII heatmap for the last 7 days. - Success rate statistics (7/30 days). - Export data to CSV format. - Search habits by name. - Bilingual interface (Czech/English) with `l` key toggle. - Data stored in `~/.doxa-habit/doxa_habit.json`. 📖 [Read detailed documentation](doxa-habit/README.md) --- ## 🔗 Common Features of All DOXA Projects | Feature | DOXA Notes | DOXA CLI | DOXA Secret | DOXA TODO | DOXA Timer | DOXA Habit | |---------|------------|----------|-------------|-----------|------------|------------| | **Local Data Storage** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | **Open Format (JSON)** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | **No Cloud Dependencies** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | **Open Source (MIT)** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | **Minimalist Design** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | **Bilingual (CZ/EN)** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | **Tag Support** | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | | **Search & Filtering** | ✅ | ✅ | ❌ | ✅ | ❌ | ✅ | | **Encryption** | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | | **Priority Levels** | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | | **Categories** | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | | **Pomodoro Timer** | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | | **Streak / Habit Stats** | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | | **Data Export** | ✅ JSON | ✅ TXT | ✅ TXT | ✅ TXT | ✅ JSON | ✅ CSV | --- ## 🛠 Installation Each project has its own installation process. Detailed guides can be found in the respective README files: - [DOXA Notes – Installation](doxa-notes/03_install.md) - [DOXA CLI – Installation](doxa-cli/README.md#installation) - [DOXA Secret – Installation](doxa-secret/README_EN.md#installation) - [DOXA TODO – Installation](doxa-todo/README.md#installation) - [DOXA Timer – Installation](doxa-timer/README.md#installation) - [DOXA Habit – Installation](doxa-habit/README.md#installation) --- ## 📜 License All projects in the DOXA collection are **open-source** and licensed under the **MIT License**. See the `LICENSE` files in each project for details. --- ## 💡 DOXA Philosophy > "No matter how complex the circumstances around you are, when you build your own temple of ideas, you start from the first stone. This code is your first stone." > — Stoic reference from Kankys DOXA believes in: - **Digital Sovereignty**: Your data belongs to you. - **Minimalism**: Less is more. Clean code, clear mind. - **Local-First**: No cloud dependencies, no tracking. - **Openness**: Open code, open data, open mind. --- ## 📞 Contact and Support - **Author**: Kankys - **Repositories**: - [DOXA on Codeberg](https://codeberg.org/Kankys/doxa) --- --- # 🇨🇿 DOXA (CZ)

English | Čeština

--- ## 🌍 DOXA **DOXA** je sbírka šesti minimalistických, lokálně orientovaných aplikací pro správu poznámek, šifrování zpráv, správu úkolů, Pomodoro produktivitu a sledování návyků. Všechny projekty sdílejí společnou filozofii: **úplná nezávislost, soukromí a kontrola nad vašimi daty**. Žádné cloudové služby, žádné sledování, žádné externí závislosti. Vaše data patří pouze vám. --- ## 📌 Projekty v kolekci DOXA ### 1. 📝 [DOXA Notes](doxa-notes/) **Webová a desktopová aplikace pro správu poznámek** - **Popis**: Minimalistická poznámková aplikace postavená na čistých webových standardech (HTML5, CSS3, Vanilla JavaScript). Umožňuje vytvářet, upravovat, organizovat a exportovat poznámky v otevřeném JSON formátu. - **Filozofie**: Local-first, žádné cloudové databáze, žádné sledování. Data se ukládají v prohlížeči (LocalStorage/IndexedDB) nebo v lokálních souborech. - **Technologie**: Vanilla JavaScript (ES6+), HTML5, CSS3, JSON. - **Platformy**: Web (prohlížeč), Linux (AppImage). - **Vlastnosti**: - Podpora tagů pro organizaci poznámek. - Automatické ukládání (autosave) a manuální export/import JSON. - Tmavý/světlý režim a systémové nastavení. - Drag & drop pro přeskupování poznámek. 📖 [Přečtěte si podrobnější dokumentaci](doxa-notes/README.md) --- ### 2. 💻 [DOXA CLI](doxa-cli/) **Terminálová aplikace pro správu poznámek** - **Popis**: Příkazová řádka (CLI) verze DOXA Notes. Napsána v jazyce Go, nabízí moderní terminálové uživatelské rozhraní (TUI) pro správu poznámek přímo z terminálu. - **Filozofie**: Stejná filozofie jako DOXA Notes – plně lokální, žádné externí závislosti, data v JSON formátu. - **Technologie**: Go (Golang), Bubble Tea (TUI framework). - **Platformy**: Linux, FreeBSD. - **Vlastnosti**: - Přidávání, prohlížení, úprava, mazání a vyhledávání poznámek. - Export a import poznámek v JSON formátu. - Plná kompatibilita s DOXA Notes (sdílený JSON formát). - Podpora tagů a filtrování. 📖 [Přečtěte si podrobnější dokumentaci](doxa-cli/README_CZ.md) --- ### 3. 🔐 [DOXA Secret](doxa-secret/) **Nástroj pro šifrování a ochranu tajných zpráv** - **Popis**: Minimalistický nástroj pro šifrování textových zpráv pomocí vlastních abeced definovaných v JSON. Každý znak je převeden na unikátní 5znakový kód. - **Filozofie**: Lokální šifrování, žádné odesílání dat na servery. Vaše tajemství zůstávají pouze na vašem zařízení. - **Technologie**: Go (Golang), Bubble Tea (TUI framework). - **Platformy**: Linux, FreeBSD. - **Vlastnosti**: - Vlastní šifrovací abecedy (JSON formát). - Podpora více šifer a přepínání mezi nimi. - Automatická normalizace diakritiky (pouze základní latinka). - Import a export šifrovaných zpráv (TXT formát). - Dvoujazyčné rozhraní (česky/anglicky). ⚠️ **Důležité**: Aplikace pracuje pouze se znaky základní latinky (bez diakritiky). Česká diakritika je automaticky normalizována (např. "ž" → "z", "á" → "a"). 📖 [Přečtěte si podrobnější dokumentaci](doxa-secret/README.md) --- ### 4. ✅ [DOXA TODO](doxa-todo/) **Terminálová aplikace pro správu úkolů** - **Popis**: Minimalistická terminálová aplikace pro organizaci úkolů s podporou kategorií, priorit a štítků. Postavená na Go a Bubble Tea TUI frameworku. - **Filozofie**: Lokální správa úkolů. Vaše úkoly jsou uloženy lokálně v JSON formátu, což vám dává úplnou kontrolu nad vašimi daty. - **Technologie**: Go (Golang), Bubble Tea (TUI framework), Lip Gloss (stylování). - **Platformy**: Linux, FreeBSD. - **Vlastnosti**: - Dvoujazyčná podpora (česky/anglicky) s přepínáním klávesou `l`. - Dvě kategorie: Osobní (🏠) a Pracovní (💼). - Tři úrovně priority: Nízká (🟢), Střední (🟠), Vysoká (🔴). - Podpora štítků pro organizaci úkolů. - Automatické časové razítko pro vytvoření a úpravu. - Vyhledávání a filtrace podle textu, štítků nebo kategorie. - Export jednotlivých úkolů do textových souborů. - Data uložena v `~/.doxa-todo/doxa_todo.json`. 📖 [Přečtěte si podrobnější dokumentaci](doxa-todo/README_CZ.md) --- ### 5. ⏱️ [DOXA Timer](doxa-timer/) **Pomodoro timer pro terminál se statistikami produktivity** - **Popis**: Minimalistický Pomodoro timer pro terminál. Pomáhá vám se soustředit pomocí Pomodoro techniky — střídání pracovních sezení s krátkými a dlouhými přestávkami. Sleduje denní a celkový počet dokončených Pomodorů. - **Filozofie**: Lokální produktivita. Žádné cloudové aplikace, žádné předplatné — jen čistý fokus na vaši práci. Data uložena v `~/.doxa-timer/`. - **Technologie**: Go (Golang), Bubble Tea (TUI framework), Lip Gloss (stylování). - **Platformy**: Linux, FreeBSD. - **Vlastnosti**: - Pomodoro technika: pracovní sezení (25 min), krátká přestávka (5 min), dlouhá přestávka (15 min). - Live odpočítávání s ASCII progress barem. - Konfigurovatelné délky sezení. - Denní a celkové statistiky Pomodorů. - Dvoujazyčné rozhraní (česky/anglicky) s přepínáním klávesou `l`. - Data uložena v `~/.doxa-timer/doxa_timer.json`. 📖 [Přečtěte si podrobnější dokumentaci](doxa-timer/README_CZ.md) --- ### 6. 🎯 [DOXA Habit](doxa-habit/) **Tracker návyků pro terminál se sledováním streaku** - **Popis**: Minimalistická terminálová aplikace pro budování a sledování návyků. Sledujte denní a týdenní návyky, streaky a vizualizujte pokrok pomocí ASCII heatmap. - **Filozofie**: Lokální osobní rozvoj. Žádné gamifikační pasti, žádná manipulace s notifikacemi — jen vaše data a váš pokrok. Data uložena v `~/.doxa-habit/`. - **Technologie**: Go (Golang), Bubble Tea (TUI framework), Lip Gloss (stylování). - **Platformy**: Linux, FreeBSD. - **Vlastnosti**: - Denní a týdenní návyky se sledováním splnění. - Streak čítač (po sobě jdoucí dny splnění). - ASCII heatmap posledních 7 dní. - Statistiky úspěšnosti (7/30 dní). - Export dat do CSV formátu. - Vyhledávání návyků dle názvu. - Dvoujazyčné rozhraní (česky/anglicky) s přepínáním klávesou `l`. - Data uložena v `~/.doxa-habit/doxa_habit.json`. 📖 [Přečtěte si podrobnější dokumentaci](doxa-habit/README_CZ.md) --- ## 🔗 Společné vlastnosti všech projektů DOXA | Vlastnost | DOXA Notes | DOXA CLI | DOXA Secret | DOXA TODO | DOXA Timer | DOXA Habit | |-----------|------------|----------|-------------|-----------|------------|------------| | **Lokální uložení dat** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | **Otevřený formát (JSON)** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | **Žádné cloudové závislosti** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | **Open Source (MIT)** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | **Minimalistický design** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | **Dvoujazyčné rozhraní** | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | | **Podpora tagů** | ✅ | ✅ | ❌ | ✅ | ❌ | ❌ | | **Vyhledávání a filtrování** | ✅ | ✅ | ❌ | ✅ | ❌ | ✅ | | **Šifrování** | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | | **Úrovně priority** | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | | **Kategorie** | ❌ | ❌ | ❌ | ✅ | ❌ | ❌ | | **Pomodoro timer** | ❌ | ❌ | ❌ | ❌ | ✅ | ❌ | | **Streak / Statistiky návyků** | ❌ | ❌ | ❌ | ❌ | ❌ | ✅ | | **Export dat** | ✅ JSON | ✅ TXT | ✅ TXT | ✅ TXT | ✅ JSON | ✅ CSV | --- ## 🛠 Instalace Každý projekt má vlastní instalační postup. Podrobné návody naleznete v příslušných README souborech: - [DOXA Notes – Instalace](doxa-notes/03_install.md) - [DOXA CLI – Instalace](doxa-cli/README_CZ.md#instalace) - [DOXA Secret – Instalace](doxa-secret/README.md#instalace) - [DOXA TODO – Instalace](doxa-todo/README_CZ.md#instalace) - [DOXA Timer – Instalace](doxa-timer/README_CZ.md#instalace) - [DOXA Habit – Instalace](doxa-habit/README_CZ.md#instalace) --- ## 📜 Licence Všechny projekty v kolekci DOXA jsou **open-source** a licencovány pod **MIT licencí**. Podrobnosti naleznete v souborech `LICENSE` v jednotlivých projektech. --- ## 💡 Filozofie DOXA > "Nezáleží na tom, jak složité jsou okolnosti kolem tebe. Když stavíš vlastní chrám myšlenek, začínáš od prvního kamene. Tento kód je tvým prvním kamenem." > — Stoický odkaz od Kankyse DOXA věří v: - **Digitální suverenitu**: Vaše data patří vám. - **Minimalismus**: Méně je více. Čistý kód, čistá mysl. - **Lokální první**: Žádné cloudové závislosti, žádné sledování. - **Otevřenost**: Otevřený kód, otevřená data, otevřená mysl. --- ## 📞 Kontakt a podpora - **Autor**: Kankys - **Repozitáře**: - [DOXA na Codeberg](https://codeberg.org/Kankys/doxa)