Repository navigation
Releases: mrkaqz/readscreen
Releases · mrkaqz/readscreen
Release list
ReadScreen v1.6.0
What's New in v1.6.0
GUI — Completely modernized UI
- CustomTkinter replaces tkinter for a modern dark look
- Catppuccin Mocha colour palette throughout
- Bahnschrift Bold font for improved readability
- Segmented buttons (Method / Tool / Locate / tab bar) now show dark text on selected for contrast
- Compact default window width (~310 px) with auto-height snap on launch (DPI-aware)
- 2×2 XY coordinate grid with flush Pick button
- Uniform START / STOP / Save Config / Load Config buttons
- Log and status moved into Data tab only — Setup tab stays clean
- Dynamic value font scaling (Consolas 9–14 pt) as window is resized
CLI
- Version bump to 1.6.0 to match GUI release
Download
| File | Description |
|---|---|
ReadScreen-v1.6.0.zip |
Combined package — includes both main-cli.exe and main-gui.exe sharing one _internal/ folder |
Setup
Extract zip → run main-gui.exe (GUI) or main-cli.exe (console). tess_config.json and tesseract/ are included.
v1.5.0 — DPI Fix, OOR/NaN Validation, Compact GUI
What's New in v1.5.0
Bug Fixes
- DPI scaling fix: Manual XY coordinate capture now works correctly at any Windows display scale (125%, 150%, etc.). All scripts call
SetProcessDpiAwareness(2)at startup so captured coordinates matchImageGrab.grab()physical pixels.
Enhanced Validation
- DEPTH range check: Added 0–100,000 ft/m range validation alongside existing INC/AZI checks
- OOR indicator: Out-of-range values display as
OORin the app (instead of stale last-known-good) - NaN indicator: Unparseable OCR output displays as
NaN - CSV zeroing: Any error writes
0.00to CSV (not last-known-good)
GUI Improvements
- Symmetric data table: DEPTH, INC, AZI columns now equal width via uniform grid layout
- Narrower window: Setup tab restructured into extra rows so window can resize to ~300px wide without overlap
- Window default: 380×350, minimum: 300×290
Downloads
| File | Contents |
|---|---|
ReadScreen-v1.5.0-auto.zip |
CLI version (main-auto.exe) + Tesseract + config |
ReadScreen-v1.5.0-gui.zip |
GUI version (main-gui.exe) + Tesseract + config |
Extract the zip and run the .exe directly — no installation needed.
v1.4.4 - Fix OCR display polarity auto-detection
What's changed
Bug fixes
- Motor crop top: adjusted from 94.8% to 94.9% for more reliable row targeting
- OCR preprocessing - replace method: added avg HSV-V auto-detection; when the cropped area has a bright green background (avg V > 150), a
bitwise_notis applied after the colour mask so the final image is always black text on white background (Tesseract-preferred format) - OCR preprocessing - threshold method: automatically selects
THRESH_BINARYfor bright-background displays andTHRESH_BINARY_INVfor dark-background displays using the same avg-V heuristic
Notes
- Both Motor and RSS confirmed to use bright green background + black text — fix applies correctly to both tool types
- No changes to config file format or crop coordinates for RSS
ReadScreen v1.4
ReadScreen v1.4
What's New
- GUI version added: modern dark-themed tkinter app (Catppuccin Mocha palette)
- Auto window detection via
win32gui— no manual coordinates needed - Three OCR preprocessing methods:
replace,threshold,original - Improved image pipeline: bilateral filter + sharpening before OCR
- Thread-safe design: worker thread ->
queue.Queue-> main thread - Real-time sensor card flash animation on data update
- Excel companion updated to V.0.3.8 — VBA fixes (ScreenUpdating, worksheet caching, Select Case, merged-cell handling)
Files in this release
main-auto.py— CLI version with Rich terminal UImain-gui.py— GUI version (tkinter dark theme)Survey Realtime Track Sheet-Auto V.0.3.8.xlsm— companion Excel sheettess_config.json— OCR configuration template
Notes
Pre-compiled executables are not attached here due to size (~300 MB with Tesseract bundled). Build from source with Nuitka per the README.
Requirements
- Windows 10 / 11
- Python 3.10+ (for running from source)
- Tesseract OCR (local copy via
setup_tesseract.pyor system-wide install)
ReadScreen Version 1.3.2
Read Screen changes logs
Version 1.3.2
- Fix bug when snapshot cannot save. Permission denied.
Excel file changes logs
Version 0.3.6
- Fix bug on DL command does not show on RSSvsMWD page.