talks-reducer 0.5.0__py3-none-any.whl → 0.5.2__py3-none-any.whl

talks_reducer/__about__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.5.0"
+__version__ = "0.5.2"

talks_reducer/cli.py

@@ -18,7 +18,7 @@ try:
 except Exception:  # pragma: no cover - fallback if metadata file missing
     _about_version = ""
 from .ffmpeg import FFmpegNotFoundError
-from .models import ProcessingOptions
+from .models import ProcessingOptions, default_temp_folder
 from .pipeline import speed_up_video
 from .progress import TqdmProgressReporter
 
@@ -55,7 +55,7 @@ def _build_parser() -> argparse.ArgumentParser:
     parser.add_argument(
         "--temp_folder",
         type=str,
-        default="TEMP",
+        default=str(default_temp_folder()),
         help="The file path of the temporary working folder.",
     )
     parser.add_argument(

talks_reducer/ffmpeg.py

@@ -52,6 +52,9 @@ def find_ffmpeg() -> Optional[str]:
         "C:\\ProgramData\\chocolatey\\bin\\ffmpeg.exe",
         "C:\\Program Files\\ffmpeg\\bin\\ffmpeg.exe",
         "C:\\ffmpeg\\bin\\ffmpeg.exe",
+        "/usr/local/bin/ffmpeg",
+        "/opt/homebrew/bin/ffmpeg",
+        "/usr/bin/ffmpeg",
         "ffmpeg",
     ]
 
@@ -92,6 +95,9 @@ def find_ffprobe() -> Optional[str]:
         "C:\\ProgramData\\chocolatey\\bin\\ffprobe.exe",
         "C:\\Program Files\\ffmpeg\\bin\\ffprobe.exe",
         "C:\\ffmpeg\\bin\\ffprobe.exe",
+        "/usr/local/bin/ffprobe",
+        "/opt/homebrew/bin/ffprobe",
+        "/usr/bin/ffprobe",
         "ffprobe",
     ]
 

talks_reducer/gui.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import argparse
 import json
 import os
 import re
@@ -10,7 +11,7 @@ import sys
 import threading
 from importlib.metadata import version
 from pathlib import Path
-from typing import TYPE_CHECKING, Callable, Iterable, List, Optional, Sequence
+from typing import TYPE_CHECKING, Any, Callable, Iterable, List, Optional, Sequence
 
 if TYPE_CHECKING:
     import tkinter as tk
@@ -20,7 +21,7 @@ try:
     from .cli import gather_input_files
     from .cli import main as cli_main
     from .ffmpeg import FFmpegNotFoundError
-    from .models import ProcessingOptions
+    from .models import ProcessingOptions, default_temp_folder
     from .pipeline import speed_up_video
     from .progress import ProgressHandle, SignalProgressReporter
 except ImportError:  # pragma: no cover - handled at runtime
@@ -34,7 +35,7 @@ except ImportError:  # pragma: no cover - handled at runtime
     from talks_reducer.cli import gather_input_files
     from talks_reducer.cli import main as cli_main
     from talks_reducer.ffmpeg import FFmpegNotFoundError
-    from talks_reducer.models import ProcessingOptions
+    from talks_reducer.models import ProcessingOptions, default_temp_folder
     from talks_reducer.pipeline import speed_up_video
     from talks_reducer.progress import ProgressHandle, SignalProgressReporter
 
@@ -149,6 +150,32 @@ DARK_THEME = {
 }
 
 
+_TRAY_LOCK = threading.Lock()
+_TRAY_PROCESS: Optional[subprocess.Popen[Any]] = None
+
+
+def _ensure_server_tray_running(extra_args: Optional[Sequence[str]] = None) -> None:
+    """Start the server tray in a background process if one is not active."""
+
+    global _TRAY_PROCESS
+
+    with _TRAY_LOCK:
+        if _TRAY_PROCESS is not None and _TRAY_PROCESS.poll() is None:
+            return
+
+        command = [sys.executable, "-m", "talks_reducer.server_tray"]
+        if extra_args:
+            command.extend(extra_args)
+
+        try:
+            _TRAY_PROCESS = subprocess.Popen(command)
+        except Exception as exc:  # pragma: no cover - best-effort fallback
+            _TRAY_PROCESS = None
+            sys.stderr.write(
+                f"Warning: failed to launch Talks Reducer server tray: {exc}\n"
+            )
+
+
 class _GuiProgressHandle(ProgressHandle):
     """Simple progress handle that records totals but only logs milestones."""
 
@@ -480,7 +507,7 @@ class TalksReducerGUI:
             self.advanced_frame, "Output file", self.output_var, row=0, browse=True
         )
 
-        self.temp_var = self.tk.StringVar(value="TEMP")
+        self.temp_var = self.tk.StringVar(value=str(default_temp_folder()))
         self._add_entry(
             self.advanced_frame, "Temp folder", self.temp_var, row=1, browse=True
         )
@@ -1493,6 +1520,17 @@ def main(argv: Optional[Sequence[str]] = None) -> bool:
     if argv is None:
         argv = sys.argv[1:]
 
+    parser = argparse.ArgumentParser(add_help=False)
+    parser.add_argument(
+        "--no-tray",
+        action="store_true",
+        help="Do not start the Talks Reducer server tray alongside the GUI.",
+    )
+
+    parsed_args, remaining = parser.parse_known_args(argv)
+    no_tray = parsed_args.no_tray
+    argv = remaining
+
     if argv:
         launch_gui = False
         if sys.platform == "win32" and not any(arg.startswith("-") for arg in argv):
@@ -1506,6 +1544,8 @@ def main(argv: Optional[Sequence[str]] = None) -> bool:
         if launch_gui:
             try:
                 app = TalksReducerGUI(argv, auto_run=True)
+                if not no_tray:
+                    _ensure_server_tray_running()
                 app.run()
                 return True
             except Exception:
@@ -1567,6 +1607,8 @@ def main(argv: Optional[Sequence[str]] = None) -> bool:
     # Catch and report any errors during GUI initialization
     try:
         app = TalksReducerGUI()
+        if not no_tray:
+            _ensure_server_tray_running()
         app.run()
         return True
     except Exception as e:

talks_reducer/models.py

@@ -2,11 +2,36 @@
 
 from __future__ import annotations
 
-from dataclasses import dataclass
+import os
+import sys
+import tempfile
+from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Optional
 
 
+def default_temp_folder() -> Path:
+    """Return an OS-appropriate default temporary workspace directory."""
+
+    if sys.platform == "darwin":
+        base = Path.home() / "Library" / "Application Support" / "talks-reducer"
+    elif sys.platform == "win32":
+        appdata = os.environ.get("LOCALAPPDATA") or os.environ.get("APPDATA")
+        base = (
+            Path(appdata)
+            if appdata
+            else Path.home() / "AppData" / "Local" / "talks-reducer"
+        )
+    else:
+        xdg_runtime = os.environ.get("XDG_RUNTIME_DIR")
+        if xdg_runtime:
+            base = Path(xdg_runtime) / "talks-reducer"
+        else:
+            base = Path(tempfile.gettempdir()) / "talks-reducer"
+
+    return base / "temp"
+
+
 @dataclass(frozen=True)
 class ProcessingOptions:
     """Configuration values controlling how the talks reducer processes media.
@@ -24,7 +49,7 @@ class ProcessingOptions:
     sounded_speed: float = 1.0
     frame_spreadage: int = 2
     audio_fade_envelope_size: int = 400
-    temp_folder: Path = Path("TEMP")
+    temp_folder: Path = field(default_factory=default_temp_folder)
     small: bool = False
 
 

talks_reducer/pipeline.py

@@ -46,7 +46,7 @@ def _input_to_output_filename(filename: Path, small: bool = False) -> Path:
 
 def _create_path(path: Path) -> None:
     try:
-        path.mkdir()
+        path.mkdir(parents=True, exist_ok=True)
     except OSError as exc:  # pragma: no cover - defensive logging
         raise AssertionError(
             "Creation of the directory failed. (The TEMP folder may already exist. Delete or rename it, and try again.)"

talks_reducer/server.py

@@ -273,8 +273,9 @@ def build_interface() -> gr.Blocks:
         gr.Markdown(
             """
             ## Talks Reducer — Simple Server
-            Drop a video into the zone below or click to browse. Toggle **Small video** to
-            apply the 720p/128k preset before processing starts.
+            Drop a video into the zone below or click to browse. **Small video** is enabled
+            by default to apply the 720p/128k preset before processing starts—clear it to
+            keep the original resolution.
             """.strip()
         )
 
@@ -284,7 +285,7 @@ def build_interface() -> gr.Blocks:
                 file_types=["video"],
                 type="filepath",
             )
-            small_checkbox = gr.Checkbox(label="Small video", value=False)
+            small_checkbox = gr.Checkbox(label="Small video", value=True)
 
         video_output = gr.Video(label="Processed video")
         summary_output = gr.Markdown()
@@ -296,6 +297,7 @@ def build_interface() -> gr.Blocks:
             inputs=[file_input, small_checkbox],
             outputs=[video_output, log_output, summary_output, download_output],
             queue=True,
+            api_name="process_video",
         )
 
     demo.queue(default_concurrency_limit=1)

talks_reducer/server_tray.py

@@ -0,0 +1,417 @@
+"""System tray launcher for the Talks Reducer Gradio server."""
+
+from __future__ import annotations
+
+import argparse
+import atexit
+import logging
+import subprocess
+import sys
+import threading
+import time
+import webbrowser
+from contextlib import suppress
+from importlib import resources
+from pathlib import Path
+from typing import Any, Optional, Sequence
+
+from PIL import Image
+
+from .server import build_interface
+
+try:  # pragma: no cover - import guarded for clearer error message at runtime
+    import pystray
+except ModuleNotFoundError as exc:  # pragma: no cover - handled in ``main``
+    PYSTRAY_IMPORT_ERROR = exc
+    pystray = None  # type: ignore[assignment]
+else:
+    PYSTRAY_IMPORT_ERROR = None
+
+
+LOGGER = logging.getLogger(__name__)
+
+
+def _guess_local_url(host: Optional[str], port: int) -> str:
+    """Return the URL the server is most likely reachable at locally."""
+
+    if host in (None, "", "0.0.0.0", "::"):
+        hostname = "127.0.0.1"
+    else:
+        hostname = host
+    return f"http://{hostname}:{port}/"
+
+
+def _load_icon() -> Image.Image:
+    """Load the tray icon image, falling back to a solid accent square."""
+
+    LOGGER.debug("Attempting to load tray icon image.")
+
+    candidates = [
+        Path(__file__).resolve().parent.parent / "docs" / "assets" / "icon.png",
+        Path(__file__).resolve().parent / "icon.png",
+    ]
+
+    for candidate in candidates:
+        LOGGER.debug("Checking icon candidate at %s", candidate)
+        if candidate.exists():
+            try:
+                image = Image.open(candidate).copy()
+            except Exception as exc:  # pragma: no cover - diagnostic log
+                LOGGER.warning("Failed to load tray icon from %s: %s", candidate, exc)
+            else:
+                LOGGER.debug("Loaded tray icon from %s", candidate)
+                return image
+
+    with suppress(FileNotFoundError):
+        resource_icon = resources.files("talks_reducer") / "assets" / "icon.png"
+        if resource_icon.is_file():
+            LOGGER.debug("Loading tray icon from package resources")
+            with resource_icon.open("rb") as handle:
+                try:
+                    return Image.open(handle).copy()
+                except Exception as exc:  # pragma: no cover - diagnostic log
+                    LOGGER.warning(
+                        "Failed to load tray icon from package resources: %s", exc
+                    )
+
+    LOGGER.warning("Falling back to generated tray icon; packaged image not found")
+    # Fallback to a simple accent-colored square to avoid import errors
+    image = Image.new("RGBA", (64, 64), color=(37, 99, 235, 255))
+    return image
+
+
+class _ServerTrayApplication:
+    """Coordinate the Gradio server lifecycle and the system tray icon."""
+
+    def __init__(
+        self,
+        *,
+        host: Optional[str],
+        port: int,
+        share: bool,
+        open_browser: bool,
+        tray_mode: str,
+    ) -> None:
+        self._host = host
+        self._port = port
+        self._share = share
+        self._open_browser_on_start = open_browser
+        self._tray_mode = tray_mode
+
+        self._stop_event = threading.Event()
+        self._ready_event = threading.Event()
+        self._gui_lock = threading.Lock()
+
+        self._server_handle: Optional[Any] = None
+        self._local_url: Optional[str] = None
+        self._share_url: Optional[str] = None
+        self._icon: Optional[pystray.Icon] = None
+        self._gui_process: Optional[subprocess.Popen[Any]] = None
+
+    # Server lifecycle -------------------------------------------------
+
+    def _launch_server(self) -> None:
+        """Start the Gradio server in the background and record its URLs."""
+
+        LOGGER.info(
+            "Starting Talks Reducer server on host=%s port=%s share=%s",
+            self._host or "127.0.0.1",
+            self._port,
+            self._share,
+        )
+        demo = build_interface()
+        server = demo.launch(
+            server_name=self._host,
+            server_port=self._port,
+            share=self._share,
+            inbrowser=False,
+            prevent_thread_lock=True,
+            show_error=True,
+        )
+
+        self._server_handle = server
+        self._local_url = getattr(
+            server, "local_url", _guess_local_url(self._host, self._port)
+        )
+        self._share_url = getattr(server, "share_url", None)
+        self._ready_event.set()
+        LOGGER.info("Server ready at %s", self._local_url)
+
+        # Keep checking for a share URL while the server is running.
+        while not self._stop_event.is_set():
+            share_url = getattr(server, "share_url", None)
+            if share_url:
+                self._share_url = share_url
+                LOGGER.info("Share URL available: %s", share_url)
+            time.sleep(0.5)
+
+    # Tray helpers -----------------------------------------------------
+
+    def _resolve_url(self) -> Optional[str]:
+        if self._share_url:
+            return self._share_url
+        return self._local_url
+
+    def _handle_open_webui(
+        self,
+        _icon: Optional[pystray.Icon] = None,
+        _item: Optional[pystray.MenuItem] = None,
+    ) -> None:
+        url = self._resolve_url()
+        if url:
+            webbrowser.open(url)
+            LOGGER.debug("Opened browser to %s", url)
+        else:
+            LOGGER.warning("Server URL not yet available; please try again.")
+
+    def _gui_is_running(self) -> bool:
+        """Return whether the GUI subprocess is currently active."""
+
+        process = self._gui_process
+        if process is None:
+            return False
+        if process.poll() is None:
+            return True
+        self._gui_process = None
+        return False
+
+    def _monitor_gui_process(self, process: subprocess.Popen[Any]) -> None:
+        """Reset the GUI handle once the subprocess exits."""
+
+        try:
+            process.wait()
+        except Exception as exc:  # pragma: no cover - best-effort cleanup
+            LOGGER.debug("GUI process monitor exited with %s", exc)
+        finally:
+            with self._gui_lock:
+                if self._gui_process is process:
+                    self._gui_process = None
+            LOGGER.info("Talks Reducer GUI closed")
+
+    def _launch_gui(
+        self,
+        _icon: Optional[pystray.Icon] = None,
+        _item: Optional[pystray.MenuItem] = None,
+    ) -> None:
+        """Launch the Talks Reducer GUI in a background subprocess."""
+
+        with self._gui_lock:
+            if self._gui_is_running():
+                LOGGER.info(
+                    "Talks Reducer GUI already running; focusing existing window"
+                )
+                return
+
+            try:
+                LOGGER.info("Launching Talks Reducer GUI via %s", sys.executable)
+                process = subprocess.Popen(
+                    [sys.executable, "-m", "talks_reducer.gui", "--no-tray"]
+                )
+            except Exception as exc:  # pragma: no cover - platform specific
+                LOGGER.error("Failed to launch Talks Reducer GUI: %s", exc)
+                self._gui_process = None
+                return
+
+            self._gui_process = process
+
+        watcher = threading.Thread(
+            target=self._monitor_gui_process,
+            args=(process,),
+            name="talks-reducer-gui-monitor",
+            daemon=True,
+        )
+        watcher.start()
+
+    def _handle_quit(
+        self,
+        icon: Optional[pystray.Icon] = None,
+        _item: Optional[pystray.MenuItem] = None,
+    ) -> None:
+        self.stop()
+        if icon is not None:
+            icon.stop()
+
+    # Public API -------------------------------------------------------
+
+    def run(self) -> None:
+        """Start the server and block until the tray icon exits."""
+
+        server_thread = threading.Thread(
+            target=self._launch_server, name="talks-reducer-server", daemon=True
+        )
+        server_thread.start()
+
+        if not self._ready_event.wait(timeout=30):
+            raise RuntimeError(
+                "Timed out while waiting for the Talks Reducer server to start."
+            )
+
+        if self._open_browser_on_start:
+            self._handle_open_webui()
+
+        if self._tray_mode == "headless":
+            LOGGER.warning(
+                "Tray icon disabled (tray_mode=headless); press Ctrl+C to stop the server."
+            )
+            try:
+                while not self._stop_event.wait(0.5):
+                    pass
+            finally:
+                self.stop()
+            return
+
+        icon_image = _load_icon()
+        menu = pystray.Menu(
+            pystray.MenuItem(
+                "Open GUI",
+                self._launch_gui,
+                default=True,
+            ),
+            pystray.MenuItem("Open WebUI", self._handle_open_webui),
+            pystray.MenuItem("Quit", self._handle_quit),
+        )
+        self._icon = pystray.Icon(
+            "talks-reducer", icon_image, "Talks Reducer Server", menu=menu
+        )
+
+        if self._tray_mode == "pystray-detached":
+            LOGGER.info("Running tray icon in detached mode")
+            self._icon.run_detached()
+            try:
+                while not self._stop_event.wait(0.5):
+                    pass
+            finally:
+                self.stop()
+            return
+
+        LOGGER.info("Running tray icon in blocking mode")
+        self._icon.run()
+
+    def stop(self) -> None:
+        """Stop the tray icon and shut down the Gradio server."""
+
+        self._stop_event.set()
+
+        if self._icon is not None:
+            with suppress(Exception):
+                self._icon.visible = False
+            with suppress(Exception):
+                self._icon.stop()
+
+        self._stop_gui()
+
+        if self._server_handle is not None:
+            with suppress(Exception):
+                self._server_handle.close()
+            LOGGER.info("Shut down Talks Reducer server")
+
+    def _stop_gui(self) -> None:
+        """Terminate the GUI subprocess if it is still running."""
+
+        with self._gui_lock:
+            process = self._gui_process
+            if process is None:
+                return
+
+            if process.poll() is None:
+                LOGGER.info("Stopping Talks Reducer GUI")
+                try:
+                    process.terminate()
+                    process.wait(timeout=5)
+                except subprocess.TimeoutExpired:
+                    LOGGER.warning(
+                        "GUI process did not exit cleanly; forcing termination"
+                    )
+                    process.kill()
+                    process.wait(timeout=5)
+                except Exception as exc:  # pragma: no cover - defensive cleanup
+                    LOGGER.debug("Error while terminating GUI process: %s", exc)
+
+            self._gui_process = None
+
+
+def main(argv: Optional[Sequence[str]] = None) -> None:
+    """Launch the Gradio server with a companion system tray icon."""
+
+    parser = argparse.ArgumentParser(
+        description="Launch the Talks Reducer server with a system tray icon."
+    )
+    parser.add_argument(
+        "--host", dest="host", default=None, help="Custom host to bind."
+    )
+    parser.add_argument(
+        "--port",
+        dest="port",
+        type=int,
+        default=9005,
+        help="Port number for the web server (default: 9005).",
+    )
+    parser.add_argument(
+        "--share",
+        action="store_true",
+        help="Create a temporary public Gradio link.",
+    )
+    browser_group = parser.add_mutually_exclusive_group()
+    browser_group.add_argument(
+        "--open-browser",
+        dest="open_browser",
+        action="store_true",
+        help="Automatically open the web interface after startup.",
+    )
+    browser_group.add_argument(
+        "--no-browser",
+        dest="open_browser",
+        action="store_false",
+        help="Do not open the web interface automatically (default).",
+    )
+    parser.set_defaults(open_browser=False)
+    parser.add_argument(
+        "--tray-mode",
+        choices=("pystray", "pystray-detached", "headless"),
+        default="pystray",
+        help=(
+            "Select how the tray runs: foreground pystray (default), detached "
+            "pystray worker, or disable the tray entirely."
+        ),
+    )
+    parser.add_argument(
+        "--debug",
+        action="store_true",
+        help="Enable verbose logging for troubleshooting.",
+    )
+
+    args = parser.parse_args(argv)
+
+    logging.basicConfig(
+        level=logging.DEBUG if args.debug else logging.INFO,
+        format="%(asctime)s [%(levelname)s] %(message)s",
+        datefmt="%H:%M:%S",
+    )
+
+    if args.tray_mode != "headless" and PYSTRAY_IMPORT_ERROR is not None:
+        raise RuntimeError(
+            "System tray mode requires the 'pystray' dependency. Install it with "
+            "`pip install pystray` or `pip install talks-reducer[dev]` and try again."
+        ) from PYSTRAY_IMPORT_ERROR
+
+    app = _ServerTrayApplication(
+        host=args.host,
+        port=args.port,
+        share=args.share,
+        open_browser=args.open_browser,
+        tray_mode=args.tray_mode,
+    )
+
+    atexit.register(app.stop)
+
+    try:
+        app.run()
+    except KeyboardInterrupt:  # pragma: no cover - interactive convenience
+        app.stop()
+
+
+__all__ = ["main"]
+
+
+if __name__ == "__main__":  # pragma: no cover - convenience entry point
+    main()

talks_reducer/service_client.py

@@ -0,0 +1,102 @@
+"""Command-line helper for sending videos to the Talks Reducer server."""
+
+from __future__ import annotations
+
+import argparse
+import shutil
+from pathlib import Path
+from typing import Optional, Sequence, Tuple
+
+from gradio_client import Client
+from gradio_client import file as gradio_file
+
+
+def send_video(
+    input_path: Path,
+    output_path: Optional[Path],
+    server_url: str,
+    small: bool = False,
+) -> Tuple[Path, str, str]:
+    """Upload *input_path* to the Gradio server and download the processed video."""
+
+    if not input_path.exists():
+        raise FileNotFoundError(f"Input file does not exist: {input_path}")
+
+    client = Client(server_url)
+    prediction = client.predict(
+        gradio_file(str(input_path)),
+        bool(small),
+        api_name="/process_video",
+    )
+
+    try:
+        _, log_text, summary, download_path = prediction
+    except (TypeError, ValueError) as exc:  # pragma: no cover - defensive
+        raise RuntimeError("Unexpected response from server") from exc
+
+    if not download_path:
+        raise RuntimeError("Server did not return a processed file")
+
+    download_source = Path(str(download_path))
+    if output_path is None:
+        destination = Path.cwd() / download_source.name
+    else:
+        destination = output_path
+        if destination.is_dir():
+            destination = destination / download_source.name
+
+    destination.parent.mkdir(parents=True, exist_ok=True)
+    if download_source.resolve() != destination.resolve():
+        shutil.copy2(download_source, destination)
+
+    return destination, summary, log_text
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        description="Send a video to a running talks-reducer server and download the result.",
+    )
+    parser.add_argument("input", type=Path, help="Path to the video file to upload.")
+    parser.add_argument(
+        "--server",
+        default="http://127.0.0.1:9005/",
+        help="Base URL for the talks-reducer server (default: http://127.0.0.1:9005/).",
+    )
+    parser.add_argument(
+        "--output",
+        type=Path,
+        default=None,
+        help="Where to store the processed video. Defaults to the working directory.",
+    )
+    parser.add_argument(
+        "--small",
+        action="store_true",
+        help="Toggle the 'Small video' preset before processing.",
+    )
+    parser.add_argument(
+        "--print-log",
+        action="store_true",
+        help="Print the server log after processing completes.",
+    )
+    return parser
+
+
+def main(argv: Optional[Sequence[str]] = None) -> None:
+    parser = _build_parser()
+    args = parser.parse_args(argv)
+
+    destination, summary, log_text = send_video(
+        input_path=args.input.expanduser(),
+        output_path=args.output.expanduser() if args.output else None,
+        server_url=args.server,
+        small=args.small,
+    )
+
+    print(summary)
+    print(f"Saved processed video to {destination}")
+    if args.print_log:
+        print("\nServer log:\n" + log_text)
+
+
+if __name__ == "__main__":  # pragma: no cover
+    main()

{talks_reducer-0.5.0.dist-info → talks_reducer-0.5.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: talks-reducer
-Version: 0.5.0
+Version: 0.5.2
 Summary: CLI for speeding up long-form talks by removing silence
 Author: Talks Reducer Maintainers
 License-Expression: MIT
@@ -13,6 +13,7 @@ Requires-Dist: numpy>=1.22.0
 Requires-Dist: tqdm>=4.65.0
 Requires-Dist: tkinterdnd2>=0.3.0
 Requires-Dist: Pillow>=9.0.0
+Requires-Dist: pystray>=0.19.5
 Requires-Dist: imageio-ffmpeg>=0.4.8
 Requires-Dist: gradio>=4.0.0
 Provides-Extra: dev
@@ -44,7 +45,9 @@ See [CHANGELOG.md](CHANGELOG.md).
 Go to the [releases page](https://github.com/popstas/talks-reducer/releases) and download the appropriate artifact:
 
 - **Windows** — `talks-reducer-windows-0.4.0.zip`
-- **macOS** — `talks-reducer.app.zip` (but it doesn't work for me)
+- **macOS** — `talks-reducer.app.zip`
+
+  > **Troubleshooting:** If launching the bundle (or running `python talks_reducer/gui.py`) prints `macOS 26 (2600) or later required, have instead 16 (1600)!`, make sure you're using a Python build that ships a modern Tk. The stock [python.org 3.13.5 installer](https://www.python.org/downloads/release/python-3135/) includes Tk 8.6 and has been verified to work.
 
 When extracted on Windows the bundled `talks-reducer.exe` behaves like the
 `python talks_reducer/gui.py` entry point: double-clicking it launches the GUI
@@ -82,10 +85,56 @@ Prefer a lightweight browser interface? Launch the Gradio-powered simple mode wi
 talks-reducer server
 ```
 
+Want the server to live in your system tray instead of a terminal window? Use:
+
+```sh
+talks-reducer server-tray
+```
+
+Pass `--debug` to print verbose logs about the tray icon lifecycle, and
+`--tray-mode pystray-detached` to try pystray's alternate detached runner. If
+the icon backend refuses to appear, fall back to `--tray-mode headless` to keep
+the web server running without a tray process. The tray menu includes an **Open GUI**
+item (also triggered by double-clicking the icon) that launches the desktop
+Talks Reducer interface alongside an **Open WebUI** entry that opens the Gradio
+page in your browser. Close the GUI window to return to the tray without
+stopping the server. Launching the GUI directly now starts the tray-backed
+server in the background before the window appears so the icon stays available
+after you close it; add `--no-tray` when running `python -m talks_reducer.gui`
+if you prefer to skip the background server entirely. The tray command itself
+never launches the GUI automatically, so use the menu item (or rerun the GUI
+with `--no-tray`) whenever you want to reopen it. The tray no longer opens a
+browser automatically—pass `--open-browser` if you prefer the web page to
+launch as soon as the server is ready.
+
 This opens a local web page featuring a drag-and-drop upload zone, a **Small video** checkbox that mirrors the CLI preset, a live
 progress indicator, and automatic previews of the processed output. Once the job completes you can inspect the resulting compression
 ratio and download the rendered video directly from the page.
 
+### Uploading and retrieving a processed video
+
+1. Open the printed `http://localhost:<port>` address (the default port is `9005`).
+2. Drag a video onto the **Video file** drop zone or click to browse and select one from disk.
+3. **Small video** starts enabled to apply the 720p/128 kbps preset. Clear the box before the upload finishes if you want to keep the original resolution and bitrate.
+4. Wait for the progress bar and log to report completion—the interface queues work automatically after the file arrives.
+5. Watch the processed preview in the **Processed video** player and click **Download processed file** to save the result locally.
+
+Need to change where the server listens? Run `talks-reducer server --host 0.0.0.0 --port 7860` (or any other port) to bind to a
+different address.
+
+### Automating uploads from the command line
+
+Prefer to script uploads instead of using the browser UI? Start the server and use the bundled helper to submit a job and save
+the processed video locally:
+
+```sh
+python -m talks_reducer.service_client --server http://127.0.0.1:9005/ --input demo.mp4 --output output/demo_processed.mp4
+```
+
+The helper wraps the Gradio API exposed by `server.py`, waits for processing to complete, then copies the rendered file to the
+path you provide. Pass `--small` to mirror the **Small video** checkbox or `--print-log` to stream the server log after the
+download finishes.
+
 ## Contributing
 See `CONTRIBUTION.md` for development setup details and guidance on sharing improvements.
 

talks_reducer-0.5.2.dist-info/RECORD

@@ -0,0 +1,20 @@
+talks_reducer/__about__.py,sha256=IrybQ0W3057SlpgRUduOAhBgwbyN7X0mC3g7VQj2SxA,92
+talks_reducer/__init__.py,sha256=Kzh1hXaw6Vq3DyTqrnJGOq8pn0P8lvaDcsg1bFUjFKk,208
+talks_reducer/__main__.py,sha256=azR_vh8HFPLaOnh-L6gUFWsL67I6iHtbeH5rQhsipGY,299
+talks_reducer/audio.py,sha256=sjHMeY0H9ESG-Gn5BX0wFRBX7sXjWwsgS8u9Vb0bJ88,4396
+talks_reducer/chunks.py,sha256=IpdZxRFPURSG5wP-OQ_p09CVP8wcKwIFysV29zOTSWI,2959
+talks_reducer/cli.py,sha256=VOFZni7rl2CTCK3aLUO_iCV6PNva9ylIrmxxwNltQG4,8031
+talks_reducer/ffmpeg.py,sha256=dsHBOBcr5XCSg0q3xmzLOcibBiEdyrXdEQa-ze5vQsM,12551
+talks_reducer/gui.py,sha256=-zBvuPv9T4Z1mZ90QwRZEUUY65mUpWRKCgRZyV5aEPM,61121
+talks_reducer/models.py,sha256=6Q_8rmHLyImXp88D4B7ptTbFaH_xXa_yxs8A2dypz2Y,2004
+talks_reducer/pipeline.py,sha256=JnWa84sMwYncGv7crhGLZu0cW1Xx0eGQyFP-nLp-DHk,12222
+talks_reducer/progress.py,sha256=Mh43M6VWhjjUv9CI22xfD2EJ_7Aq3PCueqefQ9Bd5-o,4565
+talks_reducer/server.py,sha256=Czc1q6N7LJKsq-dBEum21zw31kA1uXBKC8T1-NtiscA,11235
+talks_reducer/server_tray.py,sha256=O8eiu31iWFvP2AROFG1OZ83n0aePtuSZqd7RE6NAqQw,13377
+talks_reducer/service_client.py,sha256=Hv3hKBUn2n7M5hLUVHamNphUdMt9bCXUrJaJMZHlE0Q,3088
+talks_reducer-0.5.2.dist-info/licenses/LICENSE,sha256=jN17mHNR3e84awmH3AbpWBcBDBzPxEH0rcOFoj1s7sQ,1124
+talks_reducer-0.5.2.dist-info/METADATA,sha256=shQxqR1Z6PayVws-5cZ8FAhTeR_1jo7pfpEPFDloN4o,6702
+talks_reducer-0.5.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+talks_reducer-0.5.2.dist-info/entry_points.txt,sha256=X2pjoh2vWBXXExVWorv1mbA1aTEVP3fyuZH4AixqZK4,208
+talks_reducer-0.5.2.dist-info/top_level.txt,sha256=pJWGcy__LR9JIEKH3QJyFmk9XrIsiFtqvuMNxFdIzDU,14
+talks_reducer-0.5.2.dist-info/RECORD,,

{talks_reducer-0.5.0.dist-info → talks_reducer-0.5.2.dist-info}/entry_points.txt

@@ -2,3 +2,4 @@
 talks-reducer = talks_reducer.cli:main
 talks-reducer-gui = talks_reducer.gui:main
 talks-reducer-server = talks_reducer.server:main
+talks-reducer-server-tray = talks_reducer.server_tray:main

talks_reducer-0.5.0.dist-info/RECORD

@@ -1,18 +0,0 @@
-talks_reducer/__about__.py,sha256=RhSau8kONixzPMrozb3d8HJbGwsQmAY3l5_HbL3elh4,92
-talks_reducer/__init__.py,sha256=Kzh1hXaw6Vq3DyTqrnJGOq8pn0P8lvaDcsg1bFUjFKk,208
-talks_reducer/__main__.py,sha256=azR_vh8HFPLaOnh-L6gUFWsL67I6iHtbeH5rQhsipGY,299
-talks_reducer/audio.py,sha256=sjHMeY0H9ESG-Gn5BX0wFRBX7sXjWwsgS8u9Vb0bJ88,4396
-talks_reducer/chunks.py,sha256=IpdZxRFPURSG5wP-OQ_p09CVP8wcKwIFysV29zOTSWI,2959
-talks_reducer/cli.py,sha256=9Lj47GTtvr1feYBrNtQ2aB3r4sLquLODMZk_K_YAIEk,7990
-talks_reducer/ffmpeg.py,sha256=Joqtkq-bktP-Hq3j3I394FYB_VQ-7GyF0n7bqTiknrg,12356
-talks_reducer/gui.py,sha256=6OTUfIMH30XBOFq-BYZmxnODp0HhW3oj7CcTqLdpKyI,59739
-talks_reducer/models.py,sha256=Ax7OIV7WECRROi5km-Se0Z1LQsLxd5J7GnGXDbWrNjg,1197
-talks_reducer/pipeline.py,sha256=kemU_Txoh38jLzJCjy0HvjUS1gtvmVItnxXhlZcdw5Y,12195
-talks_reducer/progress.py,sha256=Mh43M6VWhjjUv9CI22xfD2EJ_7Aq3PCueqefQ9Bd5-o,4565
-talks_reducer/server.py,sha256=r5P7fGfU9SGxwPYDaSsSnEllzwjlombOJ-FF8B5iAZQ,11128
-talks_reducer-0.5.0.dist-info/licenses/LICENSE,sha256=jN17mHNR3e84awmH3AbpWBcBDBzPxEH0rcOFoj1s7sQ,1124
-talks_reducer-0.5.0.dist-info/METADATA,sha256=Rrw6kiDxbQT7q6I0QnbWcNxsJsMLLe0z145f4Zr9kBM,3636
-talks_reducer-0.5.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-talks_reducer-0.5.0.dist-info/entry_points.txt,sha256=no-NVP5Z9LrzaJL4-2ltKe9IkLZo8dQ32zilIb1gbZE,149
-talks_reducer-0.5.0.dist-info/top_level.txt,sha256=pJWGcy__LR9JIEKH3QJyFmk9XrIsiFtqvuMNxFdIzDU,14
-talks_reducer-0.5.0.dist-info/RECORD,,