talks-reducer 0.4.1__tar.gz → 0.5.1__tar.gz

talks_reducer-0.5.1/PKG-INFO

@@ -0,0 +1,119 @@
+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.

talks_reducer-0.5.1/README.md

@@ -0,0 +1,92 @@
+# 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.

{talks_reducer-0.4.1 → talks_reducer-0.5.1}/pyproject.toml

@@ -20,6 +20,7 @@ dependencies = [
     "tkinterdnd2>=0.3.0",
     "Pillow>=9.0.0",
     "imageio-ffmpeg>=0.4.8",
+    "gradio>=4.0.0",
 ]
 
 [project.optional-dependencies]
@@ -36,6 +37,7 @@ dev = [
 [project.scripts]
 talks-reducer = "talks_reducer.cli:main"
 talks-reducer-gui = "talks_reducer.gui:main"
+talks-reducer-server = "talks_reducer.server:main"
 
 [tool.setuptools.dynamic]
 version = {attr = "talks_reducer.__about__.__version__"}

{talks_reducer-0.4.1 → talks_reducer-0.5.1}/talks_reducer/__about__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.4.1"
+__version__ = "0.5.1"

{talks_reducer-0.4.1 → talks_reducer-0.5.1}/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(
@@ -63,7 +63,7 @@ def _build_parser() -> argparse.ArgumentParser:
         "--silent_threshold",
         type=float,
         dest="silent_threshold",
-        help="The volume amount that frames' audio needs to surpass to be considered sounded. Defaults to 0.03.",
+        help="The volume amount that frames' audio needs to surpass to be considered sounded. Defaults to 0.05.",
     )
     parser.add_argument(
         "-S",
@@ -143,6 +143,22 @@ def _launch_gui(argv: Sequence[str]) -> bool:
     return bool(gui_main(list(argv)))
 
 
+def _launch_server(argv: Sequence[str]) -> bool:
+    """Attempt to launch the Gradio web server with the provided arguments."""
+
+    try:
+        server_module = import_module(".server", __package__)
+    except ImportError:
+        return False
+
+    server_main = getattr(server_module, "main", None)
+    if server_main is None:
+        return False
+
+    server_main(list(argv))
+    return True
+
+
 def main(argv: Optional[Sequence[str]] = None) -> None:
     """Entry point for the command line interface.
 
@@ -154,6 +170,12 @@ def main(argv: Optional[Sequence[str]] = None) -> None:
     else:
         argv_list = list(argv)
 
+    if argv_list and argv_list[0] in {"server", "serve"}:
+        if not _launch_server(argv_list[1:]):
+            print("Gradio server mode is unavailable.", file=sys.stderr)
+            sys.exit(1)
+        return
+
     if not argv_list:
         if _launch_gui(argv_list):
             return
@@ -200,7 +222,6 @@ def main(argv: Optional[Sequence[str]] = None) -> None:
             option_kwargs["sample_rate"] = int(local_options["sample_rate"])
         if "small" in local_options:
             option_kwargs["small"] = bool(local_options["small"])
-
         options = ProcessingOptions(**option_kwargs)
 
         try:

{talks_reducer-0.4.1 → talks_reducer-0.5.1}/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",
     ]
 
@@ -242,11 +248,29 @@ def run_timed_ffmpeg_command(
             if not line:
                 continue
 
-            sys.stderr.write(line)
-            sys.stderr.flush()
-
-            # Send FFmpeg output to reporter for GUI display
-            progress_reporter.log(line.strip())
+            # Filter out excessive progress output, only show important lines
+            if any(
+                keyword in line.lower()
+                for keyword in [
+                    "error",
+                    "warning",
+                    "encoded successfully",
+                    "frame=",
+                    "time=",
+                    "size=",
+                    "bitrate=",
+                    "speed=",
+                ]
+            ):
+                sys.stderr.write(line)
+                sys.stderr.flush()
+
+            # Send FFmpeg output to reporter for GUI display (filtered)
+            if any(
+                keyword in line.lower()
+                for keyword in ["error", "warning", "encoded successfully", "frame="]
+            ):
+                progress_reporter.log(line.strip())
 
             match = re.search(r"frame=\s*(\d+)", line)
             if match:
@@ -365,7 +389,11 @@ def build_video_commands(
             # Use a fast software encoder instead
             video_encoder_args = ["-c:v libx264", "-preset veryfast", "-crf 23"]
 
-    audio_parts = ["-c:a aac", f'"{output_file}"', "-loglevel info -stats -hide_banner"]
+    audio_parts = [
+        "-c:a aac",
+        f'"{output_file}"',
+        "-loglevel warning -stats -hide_banner",
+    ]
 
     full_command_parts = (
         global_parts + input_parts + output_parts + video_encoder_args + audio_parts