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

talks_reducer/__about__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.5.1"
+__version__ = "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
@@ -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."""
 
@@ -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/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()

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.1.dist-info → talks_reducer-0.5.2.dist-info}/METADATA

@@ -1,119 +1,142 @@
-Metadata-Version: 2.4
-Name: talks-reducer
-Version: 0.5.1
-Summary: CLI for speeding up long-form talks by removing silence
-Author: Talks Reducer Maintainers
-License-Expression: MIT
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: audiotsm>=0.1.2
-Requires-Dist: scipy>=1.10.0
-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: imageio-ffmpeg>=0.4.8
-Requires-Dist: gradio>=4.0.0
-Provides-Extra: dev
-Requires-Dist: build>=1.0.0; extra == "dev"
-Requires-Dist: twine>=4.0.0; extra == "dev"
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: black>=23.0.0; extra == "dev"
-Requires-Dist: isort>=5.12.0; extra == "dev"
-Requires-Dist: bump-my-version>=0.5.0; extra == "dev"
-Requires-Dist: pyinstaller>=6.4.0; extra == "dev"
-Dynamic: license-file
-
-# 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
-```
-
-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. (Optional) Enable **Small video** before the upload finishes to apply the 720p/128 kbps preset.
-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.
+Metadata-Version: 2.4
+Name: talks-reducer
+Version: 0.5.2
+Summary: CLI for speeding up long-form talks by removing silence
+Author: Talks Reducer Maintainers
+License-Expression: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: audiotsm>=0.1.2
+Requires-Dist: scipy>=1.10.0
+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
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: bump-my-version>=0.5.0; extra == "dev"
+Requires-Dist: pyinstaller>=6.4.0; extra == "dev"
+Dynamic: license-file
+
+# 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.1.dist-info → talks_reducer-0.5.2.dist-info}/RECORD

@@ -1,19 +1,20 @@
-talks_reducer/__about__.py,sha256=cD5R3DXad04Jmf7zP4WEetKCHW_dds5YR5hzpqpbLz4,92
+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=1iCzAdImdNg1ezMvGJee5l4hOEkEvrMY6YkwO7pyF5Y,59801
+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=twnuh4QErwjSfa60NICrNXwraIV5x7h0apEVLyz3KVA,11166
+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.1.dist-info/licenses/LICENSE,sha256=jN17mHNR3e84awmH3AbpWBcBDBzPxEH0rcOFoj1s7sQ,1124
-talks_reducer-0.5.1.dist-info/METADATA,sha256=shRuBxoKEvPxZstY2pOu5-vP-45jHkShbE1sC_Am0ig,5218
-talks_reducer-0.5.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-talks_reducer-0.5.1.dist-info/entry_points.txt,sha256=no-NVP5Z9LrzaJL4-2ltKe9IkLZo8dQ32zilIb1gbZE,149
-talks_reducer-0.5.1.dist-info/top_level.txt,sha256=pJWGcy__LR9JIEKH3QJyFmk9XrIsiFtqvuMNxFdIzDU,14
-talks_reducer-0.5.1.dist-info/RECORD,,
+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.1.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