Simjot

A personalizable creative wellness and writing studio with a Aero-inspired UI and rich journaling and poetry tools.

Features

Writing tools and mood tracking

• Simjot supports journal entries with mood tracking, rich formatting, images, and customizable templates.

• Additionally, Simjot provides a dedicated poetry editor with real-time syllable counting, rhyme and meter analysis, and form detection powered by native engines (C/C++ and Haskell)

• Mood is set per entry via a Interactive mood slider with visual feedback (0-100 scale)

• In the Mood chart, you can view your mood data with date range filtering (7 days, 30 days, all time)

• Mood data is stored in a custom binary format optimized for most optimal parsing.

Sim assistant (consensus agent)

• Sim is implemented as a trio of consensus agents rather than a single monolithic chatbot found on most other journaling applications.
• Sim, when providing advice, reasons using a three-agent general inteligence system (TAGI) deliberation pipeline (Melchior/Balthasar/Casper) with explicit consensus states:
  • unanimous (all three agree)
  • majority (2-of-3 agreement)
  • conditional (agreement with constraints)
  • deadlock (no stable majority)
  • informational (non-decision response)
• Sim guidance and template generation run asynchronously to keep the Swing UI animation loop responsive.
• Emotion cues from entries are mapped to Sim’s orb model and fed back into guidance visualization.

Organization & management

• Notebook system with different types (Journal, Poetry, and notetaking)
• Smart auto-save functionality with timestamp-based filenames
• Global search and filtering across all content

Security & Backup

• Password Protection: Lock your journal with AES-256 encryption
• Selective Backup: Choose to include mood data, settings, wallpapers
• Backup Verification: Integrity checking and pruning by age
• Easy Restore: Browse and restore from any backup point

Personalization & UI

• Aero-inspired UI with glass panels and smooth animations (can be disabled)
• Themes, backgrounds, and a custom font studio for creating or importing fonts
• Global hotkeys and quick actions for fast capture

Screenshots

Below are a few highlights from the current UI. More images live in Simjot/Simjot/docs/images.

• Main Interface

  

• Journaling Interface

  

• Poetry Workspace

  

• Notebook Manager

  

• Entry Manager

  

• Settings

  

Quick Start

Prerequisites

• Java 24 or higher installed on your system
• JDK 24 or higher for building the project
• Maven 3.8+ for dependency management and building
• CMake 3.20+ and a C/C++ compiler for the native library (recommended)
• GHC/Cabal for the Haskell poetry module (optional)

Installation & Build

Recommended (Native-Enabled)

# From the repository root
./compile-native.sh --release
./run.sh

Using Maven (Core Build)

cd Simjot
mvn clean package

Manual Build

See README_BUILD.md for detailed build instructions including:

• Windows packaging with jpackage
• macOS/Linux builds
• IDE setup

Running the Application

Option 1: Run Script (Recommended)

./run.sh

Option 2: Via Maven

cd Simjot
mvn exec:java -Dexec.mainClass="main.ui.app.JournalApp"

Option 3: JAR File

cd Simjot
java -jar target/Simjot-*.jar

Option 4: Native Executable (after packaging)

• Windows: dist/Simjot/Simjot.exe
• macOS: build/macos-installer/Simjot.app

Usage Guide

First Launch

On first startup, Simjot will prompt you to:

1. Choose a journal folder where all your content will be stored
2. Take an optional tutorial to learn the interface
3. Set up your preferences in the settings panel

Architecture

• Simjot is a modular Java application using Java Platform Module System, it features a Swing-based UI with custom Look & Feel
• CardLayout navigation for smooth panel transitions
• MVC pattern with observer-based UI updates
• Event-driven design with event bus for component communication
• File-based persistence with custom serialization
• Panama FFM integration for native modules (C/C++)
• Haskell FFI for advanced poetry analysis

Sim Architecture (Technical)

• SimBrain: orchestrates context assembly, guidance/template workflows, and provider routing.
• SimEventBus: event-driven contract between core logic and UI (thinking, guidance requested/produced, consensus metadata, emotion tags).
• SimOverlay: real-time visual state machine for heart/orb interaction, including consensus and emotion rendering.
• LLM provider abstraction (SimLLMClient): pluggable backends (ollama, openai, magi).
• MAGI local bridge:
  • Java side: MagiClient launches a local Python process.
  • Python side: sim_magi_bridge.py mediates requests to the embedded MAGI system.
  • Transport: structured JSON over stdin/stdout (local IPC).

Technologies Used

• Java 24 with Project Jigsaw and Panama FFM (preview)
• Java Swing for cross-platform GUI
• Java 2D Graphics for drawing and image processing
• AES-256 encryption for security features
• Native C/C++ libraries for performance-critical operations
• Optional Haskell module for poetry analysis
• Ollama (optional) for Sim AI companion features
• Python 3 MAGI runtime (optional) for local multi-agent consensus deliberation

File Formats

• Journal entries: .note files with metadata and mood data
• Poems: .poem files with title, content, and analysis metadata
• Settings: JSON configuration in user directory
• Backups: Compressed .sjbackup archives with selective content
• Custom fonts: .sjf files created in the Custom Font Studio

Customization

Themes & Appearance

• Multiple background options for different writing modes
• Customizable font sizes and custom fonts for journal entries and notes
• Adjustable mood tracking visualization

Settings Options

• General: Default brush sizes, colors, auto-save intervals
• Appearance: Themes, animations, font scaling, custom fonts
• Security: Password, auto-lock, encryption
• Storage: Backup schedules, destinations, selective includes

License

Simjot is released under the MIT License. You may:

• Use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
• Use for personal or commercial purposes
• Create derivative works

Note: Icon assets are under a separate license requiring attribution to the artist Lightning (@LightningTheAn1).

See LICENSE.md for full terms.

Troubleshooting

Common Issues

• Application won't start: Ensure Java 24+ is installed and in your PATH
• File not found errors: Check that the journal folder path is accessible
• Backup failures: Verify write permissions to backup destination

Debug Mode

Enable debug logging by setting environment variable:

SIMJOT_LOG=debug ./run.sh

---

Happy Journaling!