talks-reducer 0.5.0__tar.gz → 0.5.2__tar.gz

{talks_reducer-0.5.0/talks_reducer.egg-info → talks_reducer-0.5.2}/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,114 @@
+# Talks Reducer
+Talks Reducer shortens long-form presentations by removing silent gaps and optionally re-encoding them to smaller files. The
+project was renamed from **jumpcutter** to emphasize its focus on conference talks and screencasts.
+
+![Main demo](docs/assets/screencast-main.gif)
+
+## Example
+- 1h 37m, 571 MB — Original OBS video recording
+- 1h 19m, 751 MB — Talks Reducer
+- 1h 19m, 171 MB — Talks Reducer `--small`
+
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md).
+
+## Install GUI (Windows, macOS)
+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`
+
+  > **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
+and passing a video file path (for example via *Open with…* or drag-and-drop
+onto the executable) automatically queues that recording for processing.
+
+## Install CLI (Linux, Windows, macOS)
+```
+pip install talks-reducer
+```
+
+**Note:** FFmpeg is now bundled automatically with the package, so you don't need to install it separately. You you need, don't know actually.
+
+The `--small` preset applies a 720p video scale and 128 kbps audio bitrate, making it useful for sharing talks over constrained
+connections. Without `--small`, the script aims to preserve original quality while removing silence.
+
+Example CLI usage:
+
+```sh
+talks-reducer --small input.mp4
+```
+
+### Speech detection
+
+Talks Reducer now relies on its built-in volume thresholding to detect speech. Adjust `--silent_threshold` if you need to fine-tune when segments count as silence. Dropping the optional Silero VAD integration keeps the install lightweight and avoids pulling in PyTorch.
+
+When CUDA-capable hardware is available the pipeline leans on GPU encoders to keep export times low, but it still runs great on
+CPUs.
+
+## Simple web server
+
+Prefer a lightweight browser interface? Launch the Gradio-powered simple mode with:
+
+```sh
+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.
+
+## License
+Talks Reducer is released under the MIT License. See `LICENSE` for the full text.

{talks_reducer-0.5.0 → talks_reducer-0.5.2}/pyproject.toml

@@ -19,6 +19,7 @@ dependencies = [
     "tqdm>=4.65.0",
     "tkinterdnd2>=0.3.0",
     "Pillow>=9.0.0",
+    "pystray>=0.19.5",
     "imageio-ffmpeg>=0.4.8",
     "gradio>=4.0.0",
 ]
@@ -38,6 +39,7 @@ dev = [
 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"
 
 [tool.setuptools.dynamic]
 version = {attr = "talks_reducer.__about__.__version__"}

{talks_reducer-0.5.0 → talks_reducer-0.5.2}/talks_reducer/__about__.py

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

{talks_reducer-0.5.0 → talks_reducer-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-0.5.0 → talks_reducer-0.5.2}/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-0.5.0 → talks_reducer-0.5.2}/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-0.5.0 → talks_reducer-0.5.2}/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-0.5.0 → talks_reducer-0.5.2}/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-0.5.0 → talks_reducer-0.5.2}/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-0.5.2/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-0.5.2/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 → talks_reducer-0.5.2/talks_reducer.egg-info}/PKG-INFO

@@ -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.0 → talks_reducer-0.5.2}/talks_reducer.egg-info/SOURCES.txt

@@ -13,6 +13,8 @@ talks_reducer/models.py
 talks_reducer/pipeline.py
 talks_reducer/progress.py
 talks_reducer/server.py
+talks_reducer/server_tray.py
+talks_reducer/service_client.py
 talks_reducer.egg-info/PKG-INFO
 talks_reducer.egg-info/SOURCES.txt
 talks_reducer.egg-info/dependency_links.txt
@@ -22,4 +24,5 @@ talks_reducer.egg-info/top_level.txt
 tests/test_audio.py
 tests/test_cli.py
 tests/test_pipeline_service.py
-tests/test_server.py
+tests/test_server.py
+tests/test_service_client.py

{talks_reducer-0.5.0 → talks_reducer-0.5.2}/talks_reducer.egg-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 → talks_reducer-0.5.2}/talks_reducer.egg-info/requires.txt

@@ -4,6 +4,7 @@ numpy>=1.22.0
 tqdm>=4.65.0
 tkinterdnd2>=0.3.0
 Pillow>=9.0.0
+pystray>=0.19.5
 imageio-ffmpeg>=0.4.8
 gradio>=4.0.0
 

talks_reducer-0.5.2/tests/test_service_client.py

@@ -0,0 +1,112 @@
+from types import SimpleNamespace
+
+import pytest
+
+from talks_reducer import service_client
+
+
+class DummyClient:
+    def __init__(self, server_url: str) -> None:
+        self.server_url = server_url
+        self.predictions = []
+
+    def predict(self, *args, **kwargs):  # pragma: no cover - replaced in tests
+        raise NotImplementedError
+
+
+def test_send_video_downloads_file(monkeypatch, tmp_path):
+    input_file = tmp_path / "input.mp4"
+    input_file.write_bytes(b"input")
+    server_file = tmp_path / "server_output.mp4"
+    server_file.write_bytes(b"processed")
+
+    client_instance = DummyClient("http://localhost:9005/")
+
+    def fake_predict(file_arg, small_flag, api_name):
+        assert api_name == "/process_video"
+        assert small_flag is True
+        client_instance.predictions.append((file_arg, small_flag, api_name))
+        return (None, "log", "summary", str(server_file))
+
+    client_instance.predict = fake_predict
+
+    monkeypatch.setattr(service_client, "Client", lambda url: client_instance)
+    monkeypatch.setattr(
+        service_client, "gradio_file", lambda path: SimpleNamespace(path=path)
+    )
+
+    destination, summary, log_text = service_client.send_video(
+        input_path=input_file,
+        output_path=tmp_path / "output.mp4",
+        server_url="http://localhost:9005/",
+        small=True,
+    )
+
+    assert destination == tmp_path / "output.mp4"
+    assert destination.read_bytes() == server_file.read_bytes()
+    assert summary == "summary"
+    assert log_text == "log"
+    assert client_instance.predictions, "predict was not called"
+
+
+def test_send_video_defaults_to_current_directory(monkeypatch, tmp_path, cwd_tmp_path):
+    input_file = tmp_path / "input.mp4"
+    input_file.write_bytes(b"input")
+    server_file = tmp_path / "server_output.mp4"
+    server_file.write_bytes(b"processed")
+
+    client_instance = DummyClient("http://localhost:9005/")
+    client_instance.predict = lambda *_, **__: (
+        None,
+        "log",
+        "summary",
+        str(server_file),
+    )
+
+    monkeypatch.setattr(service_client, "Client", lambda url: client_instance)
+    monkeypatch.setattr(
+        service_client, "gradio_file", lambda path: SimpleNamespace(path=path)
+    )
+
+    destination, _, _ = service_client.send_video(
+        input_path=input_file,
+        output_path=None,
+        server_url="http://localhost:9005/",
+    )
+
+    assert destination.parent == cwd_tmp_path
+    assert destination.name == server_file.name
+    assert destination.read_bytes() == server_file.read_bytes()
+
+
+def test_main_prints_summary(monkeypatch, tmp_path, capsys):
+    input_file = tmp_path / "input.mp4"
+    destination_file = tmp_path / "output.mp4"
+
+    def fake_send_video(**kwargs):
+        assert kwargs["small"] is False
+        return destination_file, "summary", "log"
+
+    monkeypatch.setattr(
+        service_client, "send_video", lambda **kwargs: fake_send_video(**kwargs)
+    )
+
+    service_client.main(
+        [
+            str(input_file),
+            "--server",
+            "http://localhost:9005/",
+            "--output",
+            str(destination_file),
+        ]
+    )
+
+    captured = capsys.readouterr()
+    assert "summary" in captured.out
+    assert str(destination_file) in captured.out
+
+
+@pytest.fixture
+def cwd_tmp_path(monkeypatch, tmp_path):
+    monkeypatch.chdir(tmp_path)
+    return tmp_path

talks_reducer-0.5.0/README.md

@@ -1,66 +0,0 @@
-# Talks Reducer
-Talks Reducer shortens long-form presentations by removing silent gaps and optionally re-encoding them to smaller files. The
-project was renamed from **jumpcutter** to emphasize its focus on conference talks and screencasts.
-
-![Main demo](docs/assets/screencast-main.gif)
-
-## Example
-- 1h 37m, 571 MB — Original OBS video recording
-- 1h 19m, 751 MB — Talks Reducer
-- 1h 19m, 171 MB — Talks Reducer `--small`
-
-## Changelog
-
-See [CHANGELOG.md](CHANGELOG.md).
-
-## Install GUI (Windows, macOS)
-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)
-
-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
-and passing a video file path (for example via *Open with…* or drag-and-drop
-onto the executable) automatically queues that recording for processing.
-
-## Install CLI (Linux, Windows, macOS)
-```
-pip install talks-reducer
-```
-
-**Note:** FFmpeg is now bundled automatically with the package, so you don't need to install it separately. You you need, don't know actually.
-
-The `--small` preset applies a 720p video scale and 128 kbps audio bitrate, making it useful for sharing talks over constrained
-connections. Without `--small`, the script aims to preserve original quality while removing silence.
-
-Example CLI usage:
-
-```sh
-talks-reducer --small input.mp4
-```
-
-### Speech detection
-
-Talks Reducer now relies on its built-in volume thresholding to detect speech. Adjust `--silent_threshold` if you need to fine-tune when segments count as silence. Dropping the optional Silero VAD integration keeps the install lightweight and avoids pulling in PyTorch.
-
-When CUDA-capable hardware is available the pipeline leans on GPU encoders to keep export times low, but it still runs great on
-CPUs.
-
-## Simple web server
-
-Prefer a lightweight browser interface? Launch the Gradio-powered simple mode with:
-
-```sh
-talks-reducer server
-```
-
-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.
-
-## Contributing
-See `CONTRIBUTION.md` for development setup details and guidance on sharing improvements.
-
-## License
-Talks Reducer is released under the MIT License. See `LICENSE` for the full text.