🧠 NotaMy

NotaMy ist ein hierarchischer, terminalbasierter technischer Notizmanager, der darauf ausgelegt ist, die mentalen Kosten von Kontextwechseln für Personen zu senken, die an langfristigen Analyseaufgaben arbeiten (Pentesting, Reverse Engineering, Wargames).

🎯 Warum NotaMy entwickelt wurde

Als ich mit Pentesting-Aktivitäten und Binäranalyse begann, wurde mir schnell etwas klar:

Das Problem ist nicht das Notieren – es ist die Verwaltung über die Zeit.

Eine Analyse kann Tage oder Monate dauern. In dieser Zeit sammeln sich Speicheradressen, Testausgaben, Disassemblies, verdächtiges Verhalten, fehlgeschlagene Versuche, zu überprüfende Ideen – und all das landet oft verstreut in Dateien und Ordnern.

Das Ergebnis? Verwirrung. Das ständige Suchen nach Informationen in verstreuten Dateien unterbricht den Gedankenfluss und verlangsamt die Untersuchung.

NotaMy wurde entwickelt, um diese Reibung zu beseitigen: die Kosten von Kontextwechseln zu senken, während alle Informationen shell-zugänglich, organisiert und durchsuchbar bleiben.

🧩 Was ist NotaMy

NotaMy ist kein Texteditor. Es ist kein Markdown-System. Es ist keine grafische Anwendung.

Es ist ein minimales, terminalzentriertes System zur Organisation technischen Wissens in Notizdateien (Kontexten) und hierarchischen Baumstrukturen von Knoten/Tags.

⚙️ Hauptfunktionen:

• Mehrere Notizdateien (Kontexte) mit schnellem Kontextwechsel
• Hierarchische Knotenstruktur mit Tags, Kommentaren, erweitertem Text, Schlüsselwörtern und Dateiverweisen
• Strukturierte Suche (nach Tag, Schlüsselwort, Inhalt)
• Vollständig tastaturgesteuerter Workflow
• Konzipiert für lange und komplexe technische Arbeitsabläufe

🗂️ Das Kernkonzept

Jede Notizdatei repräsentiert ein Projekt oder eine Untersuchung. Das Wechseln der Datei bedeutet das Wechseln des mentalen Raums.

Beispiel:

ntm view file

Sie können den Kontext wechseln mit:

ntm setting 2

🌳 Hierarchische Struktur

Notizen sind als Knoten in einem Baum organisiert. Jeder Knoten kann enthalten:

• Tag (Hauptschlüsselwort)
• Kommentar (sichtbare Haftnotiz im Baum)
• Langen Textkörper
• Dateiverweise
• Schlüsselwörter für die Suche

Sie können eine Haftnotiz oder ein ganzes Buch speichern. Alles am selben Ort.

Beispiel:

ntm view note

# zeigt an, dass die Notiz erweiterbaren Text enthält.

Sie können jeden Knoten erweitern, um seinen Inhalt anzuzeigen:

ntm view note -b

🔄 Workflow (Wie ich ihn nutze)

• Ich erstelle oder wähle die Notizdatei (Kontext) aus.
• Ich füge einen Knoten mit Tag und Kommentar hinzu:

ntm add note -t "TAG" -c "Kurzer Kommentar"

• Bei Bedarf schreibe ich einen längeren Text mit dem konfigurierten Editor (standardmäßig vim):

ntm add note -t "TAG" -c "Kommentar" -b

Der Editor öffnet sich, ich speichere und beende, und der Textkörper wird in die Notiz eingefügt.

• Ich verknüpfe Dateien (Exploit, Binary, Konfiguration) direkt mit der Notiz und verwende Schlüsselwörter, um alles schnell abzurufen.

👤 Für wen es gedacht ist

NotaMy ist für diejenigen entwickelt, die:

• im Terminal leben
• an langen und komplexen technischen Aufgaben arbeiten
• mehrere Projekte gleichzeitig verwalten
• Struktur ohne grafische Oberflächen wünschen
• Tastatur bevorzugen statt Maus

🚫 Für wen es NICHT gedacht ist

Es ist wahrscheinlich nichts für Sie, wenn:

• Sie Cloud-Synchronisation wünschen
• Sie Zusammenarbeit mit mehreren Benutzern benötigen
• Sie eine moderne grafische Oberfläche möchten
• Sie Markdown-Dokumente schreiben möchten

NotaMy ist minimalistisch und fokussiert.

📝 Kurze Geschichte

NotaMy entstand aus einem persönlichen Bedürfnis:

Die mentalen Kosten von Kontextwechseln zu senken.

Notizen sind nicht das Problem. Komplexität ist es.

Im Jahr 2020 begann ich mit einer einfachen Version namens „Note Management": einfacher strukturierter Text. Es war bereits nützlich. Dann kamen MemoKeeper und MemoKeeperX, mit separaten Dateien und Tags. Im Laufe der Zeit wurde es Teil meines täglichen Workflows: Pentesting, Lernen, Ideen und kleine Projekte.

NotaMy ist die ausgereifte Version dieses Workflows: minimalistisch, zuverlässig und an meine Arbeitsweise angepasst.

Möchten Sie wissen, warum und wie NotaMy entstanden ist? Lesen Sie die PHILOSOPHIE des Projekts.

🚀 Installation

git clone https://github.com/IMprojtech/NotaMy.git
cd NotaMy
make
./bin/ntm

NotaMy zu Ihrem PATH hinzufügen

Nach dem Kompilieren von ntm möchten Sie es möglicherweise von überall aus ausführen können, ohne den vollständigen Pfad eingeben zu müssen. Hier ist ein gängiger Ansatz:

In einem bereits in Ihrem PATH enthaltenen Verzeichnis installieren

1. Kopieren oder verschieben Sie die kompilierte Binärdatei an einen Standardort, zum Beispiel:

sudo cp ./bin/ntm /usr/local/bin/
sudo cp ./bin/ntm_nc /usr/local/bin/

Oder, wenn Sie eine lokale Installation bevorzugen (ohne sudo):

mkdir -p "$HOME/.local/bin"
cp ./bin/ntm "$HOME/.local/bin/"
cp ./bin/ntm_nc "$HOME/.local/bin/"

Stellen Sie sicher, dass sich dieses Verzeichnis in Ihrem PATH befindet. Die meisten Linux-Distributionen enthalten /usr/local/bin standardmäßig. Wenn Sie ~/.local/bin verwendet haben, stellen Sie sicher, dass Ihre Shell-Initialisierungsdatei es zum PATH hinzufügt. Zum Beispiel in ~/.bashrc oder ~/.zshrc:

# Fügen Sie dies hinzu, falls nicht bereits vorhanden:
export PATH="$HOME/.local/bin:$PATH"

Alternativ können Sie das bin-Verzeichnis direkt zu Ihrer Shell-Initialisierungsdatei hinzufügen:

export PATH="$HOME/pfad/zu/NotaMy/bin:$PATH"

🐚 Optionale Zsh-Integration

NotaMy bietet einen optionalen Zsh-Wrapper, der die Benutzererfahrung verbessert, ohne das C-Kernprogramm zu verändern.

Der Wrapper fügt hinzu:

• Gekapselter ntm-Befehl mit verbesserter Ausgabehandhabung
• Automatische Paginierung über bat
• Korrekte TTY-Erkennung
• fview-Funktion zum interaktiven Notizenbetrachten (fzf + bat)
• nocolor-Funktion zum Entfernen von ANSI-Escape-Sequenzen
• Temporäres Wechseln der Notizdatei über numerisches Präfix

Temporäres Wechseln der Notizdatei

Der Wrapper ermöglicht es, die aktive Datei temporär zu wechseln, indem man ihre Nummer vor den Befehl setzt:

ntm 1 view note

Installation

Fügen Sie die Plugin-Datei zu Ihrer ~/.zshrc hinzu:

source /pfad/zu/NotaMy/shell/zsh/notamy.plugin.zsh

Laden Sie dann Ihre Shell neu:

source ~/.zshrc

⚠️ Die Zsh-Integration ist vollständig optional. Die C-Kernanwendung funktioniert unabhängig.

📘 Dokumentation

Ein vollständiges Benutzerhandbuch ist mit Installationsanweisungen, Nutzungsbeispielen und allen unterstützten Befehlen verfügbar:

📄 Lesen Sie das NotaMy-Handbuch

⚖️ Lizenz

Dieses Programm wird unter den Bedingungen der GNU General Public License (GPL) verbreitet, die die Freiheit zur Weiterverbreitung und Modifikation der Software gemäß den Standards freier Software gewährleistet.

✍️ Autor

Geschrieben von Catoni Mirko (IMprojtech)