Console Viewer Documentation (v2.0)

https://docs.yatima.xyz/books/console-viewer/page/console-viewer-documentation

Changelog

Version 2.0 (First Public Release)

Console Viewer 2.0 is the first version released to the public. Earlier 1.x versions were in house builds and were never published.

The defining change in 2.0 is real auto-scroll. The output is now drawn as a proper list widget that owns its own scrollbar and keeps the newest line in view. Earlier internal builds could only approximate this by rendering a short window of messages, or by reversing their order. Both workarounds, and both confusing to use.

• Added: True auto-scroll, with Follow / Start / End controls.
• Added: Configurable panel height (Panel Rows) and display window (Max Displayed Lines).
• Fixed: Blank rows no longer accumulate: print() produces one line, not two.
• Added: While capture is off, the panel offers a direct Open Add-on Preferences button instead of a dead-end message.
• Fixed: The message order toggle was removed. With real auto-scroll it no longer serves any purpose.
• Fixed: Turning capture off no longer destroys sys.stdout, sys.excepthook or warnings.showwarning when another addon hooked them afterwards.
• Fixed: Clear and filter changes repaint the panel immediately.
• Fixed: Corrected a case where the display limit could be exceeded under sustained heavy output.

Development history before the public release (v2.0) is summarised below for reference.

Version 1.5.0 (Internal)

• Fixed: panel failing to refresh once the message buffer was full.
• Added: Cached timestamp formatting and pre-computed line wrapping per message, removing that work from every redraw.
• Added: Centralised message truncation in the buffer, covering in-place updates too.
• Fixed: Lowered the default update interval to 0.15 s for a more responsive panel.
• Added: per-thread guard to the logging handler to prevent recursive capture.
• Added: Converted the legacy addon into a Blender extension.

Version 1.4.0 (Internal)

• Added: Complete thread-safe implementation with proper locking.
• Fixed: Deadlock prevention in UI redraw logic.
• Fixed: Timestamps captured inside lock for chronological order.
• Added: Configurable max display messages (100-2000).
• Added: Configurable UI update interval (0.1-2.0 seconds).
• Added: Memory leak prevention with defensive cleanup.
• Fixed: handler closure chains on reload.

Version 1.3.0 (Internal)

• Added: Enhanced filtering (All, Output, Error, Info, Warning, Exception).
• Added: Tooltips for all controls.
• Fixed: Message truncation for very long messages.
• Added: Blender 4.0 minimum version requirement.

Version 1.2.0 (Internal)

• Added: Python logging module capture.
• Added: Warnings module capture.
• Added: Exception hook capture.
• Added: Progress bar support (carriage return handling).

Version 1.1.0 (Internal)

• Added: Filter buttons with dynamic tooltips.
• Added: Auto-scroll toggle.
• Added: Timestamp display option.
• Added: Display limit implementation.

Version 1.0 (Internal)

• Added: Initial release with core console capture functionality.
• Added: Basic message display and filtering.
• Added: Sidebar panel in Text Editor and 3D Viewport.

Contact and Support

If you encounter issues, have questions, or want to suggest features, there are two ways to reach support:

SuperHive Market

Send a private message through the SuperHive Market platform. This is the preferred method for purchase-related questions, license inquiries, or general support.

Email

For technical support, bug reports, or feature requests:

[email protected]

When Reporting Bugs

Please include the following information to help diagnose issues quickly:

• Your Blender version.
• Your operating system.
• Console Viewer version.
• A description of what you were trying to do.
• What happened instead of the expected result.
• Any error messages from the panel or System Console.
• Steps to reproduce the issue.

Tip: Use Console Viewer's Copy button to export your debug output when reporting issues. This provides valuable context for troubleshooting!