yt-dlp-host-api 0.1.2__py3-none-any.whl → 0.1.3__py3-none-any.whl

yt_dlp_host_api/client.py

@@ -9,21 +9,23 @@ class Client:
         self.headers = {"X-API-Key": api_key, "Content-Type": "application/json"}
         self.send_task = self.SendTask(self)
 
-    def get_video(self, url, video_format="bestvideo", audio_format="bestaudio", start_time=None, end_time=None):
+    def get_video(self, url, video_format="bestvideo", audio_format="bestaudio", start_time=None, end_time=None, force_keyframes=False):
         return self.send_task.get_video(
             url=url, 
             video_format=video_format, 
             audio_format=audio_format,
             start_time=start_time,
-            end_time=end_time
+            end_time=end_time,
+            force_keyframes=force_keyframes
         ).get_result()
     
-    def get_audio(self, url, audio_format="bestaudio", start_time=None, end_time=None):
+    def get_audio(self, url, audio_format="bestaudio", start_time=None, end_time=None, force_keyframes=False):
         return self.send_task.get_audio(
             url=url, 
             audio_format=audio_format,
             start_time=start_time,
-            end_time=end_time
+            end_time=end_time,
+            force_keyframes=force_keyframes
         ).get_result()
     
     def get_live_video(self, url, duration, start=0, video_format="bestvideo", audio_format="bestaudio"):
@@ -84,8 +86,8 @@ class Client:
         def __init__(self, client):
             self.client = client
 
-        def get_video(self, url, video_format="bestvideo", audio_format="bestaudio", start_time=None, end_time=None):
-            data = {"url": url, "video_format": video_format, "audio_format": audio_format}
+        def get_video(self, url, video_format="bestvideo", audio_format="bestaudio", start_time=None, end_time=None, force_keyframes=False):
+            data = {"url": url, "video_format": video_format, "audio_format": audio_format, "force_keyframes": force_keyframes}
             if start_time is not None: data["start_time"] = start_time
             if end_time is not None: data["end_time"] = end_time
                 
@@ -94,8 +96,8 @@ class Client:
                 raise APIError(response.json().get('error', 'Unknown error'))
             return Task(self.client, response.json()['task_id'], 'get_video')
         
-        def get_audio(self, url, audio_format="bestaudio", start_time=None, end_time=None):
-            data = {"url": url, "audio_format": audio_format}
+        def get_audio(self, url, audio_format="bestaudio", start_time=None, end_time=None, force_keyframes=False):
+            data = {"url": url, "audio_format": audio_format, "force_keyframes": force_keyframes}
             if start_time is not None: data["start_time"] = start_time
             if end_time is not None: data["end_time"] = end_time
                 

{yt_dlp_host_api-0.1.2.dist-info → yt_dlp_host_api-0.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: yt_dlp_host_api
-Version: 0.1.2
+Version: 0.1.3
 Summary: A Python library for interacting with the yt-dlp-host API
 Author-email: "Amadeus (Wasys)" <tubik.corp@gmail.com>
 Project-URL: Homepage, https://github.com/Vasysik/yt-dlp-host-api
@@ -40,20 +40,23 @@ client = api.get_client('YOUR_API_KEY')
 client.get_video(url='https://youtu.be/1FPdtR_5KFo').save_file("test_video.mp4")
 print("Video saved to test_video.mp4")
 
-# Download a video segment (first 5 minutes)
+# Download a video segment with precise cutting
 client.get_video(
     url='https://youtu.be/1FPdtR_5KFo',
-    end_time="00:05:00"
-).save_file("first_5min.mp4")
-print("First 5 minutes saved to first_5min.mp4")
+    start_time="00:05:00",
+    end_time="00:10:00",
+    force_keyframes=True
+).save_file("precise_cut.mp4")
+print("Precisely cut segment saved to precise_cut.mp4")
 
-# Download a video segment (from 5 minutes to 10 minutes)
+# Download a video segment with faster cutting at keyframes
 client.get_video(
     url='https://youtu.be/1FPdtR_5KFo',
     start_time="00:05:00",
-    end_time="00:10:00"
-).save_file("5min_to_10min.mp4")
-print("5-10 minute segment saved to 5min_to_10min.mp4")
+    end_time="00:10:00",
+    force_keyframes=False
+).save_file("keyframe_cut.mp4")
+print("Keyframe-cut segment saved to keyframe_cut.mp4")
 
 # Download a complete audio
 client.get_audio(url='https://youtu.be/1FPdtR_5KFo').save_file("test_audio.mp3")
@@ -75,6 +78,8 @@ client.delete_key("user_key")
 - Download YouTube videos
   - Download complete videos
   - Download specific time segments
+    - Precise cutting with frame re-encoding
+    - Fast cutting at keyframes
   - Choose video and audio quality
 - Download YouTube audio
   - Download complete audio
@@ -93,13 +98,13 @@ client.delete_key("user_key")
 
 ### Client
 
-- `client.get_video(url, video_format="bestvideo", audio_format="bestaudio", start_time=None, end_time=None)`: Get video with optional time segment selection
-- `client.get_audio(url, audio_format="bestaudio", start_time=None, end_time=None)`: Get audio with optional time segment selection
+- `client.get_video(url, video_format="bestvideo", audio_format="bestaudio", start_time=None, end_time=None, force_keyframes=False)`: Get video with optional time segment selection
+- `client.get_audio(url, audio_format="bestaudio", start_time=None, end_time=None, force_keyframes=False)`: Get audio with optional time segment selection
 - `client.get_live_video(url, duration, start=0, video_format="bestvideo", audio_format="bestaudio")`: Get live video segment
 - `client.get_live_audio(url, duration, start=0, audio_format="bestaudio")`: Get live audio segment
 - `client.get_info(url)`: Get video information
-- `client.send_task.get_video(url, video_format="bestvideo", audio_format="bestaudio", start_time=None, end_time=None)`: Initiate a video download task
-- `client.send_task.get_audio(url, audio_format="bestaudio", start_time=None, end_time=None)`: Initiate an audio download task
+- `client.send_task.get_video(url, video_format="bestvideo", audio_format="bestaudio", start_time=None, end_time=None, force_keyframes=False)`: Initiate a video download task
+- `client.send_task.get_audio(url, audio_format="bestaudio", start_time=None, end_time=None, force_keyframes=False)`: Initiate an audio download task
 - `client.send_task.get_live_video(url, duration, start=0, video_format="bestvideo", audio_format="bestaudio")`: Initiate a live video download task
 - `client.send_task.get_live_audio(url, duration, start=0, audio_format="bestaudio")`: Initiate a live audio download task
 - `client.send_task.get_info(url)`: Initiate an info retrieval task
@@ -113,6 +118,12 @@ Examples:
 - "00:05:00" - 5 minutes
 - "01:30:45" - 1 hour, 30 minutes, and 45 seconds
 
+### Cutting Modes
+
+The `force_keyframes` parameter determines how video/audio segments are cut:
+- `force_keyframes=False` (default): Faster cutting that aligns to nearest keyframes. May not be exactly at specified timestamps but is much faster as it avoids re-encoding.
+- `force_keyframes=True`: Precise cutting at exact timestamps. This requires re-encoding which takes longer but provides exact cuts.
+
 ### Task
 
 - `task.get_status()`: Get the current status of a task

{yt_dlp_host_api-0.1.2.dist-info → yt_dlp_host_api-0.1.3.dist-info}/RECORD

@@ -1,10 +1,10 @@
 yt_dlp_host_api/__init__.py,sha256=RHx1BvH2Cy_dweEKo5sA-hdBOfBdY_2ds7srPuKGzWQ,41
 yt_dlp_host_api/api.py,sha256=iLzWKoyiXeu0Y1Uky8PzpxxHTSMcTGzxlCRT121AKcM,196
-yt_dlp_host_api/client.py,sha256=6vGRfZ0WMLSzW_4pDGRL1_Nc8lDKZA2GkgFMxiXL_kI,6226
+yt_dlp_host_api/client.py,sha256=NY_j4TthSV0xrCuv2JuzrpNkuHIsTnoOQuegLbIJHBI,6482
 yt_dlp_host_api/exceptions.py,sha256=U_70W1R_ZcUfKptUShGB5VPWQXwc5M29_sNC8pwwq8g,38
 yt_dlp_host_api/task.py,sha256=llgBAO_L1CajklMsbICdRpLdOV05Wi0oUh9NKj0bD0w,2674
-yt_dlp_host_api-0.1.2.dist-info/LICENSE,sha256=-_Ad_xue4UymJ8jO-ZsSg0vmZ6SUm8WYdoEwHLyBUlc,1078
-yt_dlp_host_api-0.1.2.dist-info/METADATA,sha256=E-J-hWokh7CGbGGCiphoh40ye_W-GgcVvViFi2VNurM,5311
-yt_dlp_host_api-0.1.2.dist-info/WHEEL,sha256=P9jw-gEje8ByB7_hXoICnHtVCrEwMQh-630tKvQWehc,91
-yt_dlp_host_api-0.1.2.dist-info/top_level.txt,sha256=Mn3FZuqLCHr47sRjhtEOz7lDl4lpsHkymWANORYp72s,16
-yt_dlp_host_api-0.1.2.dist-info/RECORD,,
+yt_dlp_host_api-0.1.3.dist-info/LICENSE,sha256=-_Ad_xue4UymJ8jO-ZsSg0vmZ6SUm8WYdoEwHLyBUlc,1078
+yt_dlp_host_api-0.1.3.dist-info/METADATA,sha256=geq0IJwW4ry9D-SIaD-wQsk8icTQqdmONgYEqGmc_Ws,5987
+yt_dlp_host_api-0.1.3.dist-info/WHEEL,sha256=P9jw-gEje8ByB7_hXoICnHtVCrEwMQh-630tKvQWehc,91
+yt_dlp_host_api-0.1.3.dist-info/top_level.txt,sha256=Mn3FZuqLCHr47sRjhtEOz7lDl4lpsHkymWANORYp72s,16
+yt_dlp_host_api-0.1.3.dist-info/RECORD,,