📂 Kodi Log Monitor

🚀 A fast, lightweight real-time log viewer for Kodi - built for users and developers.

Quickly monitor, filter, and analyze Kodi logs with a clean and responsive interface.

---

✨ Features

• Real-Time Log Monitoring - Instantly view new log entries
• Advanced Filtering - Filter by level (Info, Warning, Error, Debug), keywords, or quickly exclude log lines
• Dynamic Search - Fast search, even on very large log files
• Visual Timeline - Navigate log history instantly using a vertical timeline with a colored overview
• Large Log Support - Optimized for high-volume logs with smart limits
• Color-Coded UI - Quickly identify issues at a glance
• UI Customization - Customize message type colors for each theme
• Log Upload (paste.kodi.tv) - Share logs in one click (Ctrl + P)
• System Summary - Instantly view Kodi/system info
• Keyboard Shortcuts - Full control without leaving the keyboard
• Multi-Instance Support - Optional single-instance lock
• Responsive UI - Works seamlessly from HD to 4K
• Light & Dark Themes - Comfortable for long sessions
• Localization - Multi-language support with auto-detection
• Robust Network Handling - Stable with remote logs and reconnections

---

📸 Screenshots

 

---

🎯 Why use Kodi Log Monitor?

Kodi logs can be large, noisy, and hard to read.
This tool helps you:

• Understand what's happening in real time
• Quickly spot errors and warnings
• Focus only on relevant information
• Debug issues faster

---

⚡ Quick Start

👉 Download (recommended)

1. Go to the Releases section
2. Download the latest version
3. Run - no installation required

---

⌨️ Shortcuts

Press F1 anytime to view all shortcuts.

Space        : Pause / Resume auto-scroll  
Ctrl + O     : Open log file  
Ctrl + S     : Export log
Ctrl + P     : Upload log  
Ctrl + F     : Search keywords
Ctrl + N     : Open exclusions  
Ctrl + G     : Clear console  
Ctrl + L     : Toggle word wrap  
Ctrl + T     : Unlimited mode (∞) / 1000 lines  
Ctrl + A     : Select all
M            : Open context menu in the log
S            : Show system summary (also accessible via F1)  
A            : Show Info, Warn, Error, Debug  
I, W, E, D   : Filter Info, Warn, Error or Debug  
Ctrl + R     : Reset all filters  

---

🌐 Log Upload

Upload logs instantly to paste.kodi.tv using Ctrl + P or the UPLOAD button.
The log is copied to your clipboard and the website opens automatically.

---

🔍 Keyword Lists

• Create .txt files with keywords
• Highlight and filter matching log lines
• Easily manage via the UI

👉 Examples available here.

---

🛠️ Run from Source

git clone https://github.com/Nanomani/KodiLogMonitor.git
cd KodiLogMonitor/src
python main.py

---

📝 Project Structure

src/
│
├── main.py                 # Entry point
├── config.py               # Configuration
├── languages.py            # Localization
├── utils.py                # Utilities
│  
├── ui/                     # User Interface Package  
│   ├── __init__.py         # Package initialization
│   ├── app.py              # Main Class
│   ├── ui_builder.py       # UI Construction
│   ├── actions.py          # User Interactions
│   ├── log_display.py      # Log Rendering
│   ├── monitor.py          # Threaded Monitoring
│   ├── session.py          # Persistence
│   └── timeline.py         # Timeline Strip  
│  
└── assets/                 # Graphics Resources  
    ├── logo.ico            # Windows application icon.  
    ├── logo.png            # Generic image asset.  
    └── logo.icns           # macOS application icon.