mixing 0.0.2__py3-none-any.whl

mixing/__init__.py

@@ -0,0 +1,5 @@
+"""
+Various video and audio editing utilities.
+"""
+
+from mixing.video import write_subtitles_in_video

mixing/video/__init__.py

@@ -0,0 +1,119 @@
+"""
+Video tools
+
+"""
+
+from typing import Optional
+import moviepy.editor as mp
+from moviepy.editor import TextClip, CompositeVideoClip
+from pathlib import Path
+import os
+
+
+def to_srt_time(seconds):
+    """
+    Convert seconds to SRT time format.
+
+    Example usage:
+
+    >>> to_srt_time(1.5)
+    '00:00:01,500'
+
+    """
+    milliseconds = int((seconds - int(seconds)) * 1000)
+    minutes, seconds = divmod(int(seconds), 60)
+    hours, minutes = divmod(minutes, 60)
+    return f"{hours:02}:{minutes:02}:{seconds:02},{milliseconds:03}"
+
+
+def generate_subtitle_clips(subtitles, video_clip, fontsize=24, color='white'):
+    subtitle_clips = []
+    for subtitle in subtitles.split('\n\n'):
+        lines = subtitle.split('\n')
+        if len(lines) >= 3:
+            time_info = lines[1].split(' --> ')
+            start_time = time_info[0].replace(',', '.')
+            end_time = time_info[1].replace(',', '.')
+            text = ' '.join(lines[2:])
+            txt_clip = TextClip(
+                text,
+                fontsize=fontsize,
+                color=color,
+                size=(video_clip.w, None),
+                method='caption',
+            )
+            txt_clip = (
+                txt_clip.set_start(start_time)
+                .set_end(end_time)
+                .set_position(('center', 'bottom'))
+            )
+            subtitle_clips.append(txt_clip)
+    return subtitle_clips
+
+
+Filepath = str
+
+
+def process_path(path: Filepath) -> Path:
+    return Path(path).expanduser().resolve()
+
+
+def write_subtitles_in_video(
+    video: Filepath, subtitles: Optional[str] = None, output_video: Optional[str] = None
+):
+    """
+    Write subtitles in a video.
+
+    Example usage:
+
+    >>> output_path = write_subtitles_in_video("~/Downloads/some_video.mp4")  # doctest: +SKIP
+
+    Which is syntactic sugar for the more explicit:
+
+    >>> output_path = write_subtitles_in_video(
+    ...     "~/Downloads/some_video.mp4",
+    ...     subtitles="~/Downloads/Ssome_video.srt",
+    ...     output_video="~/Downloads/some_video.mp4"
+    ... )  # doctest: +SKIP
+
+    """
+    video_path = process_path(video)
+
+    srt_content, output_video_path = _process_inputs(
+        subtitles, output_video, video_path
+    )
+
+    # Load the video file
+    video_clip = mp.VideoFileClip(str(video_path))
+
+    # Generate subtitle clips
+    subtitle_clips = generate_subtitle_clips(srt_content, video_clip)
+
+    # Create a composite video with subtitles
+    video_with_subtitles = CompositeVideoClip([video_clip] + subtitle_clips)
+
+    # Export the video with subtitles
+    video_with_subtitles.write_videofile(
+        str(output_video_path), codec="libx264", fps=video_clip.fps
+    )
+
+    return output_video_path
+
+
+def _process_inputs(subtitles, output_video, video_path):
+    if subtitles is None:
+        subtitles_path = video_path.with_suffix('.srt')
+        srt_content = subtitles_path.read_text()
+    elif os.path.isfile(subtitles):
+        subtitles_path = process_path(subtitles)
+        srt_content = subtitles_path.read_text()
+    else:
+        assert isinstance(subtitles, str), "subtitles should be a string"
+        srt_content = subtitles
+
+    if output_video is None:
+        output_video_path = video_path.with_stem(video_path.stem + '_with_subtitles')
+        output_video_path = output_video_path.with_suffix(video_path.suffix)
+    else:
+        output_video_path = Path(output_video)
+    return srt_content, output_video_path

mixing-0.0.2.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [year] [fullname]
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mixing-0.0.2.dist-info/METADATA

@@ -0,0 +1,92 @@
+Metadata-Version: 2.1
+Name: mixing
+Version: 0.0.2
+Summary: Tools for video and audio editing
+Home-page: https://github.com/thorwhalen/mixing
+Author: Thor Whalen
+License: mit
+Platform: any
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: moviepy
+
+
+# mixing
+Tools for video and audio editing
+
+
+To install:	```pip install mixing```
+
+
+# Examples
+
+## mixing.video
+
+### write_subtitles_in_video
+
+
+Write subtitles in a video.
+
+Example usage:
+
+```python
+>>> from mixing import write_subtitles_in_video
+>>> output_path = write_subtitles_in_video("~/Downloads/some_video.mp4") 
+```
+
+Which is syntactic sugar for the more explicit:
+
+```python
+>>> output_path = write_subtitles_in_video(
+...     "~/Downloads/some_video.mp4", 
+...     subtitles="~/Downloads/some_video.srt",
+...     output_video="~/Downloads/some_video.mp4"
+... )  
+```
+
+
+# Further requirements
+
+## FFmpeg
+
+Many of the tools also require `ffmeg`. 
+
+To install FFmpeg on your system, follow the instructions for your operating system below.
+
+### macOS
+
+1. **Using Homebrew:**
+   - Open Terminal.
+   - Run the following command:
+     ```bash
+     brew install ffmpeg
+     ```
+
+For more details, visit the [FFmpeg installation page for macOS](https://ffmpeg.org/download.html#build-mac).
+
+### Linux
+
+1. **Using the package manager:**
+   - For Debian/Ubuntu-based distributions, run:
+     ```bash
+     sudo apt update
+     sudo apt install ffmpeg
+     ```
+   - For Fedora, run:
+     ```bash
+     sudo dnf install ffmpeg
+     ```
+   - For Arch Linux, run:
+     ```bash
+     sudo pacman -S ffmpeg
+     ```
+
+For more details, visit the [FFmpeg installation page for Linux](https://ffmpeg.org/download.html#build-linux).
+
+### Windows
+
+1. **Using Windows builds:**
+   - Download the executable from [FFmpeg for Windows](https://ffmpeg.org/download.html#build-windows).
+   - Extract the downloaded files and add the `bin` directory to your system's PATH.
+
+For more details, visit the [FFmpeg installation page for Windows](https://ffmpeg.org/download.html#build-windows).

mixing-0.0.2.dist-info/RECORD

@@ -0,0 +1,7 @@
+mixing/__init__.py,sha256=iXi4Q--wKi1am8kLSR63yX4a3hYgEok-P2VwBBj1fuU,102
+mixing/video/__init__.py,sha256=J_KHLG6YOUsupvx2K1U0BuKP5UCnqiUOoK8SxXhRrQI,3436
+mixing-0.0.2.dist-info/LICENSE,sha256=ACwmltkrXIz5VsEQcrqljq-fat6ZXAMepjXGoe40KtE,1069
+mixing-0.0.2.dist-info/METADATA,sha256=k-xihxGhsnvKfhZ-atpJJjdgT5wGEnB4ItJ-5i9Mrrk,2045
+mixing-0.0.2.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+mixing-0.0.2.dist-info/top_level.txt,sha256=A-u5KCO6igj85beYBJwz8YHmQLSNCnmC5uaJrUtfzK0,7
+mixing-0.0.2.dist-info/RECORD,,

mixing-0.0.2.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.42.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

mixing-0.0.2.dist-info/top_level.txt

@@ -0,0 +1 @@
+mixing