GameSentenceMiner 2.6.5__py3-none-any.whl → 2.7.1__py3-none-any.whl

GameSentenceMiner/owocr/owocr/run.py

@@ -0,0 +1,1096 @@
+import sys
+import signal
+import time
+import threading
+from pathlib import Path
+
+import fire
+import numpy as np
+import pyperclipfix
+import mss
+import asyncio
+import websockets
+import socketserver
+import queue
+import io
+import re
+
+from PIL import Image, ImageDraw
+from PIL import UnidentifiedImageError
+from loguru import logger
+from pynput import keyboard
+from desktop_notifier import DesktopNotifierSync
+import psutil
+
+import inspect
+from .ocr import *
+from .config import Config
+from .screen_coordinate_picker import get_screen_selection
+from ...configuration import get_temporary_directory
+
+try:
+    import win32gui
+    import win32ui
+    import win32api
+    import win32con
+    import win32process
+    import win32clipboard
+    import pywintypes
+    import ctypes
+except ImportError:
+    pass
+
+try:
+    import objc
+    import platform
+    from AppKit import NSData, NSImage, NSBitmapImageRep, NSDeviceRGBColorSpace, NSGraphicsContext, NSZeroPoint, NSZeroRect, NSCompositingOperationCopy
+    from Quartz import CGWindowListCreateImageFromArray, kCGWindowImageBoundsIgnoreFraming, CGRectMake, CGRectNull, CGMainDisplayID, CGWindowListCopyWindowInfo, \
+                       CGWindowListCreateDescriptionFromArray, kCGWindowListOptionOnScreenOnly, kCGWindowListExcludeDesktopElements, kCGWindowName, kCGNullWindowID, \
+                       CGImageGetWidth, CGImageGetHeight, CGDataProviderCopyData, CGImageGetDataProvider, CGImageGetBytesPerRow
+    from ScreenCaptureKit import SCContentFilter, SCScreenshotManager, SCShareableContent, SCStreamConfiguration, SCCaptureResolutionBest
+except ImportError:
+    pass
+
+
+config = None
+
+
+class WindowsClipboardThread(threading.Thread):
+    def __init__(self):
+        super().__init__(daemon=True)
+        self.last_update = time.time()
+
+    def process_message(self, hwnd: int, msg: int, wparam: int, lparam: int):
+        WM_CLIPBOARDUPDATE = 0x031D
+        timestamp = time.time()
+        if msg == WM_CLIPBOARDUPDATE and timestamp - self.last_update > 1 and not paused:
+            if win32clipboard.IsClipboardFormatAvailable(win32con.CF_BITMAP):
+                clipboard_event.set()
+                self.last_update = timestamp
+        return 0
+
+    def create_window(self):
+        className = 'ClipboardHook'
+        wc = win32gui.WNDCLASS()
+        wc.lpfnWndProc = self.process_message
+        wc.lpszClassName = className
+        wc.hInstance = win32api.GetModuleHandle(None)
+        class_atom = win32gui.RegisterClass(wc)
+        return win32gui.CreateWindow(class_atom, className, 0, 0, 0, 0, 0, 0, 0, wc.hInstance, None)
+
+    def run(self):
+        hwnd = self.create_window()
+        self.thread_id = win32api.GetCurrentThreadId()
+        ctypes.windll.user32.AddClipboardFormatListener(hwnd)
+        win32gui.PumpMessages()
+
+
+class WebsocketServerThread(threading.Thread):
+    def __init__(self, read):
+        super().__init__(daemon=True)
+        self._loop = None
+        self.read = read
+        self.clients = set()
+        self._event = threading.Event()
+
+    @property
+    def loop(self):
+        self._event.wait()
+        return self._loop
+
+    async def send_text_coroutine(self, text):
+        for client in self.clients:
+            await client.send(text)
+
+    async def server_handler(self, websocket):
+        self.clients.add(websocket)
+        try:
+            async for message in websocket:
+                if self.read and not paused:
+                    websocket_queue.put(message)
+                    try:
+                        await websocket.send('True')
+                    except websockets.exceptions.ConnectionClosedOK:
+                        pass
+                else:
+                    try:
+                        await websocket.send('False')
+                    except websockets.exceptions.ConnectionClosedOK:
+                        pass
+        except websockets.exceptions.ConnectionClosedError:
+            pass
+        finally:
+            self.clients.remove(websocket)
+
+    def send_text(self, text):
+        return asyncio.run_coroutine_threadsafe(self.send_text_coroutine(text), self.loop)
+
+    def stop_server(self):
+        self.loop.call_soon_threadsafe(self._stop_event.set)
+
+    def run(self):
+        async def main():
+            self._loop = asyncio.get_running_loop()
+            self._stop_event = stop_event = asyncio.Event()
+            self._event.set()
+            self.server = start_server = websockets.serve(self.server_handler, '0.0.0.0', config.get_general('websocket_port'), max_size=1000000000)
+            async with start_server:
+                await stop_event.wait()
+        asyncio.run(main())
+
+
+class RequestHandler(socketserver.BaseRequestHandler):
+    def handle(self):
+        conn = self.request
+        conn.settimeout(3)
+        data = conn.recv(4)
+        img_size = int.from_bytes(data)
+        img = bytearray()
+        try:
+            while len(img) < img_size:
+                data = conn.recv(4096)
+                if not data:
+                    break
+                img.extend(data)
+        except TimeoutError:
+            pass
+
+        if not paused:
+            unixsocket_queue.put(img)
+            conn.sendall(b'True')
+        else:
+            conn.sendall(b'False')
+
+
+class MacOSWindowTracker(threading.Thread):
+    def __init__(self, window_id):
+        super().__init__(daemon=True)
+        self.stop = False
+        self.window_id = window_id
+        self.window_active = False
+
+    def run(self):
+        found = True
+        while found and not self.stop:
+            found = False
+            is_active = False
+            with objc.autorelease_pool():
+                window_list = CGWindowListCopyWindowInfo(kCGWindowListOptionOnScreenOnly, kCGNullWindowID)
+                for i, window in enumerate(window_list):
+                    if found and window.get(kCGWindowName, '') == 'Fullscreen Backdrop':
+                        is_active = True
+                        break
+                    if self.window_id == window['kCGWindowNumber']:
+                        found = True
+                        if i == 0 or window_list[i-1].get(kCGWindowName, '') in ('Dock', 'Color Enforcer Window'):
+                            is_active = True
+                            break
+                if not found:
+                    window_list = CGWindowListCreateDescriptionFromArray([self.window_id])
+                    if len(window_list) > 0:
+                        found = True
+            if found and self.window_active != is_active:
+                on_window_activated(is_active)
+                self.window_active = is_active
+            time.sleep(0.2)
+        if not found:
+            on_window_closed(False)
+
+
+class WindowsWindowTracker(threading.Thread):
+    def __init__(self, window_handle, only_active):
+        super().__init__(daemon=True)
+        self.stop = False
+        self.window_handle = window_handle
+        self.only_active = only_active
+        self.window_active = False
+        self.window_minimized = False
+
+    def run(self):
+        found = True
+        while not self.stop:
+            found = win32gui.IsWindow(self.window_handle)
+            if not found:
+                break
+            if self.only_active:
+                is_active = self.window_handle == win32gui.GetForegroundWindow()
+                if self.window_active != is_active:
+                    on_window_activated(is_active)
+                    self.window_active = is_active
+            else:
+                is_minimized = win32gui.IsIconic(self.window_handle)
+                if self.window_minimized != is_minimized:
+                    on_window_minimized(is_minimized)
+                    self.window_minimized = is_minimized
+            time.sleep(0.2)
+        if not found:
+            on_window_closed(False)
+
+
+def capture_macos_window_screenshot(window_id):
+    def shareable_content_completion_handler(shareable_content, error):
+        if error:
+            screencapturekit_queue.put(None)
+            return
+
+        target_window = None
+        for window in shareable_content.windows():
+            if window.windowID() == window_id:
+                target_window = window
+                break
+
+        if not target_window:
+            screencapturekit_queue.put(None)
+            return
+
+        with objc.autorelease_pool():
+            content_filter = SCContentFilter.alloc().initWithDesktopIndependentWindow_(target_window)
+
+            frame = content_filter.contentRect()
+            scale = content_filter.pointPixelScale()
+            width = frame.size.width * scale
+            height = frame.size.height * scale
+            configuration = SCStreamConfiguration.alloc().init()
+            configuration.setSourceRect_(CGRectMake(0, 0, frame.size.width, frame.size.height))
+            configuration.setWidth_(width)
+            configuration.setHeight_(height)
+            configuration.setShowsCursor_(False)
+            configuration.setCaptureResolution_(SCCaptureResolutionBest)
+            configuration.setIgnoreGlobalClipSingleWindow_(True)
+
+            SCScreenshotManager.captureImageWithFilter_configuration_completionHandler_(
+                content_filter, configuration, capture_image_completion_handler
+            )
+
+    def capture_image_completion_handler(image, error):
+        if error:
+            screencapturekit_queue.put(None)
+            return
+
+        screencapturekit_queue.put(image)
+
+    SCShareableContent.getShareableContentWithCompletionHandler_(
+        shareable_content_completion_handler
+    )
+
+
+def get_windows_window_handle(window_title):
+    def callback(hwnd, window_title_part):
+        window_title = win32gui.GetWindowText(hwnd)
+        if window_title_part in window_title:
+            handles.append((hwnd, window_title))
+        return True
+
+    handle = win32gui.FindWindow(None, window_title)
+    if handle:
+        return (handle, window_title)
+
+    handles = []
+    win32gui.EnumWindows(callback, window_title)
+    for handle in handles:
+        _, pid = win32process.GetWindowThreadProcessId(handle[0])
+        if psutil.Process(pid).name().lower() not in ('cmd.exe', 'powershell.exe', 'windowsterminal.exe'):
+            return handle
+
+    return (None, None)
+
+
+class TextFiltering:
+    accurate_filtering = False
+
+    def __init__(self):
+        from pysbd import Segmenter
+        self.segmenter = Segmenter(language='ja', clean=True)
+        self.kana_kanji_regex = re.compile(r'[\u3041-\u3096\u30A1-\u30FA\u4E00-\u9FFF]')
+        try:
+            from transformers import pipeline, AutoTokenizer
+            import torch
+
+            model_ckpt = 'papluca/xlm-roberta-base-language-detection'
+            tokenizer = AutoTokenizer.from_pretrained(
+                model_ckpt,
+                use_fast = False
+            )
+
+            if torch.cuda.is_available():
+                device = 0
+            elif torch.backends.mps.is_available():
+                device = 'mps'
+            else:
+                device = -1
+            self.pipe = pipeline('text-classification', model=model_ckpt, tokenizer=tokenizer, device=device)
+            self.accurate_filtering = True
+        except:
+            import langid
+            self.classify = langid.classify
+
+    def __call__(self, text, last_result):
+        orig_text = self.segmenter.segment(text)
+
+        orig_text_filtered = []
+        for block in orig_text:
+            block_filtered = self.kana_kanji_regex.findall(block)
+            if block_filtered:
+                orig_text_filtered.append(''.join(block_filtered))
+            else:
+                orig_text_filtered.append(None)
+
+        if last_result[1] == engine_index:
+            last_text = last_result[0]
+        else:
+            last_text = []
+
+        new_blocks = []
+        for idx, block in enumerate(orig_text):
+            if orig_text_filtered[idx] and (orig_text_filtered[idx] not in last_text):
+                new_blocks.append(block)
+
+        final_blocks = []
+        if self.accurate_filtering:
+            detection_results = self.pipe(new_blocks, top_k=3, truncation=True)
+            for idx, block in enumerate(new_blocks):
+                for result in detection_results[idx]:
+                    if result['label'] == 'ja':
+                        final_blocks.append(block)
+                        break
+        else:
+            for block in new_blocks:
+                if self.classify(block)[0] == 'ja':
+                    final_blocks.append(block)
+
+        text = '\n'.join(final_blocks)
+        return text, orig_text_filtered
+
+
+class AutopauseTimer:
+    def __init__(self, timeout):
+        self.stop_event = threading.Event()
+        self.timeout = timeout
+        self.timer_thread = None
+
+    def start(self):
+        self.stop()
+        self.stop_event.clear()
+        self.timer_thread = threading.Thread(target=self._countdown)
+        self.timer_thread.start()
+
+    def stop(self):
+        if not self.stop_event.is_set() and self.timer_thread and self.timer_thread.is_alive():
+            self.stop_event.set()
+            self.timer_thread.join()
+
+    def _countdown(self):
+        seconds = self.timeout
+        while seconds > 0 and not self.stop_event.is_set():
+            time.sleep(1)
+            seconds -= 1
+        if not self.stop_event.is_set():
+            self.stop_event.set()
+            if not paused:
+                pause_handler(True)
+
+
+def pause_handler(is_combo=True):
+    global paused
+    global just_unpaused
+    if paused:
+        message = 'Unpaused!'
+        just_unpaused = True
+    else:
+        message = 'Paused!'
+
+    if auto_pause_handler:
+        auto_pause_handler.stop()
+
+    if is_combo:
+        notifier.send(title='owocr', message=message)
+    logger.info(message)
+    paused = not paused
+
+
+def engine_change_handler(user_input='s', is_combo=True):
+    global engine_index
+    old_engine_index = engine_index
+
+    if user_input.lower() == 's':
+        if engine_index == len(engine_keys) - 1:
+            engine_index = 0
+        else:
+            engine_index += 1
+    elif user_input.lower() != '' and user_input.lower() in engine_keys:
+        engine_index = engine_keys.index(user_input.lower())
+
+    if engine_index != old_engine_index:
+        new_engine_name = engine_instances[engine_index].readable_name
+        if is_combo:
+            notifier.send(title='owocr', message=f'Switched to {new_engine_name}')
+        engine_color = config.get_general('engine_color')
+        logger.opt(ansi=True).info(f'Switched to <{engine_color}>{new_engine_name}</{engine_color}>!')
+
+
+def user_input_thread_run():
+    def _terminate_handler():
+        global terminated
+        logger.info('Terminated!')
+        terminated = True
+
+    if sys.platform == 'win32':
+        import msvcrt
+        while not terminated:
+            user_input_bytes = msvcrt.getch()
+            try:
+                user_input = user_input_bytes.decode()
+                if user_input.lower() in 'tq':
+                    _terminate_handler()
+                elif user_input.lower() == 'p':
+                    pause_handler(False)
+                else:
+                    engine_change_handler(user_input, False)
+            except UnicodeDecodeError:
+                pass
+    else:
+        import tty, termios
+        fd = sys.stdin.fileno()
+        old_settings = termios.tcgetattr(fd)
+        try:
+            tty.setcbreak(sys.stdin.fileno())
+            while not terminated:
+                user_input = sys.stdin.read(1)
+                if user_input.lower() in 'tq':
+                    _terminate_handler()
+                elif user_input.lower() == 'p':
+                    pause_handler(False)
+                else:
+                    engine_change_handler(user_input, False)
+        finally:
+            termios.tcsetattr(fd, termios.TCSADRAIN, old_settings)
+
+
+def on_screenshot_combo():
+    if not paused:
+        screenshot_event.set()
+
+def on_screenshot_bus():
+    if not paused:
+        screenshot_event.set()
+
+
+def signal_handler(sig, frame):
+    global terminated
+    logger.info('Terminated!')
+    terminated = True
+
+
+def on_window_closed(alive):
+    global terminated
+    if not (alive or terminated):
+        logger.info('Window closed or error occurred, terminated!')
+        terminated = True
+
+
+def on_window_activated(active):
+    global screencapture_window_active
+    screencapture_window_active = active
+
+
+def on_window_minimized(minimized):
+    global screencapture_window_visible
+    screencapture_window_visible = not minimized
+
+
+def normalize_macos_clipboard(img):
+    ns_data = NSData.dataWithBytes_length_(img, len(img))
+    ns_image = NSImage.alloc().initWithData_(ns_data)
+
+    new_image = NSBitmapImageRep.alloc().initWithBitmapDataPlanes_pixelsWide_pixelsHigh_bitsPerSample_samplesPerPixel_hasAlpha_isPlanar_colorSpaceName_bytesPerRow_bitsPerPixel_(
+        None,  # Set to None to create a new bitmap
+        int(ns_image.size().width),
+        int(ns_image.size().height),
+        8,  # Bits per sample
+        4,  # Samples per pixel (R, G, B, A)
+        True,  # Has alpha
+        False,  # Is not planar
+        NSDeviceRGBColorSpace,
+        0,  # Automatically compute bytes per row
+        32  # Bits per pixel (8 bits per sample * 4 samples per pixel)
+    )
+
+    context = NSGraphicsContext.graphicsContextWithBitmapImageRep_(new_image)
+    NSGraphicsContext.setCurrentContext_(context)
+
+    ns_image.drawAtPoint_fromRect_operation_fraction_(
+        NSZeroPoint,
+        NSZeroRect,
+        NSCompositingOperationCopy,
+        1.0
+    )
+
+    return new_image.TIFFRepresentation()
+
+
+def are_images_identical(img1, img2):
+    if None in (img1, img2):
+        return img1 == img2
+
+    img1 = np.array(img1)
+    img2 = np.array(img2)
+
+    return (img1.shape == img2.shape) and (img1 == img2).all()
+
+
+def process_and_write_results(img_or_path, write_to, notifications, last_result, filtering, engine=None, rectangle=None):
+    global engine_index
+    if auto_pause_handler:
+        auto_pause_handler.stop()
+    if engine:
+        for i, instance in enumerate(engine_instances):
+            if instance.name.lower() in engine.lower():
+                engine_instance = instance
+                last_result = (last_result[0], i)
+                break
+    else:
+        engine_instance = engine_instances[engine_index]
+
+    t0 = time.time()
+    res, text = engine_instance(img_or_path)
+    t1 = time.time()
+
+    orig_text = []
+    engine_color = config.get_general('engine_color')
+    if res:
+        if filtering:
+            text, orig_text = filtering(text, last_result)
+        text = post_process(text)
+        logger.opt(ansi=True).info(f'Text recognized in {t1 - t0:0.03f}s using <{engine_color}>{engine_instance.readable_name}</{engine_color}>: {text}')
+        if notifications:
+            notifier.send(title='owocr', message='Text recognized: ' + text)
+
+        if write_to == 'websocket':
+            websocket_server_thread.send_text(text)
+        elif write_to == 'clipboard':
+            pyperclipfix.copy(text)
+        elif write_to == "callback":
+            txt_callback(text, rectangle)
+        elif write_to:
+            with Path(write_to).open('a', encoding='utf-8') as f:
+                f.write(text + '\n')
+
+        if auto_pause_handler and not paused:
+            auto_pause_handler.start()
+    else:
+        logger.opt(ansi=True).info(f'<{engine_color}>{engine_instance.readable_name}</{engine_color}> reported an error after {t1 - t0:0.03f}s: {text}')
+
+    return orig_text, text
+
+
+def get_path_key(path):
+    return path, path.lstat().st_mtime
+
+
+def init_config(parse_args=True):
+    global config
+    config = Config(parse_args)
+
+
+def run(read_from=None,
+        write_to=None,
+        engine=None,
+        pause_at_startup=None,
+        ignore_flag=None,
+        delete_images=None,
+        notifications=None,
+        auto_pause=None,
+        combo_pause=None,
+        combo_engine_switch=None,
+        screen_capture_area=None,
+        screen_capture_exclusions=None,
+        screen_capture_window=None,
+        screen_capture_delay_secs=None,
+        screen_capture_only_active_windows=None,
+        screen_capture_combo=None,
+        stop_running_flag=None,
+        screen_capture_event_bus=None,
+        rectangle=None,
+        text_callback=None,
+        ):
+    """
+    Japanese OCR client
+
+    Runs OCR in the background.
+    It can read images copied to the system clipboard or placed in a directory, images sent via a websocket or a Unix domain socket, or directly capture a screen (or a portion of it) or a window.
+    Recognized texts can be either saved to system clipboard, appended to a text file or sent via a websocket.
+
+    :param read_from: Specifies where to read input images from. Can be either "clipboard", "websocket", "unixsocket" (on macOS/Linux), "screencapture", or a path to a directory.
+    :param write_to: Specifies where to save recognized texts to. Can be either "clipboard", "websocket", or a path to a text file.
+    :param delay_secs: How often to check for new images, in seconds.
+    :param engine: OCR engine to use. Available: "mangaocr", "glens", "glensweb", "bing", "gvision", "avision", "alivetext", "azure", "winrtocr", "oneocr", "easyocr", "rapidocr", "ocrspace".
+    :param pause_at_startup: Pause at startup.
+    :param ignore_flag: Process flagged clipboard images (images that are copied to the clipboard with the *ocr_ignore* string).
+    :param delete_images: Delete image files after processing when reading from a directory.
+    :param notifications: Show an operating system notification with the detected text.
+    :param auto_pause: Automatically pause the program after the specified amount of seconds since the last successful text recognition. Will be ignored when reading with screen capture. 0 to disable.
+    :param combo_pause: Specifies a combo to wait on for pausing the program. As an example: "<ctrl>+<shift>+p". The list of keys can be found here: https://pynput.readthedocs.io/en/latest/keyboard.html#pynput.keyboard.Key
+    :param combo_engine_switch: Specifies a combo to wait on for switching the OCR engine. As an example: "<ctrl>+<shift>+a". To be used with combo_pause. The list of keys can be found here: https://pynput.readthedocs.io/en/latest/keyboard.html#pynput.keyboard.Key
+    :param screen_capture_area: Specifies area to target when reading with screen capture. Can be either empty (automatic selector), a set of coordinates (x,y,width,height), "screen_N" (captures a whole screen, where N is the screen number starting from 1) or a window name (the first matching window title will be used).
+    :param screen_capture_delay_secs: Specifies the delay (in seconds) between screenshots when reading with screen capture.
+    :param screen_capture_only_active_windows: When reading with screen capture and screen_capture_area is a window name, specifies whether to only target the window while it's active.
+    :param screen_capture_combo: When reading with screen capture, specifies a combo to wait on for taking a screenshot instead of using the delay. As an example: "<ctrl>+<shift>+s". The list of keys can be found here: https://pynput.readthedocs.io/en/latest/keyboard.html#pynput.keyboard.Key
+    """
+
+    logger.configure(handlers=[{'sink': sys.stderr, 'format': config.get_general('logger_format')}])
+
+    if config.has_config:
+        logger.info('Parsed config file')
+    else:
+        logger.warning('No config file, defaults will be used.')
+        if config.downloaded_config:
+            logger.info(f'A default config file has been downloaded to {config.config_path}')
+
+    global engine_instances
+    global engine_keys
+    engine_instances = []
+    config_engines = []
+    engine_keys = []
+    default_engine = ''
+
+    if len(config.get_general('engines')) > 0:
+        for config_engine in config.get_general('engines').split(','):
+            config_engines.append(config_engine.strip().lower())
+
+    for _,engine_class in sorted(inspect.getmembers(sys.modules[__name__], lambda x: hasattr(x, '__module__') and x.__module__ and __package__ + '.ocr' in x.__module__ and inspect.isclass(x))):
+        if len(config_engines) == 0 or engine_class.name in config_engines:
+            if config.get_engine(engine_class.name) == None:
+                engine_instance = engine_class()
+            else:
+                engine_instance = engine_class(config.get_engine(engine_class.name))
+
+            if engine_instance.available:
+                engine_instances.append(engine_instance)
+                engine_keys.append(engine_class.key)
+                if engine == engine_class.name:
+                    default_engine = engine_class.key
+
+    if len(engine_keys) == 0:
+        msg = 'No engines available!'
+        raise NotImplementedError(msg)
+
+    global engine_index
+    global terminated
+    global paused
+    global just_unpaused
+    global first_pressed
+    global notifier
+    global auto_pause_handler
+    terminated = False
+    paused = pause_at_startup
+    just_unpaused = True
+    first_pressed = None
+    auto_pause_handler = None
+    engine_index = engine_keys.index(default_engine) if default_engine != '' else 0
+    engine_color = config.get_general('engine_color')
+    prefix_to_use = ""
+    delay_secs = config.get_general('delay_secs')
+    screen_capture_on_combo = False
+    notifier = DesktopNotifierSync()
+    key_combos = {}
+
+    if read_from != 'screencapture' and auto_pause != 0:
+        auto_pause_handler = AutopauseTimer(auto_pause)
+
+    if combo_pause:
+        key_combos[combo_pause] = pause_handler
+    if combo_engine_switch:
+        if combo_pause:
+            key_combos[combo_engine_switch] = engine_change_handler
+        else:
+            raise ValueError('combo_pause must also be specified')
+
+    if read_from == 'websocket' or write_to == 'websocket':
+        global websocket_server_thread
+        websocket_server_thread = WebsocketServerThread(read_from == 'websocket')
+        websocket_server_thread.start()
+
+    if write_to == "callback" and text_callback:
+        global txt_callback
+        txt_callback = text_callback
+
+    if read_from == 'websocket':
+        global websocket_queue
+        websocket_queue = queue.Queue()
+        read_from_readable = 'websocket'
+    elif read_from == 'unixsocket':
+        if sys.platform == 'win32':
+            raise ValueError('"unixsocket" is not currently supported on Windows')
+
+        global unixsocket_queue
+        unixsocket_queue = queue.Queue()
+        socket_path = Path('/tmp/owocr.sock')
+        if socket_path.exists():
+            socket_path.unlink()
+        unix_socket_server = socketserver.ThreadingUnixStreamServer(str(socket_path), RequestHandler)
+        unix_socket_server_thread = threading.Thread(target=unix_socket_server.serve_forever, daemon=True)
+        unix_socket_server_thread.start()
+        read_from_readable = 'unix socket'
+    elif read_from == 'clipboard':
+        macos_clipboard_polling = False
+        windows_clipboard_polling = False
+        img = None
+
+        if sys.platform == 'darwin':
+            from AppKit import NSPasteboard, NSPasteboardTypeTIFF, NSPasteboardTypeString
+            pasteboard = NSPasteboard.generalPasteboard()
+            count = pasteboard.changeCount()
+            macos_clipboard_polling = True
+        elif sys.platform == 'win32':
+            global clipboard_event
+            clipboard_event = threading.Event()
+            windows_clipboard_thread = WindowsClipboardThread()
+            windows_clipboard_thread.start()
+            windows_clipboard_polling = True
+        else:
+            from PIL import ImageGrab
+
+        read_from_readable = 'clipboard'
+    elif read_from == 'screencapture':
+        if screen_capture_combo:
+            screen_capture_on_combo = True
+            global screenshot_event
+            screenshot_event = threading.Event()
+            key_combos[screen_capture_combo] = on_screenshot_combo
+        if screen_capture_event_bus:
+            screen_capture_on_combo = True
+            screenshot_event = threading.Event()
+            screen_capture_event_bus = on_screenshot_bus
+        if type(screen_capture_area) == tuple:
+            screen_capture_area = ','.join(map(str, screen_capture_area))
+        global screencapture_window_active
+        global screencapture_window_visible
+        screencapture_mode = None
+        screencapture_window_active = True
+        screencapture_window_visible = True
+        last_result = ([], engine_index)
+        if screen_capture_area == '':
+            screencapture_mode = 0
+        elif screen_capture_area.startswith('screen_'):
+            parts = screen_capture_area.split('_')
+            if len(parts) != 2 or not parts[1].isdigit():
+                raise ValueError('Invalid screen_capture_area')
+            screen_capture_monitor = int(parts[1])
+            screencapture_mode = 1
+        elif len(screen_capture_area.split(',')) == 4:
+            screencapture_mode = 3
+        else:
+            screencapture_mode = 2
+            screen_capture_window = screen_capture_area
+
+        if screencapture_mode != 2:
+            sct = mss.mss()
+
+            if screencapture_mode == 1:
+                mon = sct.monitors
+                if len(mon) <= screen_capture_monitor:
+                    raise ValueError('Invalid monitor number in screen_capture_area')
+                coord_left = mon[screen_capture_monitor]['left']
+                coord_top = mon[screen_capture_monitor]['top']
+                coord_width = mon[screen_capture_monitor]['width']
+                coord_height = mon[screen_capture_monitor]['height']
+            elif screencapture_mode == 3:
+                coord_left, coord_top, coord_width, coord_height = [int(c.strip()) for c in screen_capture_area.split(',')]
+            else:
+                logger.opt(ansi=True).info('Launching screen coordinate picker')
+                screen_selection = get_screen_selection()
+                if not screen_selection:
+                    raise ValueError('Picker window was closed or an error occurred')
+                screen_capture_monitor = screen_selection['monitor']
+                x, y, coord_width, coord_height = screen_selection['coordinates']
+                if coord_width > 0 and coord_height > 0:
+                    coord_top = screen_capture_monitor['top'] + y
+                    coord_left = screen_capture_monitor['left'] + x
+                else:
+                    logger.opt(ansi=True).info('Selection is empty, selecting whole screen')
+                    coord_left = screen_capture_monitor['left']
+                    coord_top = screen_capture_monitor['top']
+                    coord_width = screen_capture_monitor['width']
+                    coord_height = screen_capture_monitor['height']
+
+            sct_params = {'top': coord_top, 'left': coord_left, 'width': coord_width, 'height': coord_height}
+            logger.opt(ansi=True).info(f'Selected coordinates: {coord_left},{coord_top},{coord_width},{coord_height}')
+        if screencapture_mode == 2 or screen_capture_window:
+            area_invalid_error = '"screen_capture_area" must be empty, "screen_N" where N is a screen number starting from 1, a valid set of coordinates, or a valid window name'
+            if sys.platform == 'darwin':
+                if int(platform.mac_ver()[0].split('.')[0]) < 14:
+                    old_macos_screenshot_api = True
+                else:
+                    global screencapturekit_queue
+                    screencapturekit_queue = queue.Queue()
+                    CGMainDisplayID()
+                    old_macos_screenshot_api = False
+
+                window_list = CGWindowListCopyWindowInfo(kCGWindowListExcludeDesktopElements, kCGNullWindowID)
+                window_titles = []
+                window_ids = []
+                window_index = None
+                for i, window in enumerate(window_list):
+                    window_title = window.get(kCGWindowName, '')
+                    if psutil.Process(window['kCGWindowOwnerPID']).name() not in ('Terminal', 'iTerm2'):
+                        window_titles.append(window_title)
+                        window_ids.append(window['kCGWindowNumber'])
+
+                if screen_capture_area in window_titles:
+                    window_index = window_titles.index(screen_capture_window)
+                else:
+                    for t in window_titles:
+                        if screen_capture_area in t:
+                            window_index = window_titles.index(t)
+                            break
+
+                if not window_index:
+                    raise ValueError(area_invalid_error)
+
+                window_id = window_ids[window_index]
+                window_title = window_titles[window_index]
+
+                if screen_capture_only_active_windows:
+                    screencapture_window_active = False
+                    macos_window_tracker = MacOSWindowTracker(window_id)
+                    macos_window_tracker.start()
+                logger.opt(ansi=True).info(f'Selected window: {window_title}')
+            elif sys.platform == 'win32':
+                window_handle, window_title = get_windows_window_handle(screen_capture_window)
+
+                if not window_handle:
+                    raise ValueError(area_invalid_error)
+
+                ctypes.windll.shcore.SetProcessDpiAwareness(1)
+
+                if screen_capture_only_active_windows:
+                    screencapture_window_active = False
+                windows_window_tracker = WindowsWindowTracker(window_handle, screen_capture_only_active_windows)
+                windows_window_tracker.start()
+                logger.opt(ansi=True).info(f'Selected window: {window_title}')
+            else:
+                raise ValueError('Window capture is only currently supported on Windows and macOS')
+
+        filtering = TextFiltering()
+        read_from_readable = 'screen capture'
+    else:
+        read_from = Path(read_from)
+        if not read_from.is_dir():
+            raise ValueError('read_from must be either "websocket", "unixsocket", "clipboard", "screencapture", or a path to a directory')
+
+        allowed_extensions = ('.png', '.jpg', '.jpeg', '.bmp', '.gif', '.webp')
+        old_paths = set()
+        for path in read_from.iterdir():
+            if path.suffix.lower() in allowed_extensions:
+                old_paths.add(get_path_key(path))
+
+        read_from_readable = f'directory {read_from}'
+
+    if len(key_combos) > 0:
+        key_combo_listener = keyboard.GlobalHotKeys(key_combos)
+        key_combo_listener.start()
+
+    if write_to in ('clipboard', 'websocket', 'callback'):
+        write_to_readable = write_to
+    else:
+        if Path(write_to).suffix.lower() != '.txt':
+            raise ValueError('write_to must be either "websocket", "clipboard" or a path to a text file')
+        write_to_readable = f'file {write_to}'
+
+    # signal.signal(signal.SIGINT, signal_handler)
+    user_input_thread = threading.Thread(target=user_input_thread_run, daemon=True)
+    user_input_thread.start()
+    logger.opt(ansi=True).info(f"Reading from {read_from_readable}, writing to {write_to_readable} using <{engine_color}>{engine_instances[engine_index].readable_name}</{engine_color}>{' (paused)' if paused else ''}")
+
+    while not terminated and not stop_running_flag:
+        if read_from == 'websocket':
+            while True:
+                try:
+                    item = websocket_queue.get(timeout=delay_secs)
+                except queue.Empty:
+                    break
+                else:
+                    if not paused:
+                        img = Image.open(io.BytesIO(item))
+                        process_and_write_results(img, write_to, notifications, None, None)
+        elif read_from == 'unixsocket':
+            while True:
+                try:
+                    item = unixsocket_queue.get(timeout=delay_secs)
+                except queue.Empty:
+                    break
+                else:
+                    if not paused:
+                        img = Image.open(io.BytesIO(item))
+                        process_and_write_results(img, write_to, notifications, None, None)
+        elif read_from == 'clipboard':
+            process_clipboard = False
+            if windows_clipboard_polling:
+                if clipboard_event.wait(delay_secs):
+                    clipboard_event.clear()
+                    while True:
+                        try:
+                            win32clipboard.OpenClipboard()
+                            break
+                        except pywintypes.error:
+                            pass
+                        time.sleep(0.1)
+                    if win32clipboard.IsClipboardFormatAvailable(win32clipboard.CF_DIB):
+                        clipboard_text = ''
+                        if win32clipboard.IsClipboardFormatAvailable(win32clipboard.CF_UNICODETEXT):
+                            clipboard_text = win32clipboard.GetClipboardData(win32clipboard.CF_UNICODETEXT)
+                        if ignore_flag or clipboard_text != '*ocr_ignore*':
+                            img = Image.open(io.BytesIO(win32clipboard.GetClipboardData(win32clipboard.CF_DIB)))
+                            process_clipboard = True
+                    win32clipboard.CloseClipboard()
+            elif macos_clipboard_polling:
+                if not paused:
+                    with objc.autorelease_pool():
+                        old_count = count
+                        count = pasteboard.changeCount()
+                        if not just_unpaused and count != old_count and NSPasteboardTypeTIFF in pasteboard.types():
+                            clipboard_text = ''
+                            if NSPasteboardTypeString in pasteboard.types():
+                                clipboard_text = pasteboard.stringForType_(NSPasteboardTypeString)
+                            if ignore_flag or clipboard_text != '*ocr_ignore*':
+                                img = normalize_macos_clipboard(pasteboard.dataForType_(NSPasteboardTypeTIFF))
+                                img = Image.open(io.BytesIO(img))
+                                process_clipboard = True
+            else:
+                if not paused:
+                    old_img = img
+                    try:
+                        img = ImageGrab.grabclipboard()
+                    except Exception:
+                        pass
+                    else:
+                        if ((not just_unpaused) and isinstance(img, Image.Image) and \
+                            (ignore_flag or pyperclipfix.paste() != '*ocr_ignore*') and \
+                            (not are_images_identical(img, old_img))):
+                            process_clipboard = True
+
+            if process_clipboard:
+                process_and_write_results(img, write_to, notifications, None, None)
+
+            just_unpaused = False
+
+            if not windows_clipboard_polling:
+                time.sleep(delay_secs)
+        elif read_from == 'screencapture':
+            if screen_capture_on_combo:
+                take_screenshot = screenshot_event.wait(delay_secs)
+                if take_screenshot:
+                    screenshot_event.clear()
+            else:
+                take_screenshot = screencapture_window_active and not paused
+
+            if take_screenshot and screencapture_window_visible:
+                if screencapture_mode == 2:
+                    if sys.platform == 'darwin':
+                        with objc.autorelease_pool():
+                            if old_macos_screenshot_api:
+                                cg_image = CGWindowListCreateImageFromArray(CGRectNull, [window_id], kCGWindowImageBoundsIgnoreFraming)
+                            else:
+                                capture_macos_window_screenshot(window_id)
+                                try:
+                                    cg_image = screencapturekit_queue.get(timeout=0.5)
+                                except queue.Empty:
+                                    cg_image = None
+                            if not cg_image:
+                                on_window_closed(False)
+                                break
+                            width = CGImageGetWidth(cg_image)
+                            height = CGImageGetHeight(cg_image)
+                            raw_data = CGDataProviderCopyData(CGImageGetDataProvider(cg_image))
+                            bpr = CGImageGetBytesPerRow(cg_image)
+                        img = Image.frombuffer('RGBA', (width, height), raw_data, 'raw', 'BGRA', bpr, 1)
+                    else:
+                        try:
+                            coord_left, coord_top, right, bottom = win32gui.GetWindowRect(window_handle)
+                            coord_width = right - coord_left
+                            coord_height = bottom - coord_top
+
+                            hwnd_dc = win32gui.GetWindowDC(window_handle)
+                            mfc_dc = win32ui.CreateDCFromHandle(hwnd_dc)
+                            save_dc = mfc_dc.CreateCompatibleDC()
+
+                            save_bitmap = win32ui.CreateBitmap()
+                            save_bitmap.CreateCompatibleBitmap(mfc_dc, coord_width, coord_height)
+                            save_dc.SelectObject(save_bitmap)
+
+                            result = ctypes.windll.user32.PrintWindow(window_handle, save_dc.GetSafeHdc(), 2)
+
+                            bmpinfo = save_bitmap.GetInfo()
+                            bmpstr = save_bitmap.GetBitmapBits(True)
+                        except pywintypes.error:
+                            on_window_closed(False)
+                            break
+                        img = Image.frombuffer('RGB', (bmpinfo['bmWidth'], bmpinfo['bmHeight']), bmpstr, 'raw', 'BGRX', 0, 1)
+
+                        win32gui.DeleteObject(save_bitmap.GetHandle())
+                        save_dc.DeleteDC()
+                        mfc_dc.DeleteDC()
+                        win32gui.ReleaseDC(window_handle, hwnd_dc)
+                else:
+                    sct_img = sct.grab(sct_params)
+                    img = Image.frombytes('RGB', sct_img.size, sct_img.bgra, 'raw', 'BGRX')
+                # img.save(os.path.join(get_temporary_directory(), 'screencapture_before.png'), 'png')
+                if screen_capture_exclusions:
+                    img = img.convert("RGBA")
+                    draw = ImageDraw.Draw(img)
+                    for exclusion in screen_capture_exclusions:
+                        left, top, right, bottom = exclusion
+                        draw.rectangle((left, top, right, bottom), fill=(0, 0, 0, 0))
+                        # draw.rectangle((left, top, right, bottom), fill=(0, 0, 0))
+                # img.save(os.path.join(get_temporary_directory(), 'screencapture.png'), 'png')
+                res, _ = process_and_write_results(img, write_to, notifications, last_result, filtering, rectangle=rectangle)
+                if res:
+                    last_result = (res, engine_index)
+                delay = screen_capture_delay_secs
+            else:
+                delay = delay_secs
+
+            if not screen_capture_on_combo and delay:
+                time.sleep(delay)
+        else:
+            for path in read_from.iterdir():
+                if path.suffix.lower() in allowed_extensions:
+                    path_key = get_path_key(path)
+                    if path_key not in old_paths:
+                        old_paths.add(path_key)
+
+                        if not paused:
+                            try:
+                                img = Image.open(path)
+                                img.load()
+                            except (UnidentifiedImageError, OSError) as e:
+                                logger.warning(f'Error while reading file {path}: {e}')
+                            else:
+                                process_and_write_results(img, write_to, notifications, None, None)
+                                img.close()
+                                if delete_images:
+                                    Path.unlink(path)
+
+            time.sleep(delay_secs)
+
+    if read_from == 'websocket' or write_to == 'websocket':
+        websocket_server_thread.stop_server()
+        websocket_server_thread.join()
+    if read_from == 'clipboard' and windows_clipboard_polling:
+        win32api.PostThreadMessage(windows_clipboard_thread.thread_id, win32con.WM_QUIT, 0, 0)
+        windows_clipboard_thread.join()
+    elif read_from == 'screencapture' and screencapture_mode == 2:
+        if sys.platform == 'darwin':
+            if screen_capture_only_active_windows:
+                macos_window_tracker.stop = True
+                macos_window_tracker.join()
+        else:
+            windows_window_tracker.stop = True
+            windows_window_tracker.join()
+    elif read_from == 'unixsocket':
+        unix_socket_server.shutdown()
+        unix_socket_server_thread.join()
+    if len(key_combos) > 0:
+        key_combo_listener.stop()
+    if auto_pause_handler:
+        auto_pause_handler.stop()