kankys/doxa
1
0 Fork 0
mirror of https://codeberg.org/Kankys/doxa.git synced 2026-11-11 06:44:36 +01:00
Code Issues Packages Projects Releases Wiki Activity
Files
f19af63d91dc06af8f8489fbec109f7b85460e6c
doxa/README.md
T
kankys f19af63d91 habit+timer
2026-08-16 21:13:50 +02:00

18 KiB
Raw Blame History

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

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

2. 💻 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

3. 🔐 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

4. ✅ 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

5. ⏱️ 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

6. 🎯 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

🔗 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:

📜 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

🇨🇿 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

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

2. 💻 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

3. 🔐 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

4. ✅ 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

5. ⏱️ 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

6. 🎯 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

🔗 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:

📜 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

Reference in new issue View Git Blame Copy Permalink