Skip to content

Configuration Guide

Detailed reference for all Notolog settings.

The Settings window can be moved independently of the main editor window. Select Settings from the main menu or toolbar to bring an open Settings window to the foreground, including when it is minimized.

Table of Contents

Settings Storage

Settings are stored using Qt's QSettings in platform-specific locations:

Platform Location
Linux ~/.config/Notolog/notolog_editor.conf
macOS User preferences managed by Qt's native QSettings backend
Windows Registry: HKEY_CURRENT_USER\Software\Notolog\notolog_editor

Frozen distributions use the separate application name notolog_editor_bin. The exact location depends on Qt and the platform; Settings().get_filename() returns it.


General Tab

The General tab contains app-wide configuration options.

App Config

Setting Key Default Description
Language app_language System locale, falling back to en UI language selection when the locale matches an app language code
Theme app_theme default Visual theme (default, calligraphy, nocturne, noir_dark, spooky, strawberry)
Default folder for notes default_path (empty) Primary directory for notes

Elements Visibility

Setting Key Default Description
Show Main Menu show_main_menu true Display the app's main dropdown menu

Font Size

Setting Key Default Description
Font Size app_font_size 12 Global font size (range: 5-42)

File Deletion

Setting Key Default Description
Delete files reversibly reversible_file_deletion true Move deleted files to Notolog's litter bin by appending a .del extension instead of deleting them permanently

Workspace Tab

The Workspace tab groups settings by where they take effect.

Editor Mode

Setting Key Default Description
Show Line Numbers show_line_numbers true Display line numbers in the editor

View Mode

Setting Key Default Description
Convert Text Emojis to Graphics viewer_process_emojis true Convert text emojis to graphical representations
Highlight TODOs viewer_highlight_todos true Emphasize @todo tags within the text
Require Confirmation to Open Links viewer_open_link_confirmation true Ask for confirmation before opening external links in browser
Auto-save external images to disk viewer_save_resources true Automatically save copies of external images to disk for offline access

Bottom Bar

Setting Key Default Description
Show Navigation Arrows show_navigation_arrows true Show navigation arrows in the bottom bar
Show Global Cursor Position show_global_cursor_position false Display the global cursor position in the bottom bar
Show CPU and memory graphs show_system_load_graphs true Display CPU and memory usage graphs and their separator
Graph refresh interval system_load_interval_ms 1000 ms Set the system-usage sampling interval (250-60000 ms)

Text-to-Speech Tab

Speech settings are independent of the interface language and AI Assistant backend. See the Text-to-Speech guide for runtime installation, compatible models, language choices, and runtime 0.2.0 migration.

Setting Key Default Description
Enable Text-to-Speech tts_enabled Audio dependencies available Enable local speech playback
Speech runtime tts_runtime_path (empty) Path to the compatible nemo-speech executable; otherwise searches PATH
Model folder tts_model_directory App data folder Directory for model downloads
Language tts_language en Document language, selected explicitly
Voice tts_voice Aria Voice within the selected model
Speed tts_speed 1.0 Playback speed multiplier; also changes pitch
Context length tts_context_length 160 Maximum characters per request; 0 selects Whole document, subject to runtime limits
Announce headings tts_announce_headings true Speak heading labels before heading text
Skip inline code tts_skip_inline_code true Speak a code label instead of inline code contents
Skip multiline code tts_skip_multiline_code true Speak a code label instead of fenced or indented code contents

Custom model files stores the speech model (tts_magpie_path), codec (tts_codec_path), and tokenizer directory (tts_tokenizer_directory). Downloading or verifying models fills these fields with the matching files. To use custom models, select a compatible set of all three components.


AI Config Tab

AI Assistant configuration options.

Setting Key Default Description
Active Inference Module ai_config_inference_module openai_api Select from available AI inference modules
Multi-turn dialogue with conversational memory ai_config_multi_turn_dialogue true Enable multi-turn dialogue that retains the previous prompt for conversational memory
Convert the result to Markdown ai_config_convert_to_md false Convert the output message into Markdown format

AI Module Settings

Each AI module has its own settings tab in the Settings dialog.

On-Device LLM (ONNX)

Setting Key Default Description
ONNX Model Location module_ondevice_llm_model_path (empty) Path to ONNX model directory
Temperature module_ondevice_llm_response_temperature 20 Response randomness (0-100, maps to 0.0-1.0)
Maximum Response Tokens module_ondevice_llm_response_max_tokens 0 GenAI sequence-length limit; 0 uses the module default of 4096, subject to model limits
Hardware Acceleration module_ondevice_llm_execution_provider cpu Execution provider (CPU, CUDA, DirectML, etc.)
Prompt History Size module_ondevice_llm_prompt_history_size 0 Number of previous turns to remember

Module llama.cpp (GGUF)

Setting Key Default Description
Model Location module_llama_cpp_model_path (empty) Path to .gguf model file
Context Window Size module_llama_cpp_context_window 2048 Token context size (1-65536)
Chat Formats module_llama_cpp_chat_format chatml Model's chat template: chatml, llama-2, or gemma
System Prompt module_llama_cpp_system_prompt (empty) Initial instructions for the model
Response Temperature module_llama_cpp_response_temperature 20 Response randomness (0-100)
Max Tokens per Response module_llama_cpp_response_max_tokens 0 Maximum response tokens; 0 uses the available context window
Size of the Prompt History module_llama_cpp_prompt_history_size 0 Number of previous turns to remember

OpenAI API

Setting Key Default Description
API URL module_openai_api_url https://api.openai.com/v1/chat/completions API endpoint URL
API Key module_openai_api_key (empty) API key (stored encrypted)
Supported Models module_openai_api_model gpt-5.2 Model name to use
System Prompt module_openai_api_base_system_prompt (empty) Initial instructions for the model
Temperature module_openai_api_base_response_temperature 20 Response randomness (0-100)
Maximum Response Tokens module_openai_api_base_response_max_tokens 0 Maximum response tokens; 0 omits this limit from the request, so the service's limits apply
Prompt History Size module_openai_api_prompt_history_size 0 Number of previous turns to remember

Command Line

Notolog supports the following command-line options:

notolog --version  # Show version information
notolog --help     # Show help message

For AI-specific configuration, see AI Assistant Guide.