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

yt_dlp_host_api/client.py

@@ -9,17 +9,41 @@ 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"):
-        return self.send_task.get_video(url=url, video_format=video_format, audio_format=audio_format).get_result()
+    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,
+            force_keyframes=force_keyframes
+        ).get_result()
     
-    def get_audio(self, url, audio_format="bestaudio"):
-        return self.send_task.get_audio(url=url, audio_format=audio_format).get_result()
+    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,
+            force_keyframes=force_keyframes
+        ).get_result()
     
     def get_live_video(self, url, duration, start=0, video_format="bestvideo", audio_format="bestaudio"):
-        return self.send_task.get_live_video(url=url, start=start, duration=duration, video_format=video_format, audio_format=audio_format).get_result()
+        return self.send_task.get_live_video(
+            url=url, 
+            start=start, 
+            duration=duration, 
+            video_format=video_format, 
+            audio_format=audio_format
+        ).get_result()
     
     def get_live_audio(self, url, duration, start=0, audio_format="bestaudio"):
-        return self.send_task.get_live_audio(url=url, start=start, duration=duration, audio_format=audio_format).get_result()
+        return self.send_task.get_live_audio(
+            url=url, 
+            start=start, 
+            duration=duration, 
+            audio_format=audio_format
+        ).get_result()
     
     def get_info(self, url):
         return self.send_task.get_info(url=url).get_result()
@@ -62,15 +86,21 @@ class Client:
         def __init__(self, client):
             self.client = client
 
-        def get_video(self, url, video_format="bestvideo", audio_format="bestaudio"):
-            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
+                
             response = requests.post(f"{self.client.host_url}/get_video", json=data, headers=self.client.headers)
             if response.status_code != 200:
                 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"):
-            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
+                
             response = requests.post(f"{self.client.host_url}/get_audio", json=data, headers=self.client.headers)
             if response.status_code != 200:
                 raise APIError(response.json().get('error', 'Unknown error'))

{yt_dlp_host_api-0.1.1.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.1
+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
@@ -36,11 +36,29 @@ import yt_dlp_host_api
 api = yt_dlp_host_api.api('http://your-api-url.com')
 client = api.get_client('YOUR_API_KEY')
 
-# Download a video
+# Download a complete video
 client.get_video(url='https://youtu.be/1FPdtR_5KFo').save_file("test_video.mp4")
 print("Video saved to test_video.mp4")
 
-# Download a audio
+# Download a video segment with precise cutting
+client.get_video(
+    url='https://youtu.be/1FPdtR_5KFo',
+    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 with faster cutting at keyframes
+client.get_video(
+    url='https://youtu.be/1FPdtR_5KFo',
+    start_time="00:05:00",
+    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")
 print("Audio saved to test_audio.mp3")
 
@@ -58,6 +76,16 @@ client.delete_key("user_key")
 ## Features
 
 - 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
+  - Download specific time segments
+  - Choose audio quality
+- Extract live stream segments
 - Retrieve video information
 - Checking client permissions
 - Admin operations:
@@ -70,17 +98,31 @@ client.delete_key("user_key")
 
 ### Client
 
-- `client.get_video(url, video_format="bestvideo", audio_format="bestaudio")`: Simple way to get the result of get_video
-- `client.get_audio(url, audio_format="bestaudio")`: Simple way to get the result of get_audio
-- `client.get_live_video(url, duration, start=0, video_format="bestvideo", audio_format="bestaudio")`: Simple way to get the result of get_live_video
-- `client.get_live_audio(url, duration, start=0, audio_format="bestaudio")`: Simple way to get the result of get_live_audio
-- `client.get_info(url)`: Simple way to get the result of get_info
-- `client.send_task.get_video(url, video_format="bestvideo", audio_format="bestaudio")`: Initiates a get_video task
-- `client.send_task.get_audio(url, audio_format="bestaudio")`: Initiates a get_audio task
-- `client.send_task.get_live_video(url, duration, start=0, video_format="bestvideo", audio_format="bestaudio")`: Initiates a get_video task
-- `client.send_task.get_live_audio(url, duration, start=0, audio_format="bestaudio")`: Initiates a get_audio task
-- `client.send_task.get_info(url)`: Initiates a get_info task
-- `client.check_permissions(permissions)`: Checks for all permissions in the list
+- `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, 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
+- `client.check_permissions(permissions)`: Check for all permissions in the list
+
+### Time Format
+
+Time parameters (`start_time` and `end_time`) should be provided in the following format:
+- "HH:MM:SS" (hours:minutes:seconds)
+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
 

yt_dlp_host_api-0.1.3.dist-info/RECORD

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

{yt_dlp_host_api-0.1.1.dist-info → yt_dlp_host_api-0.1.3.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.1.0)
+Generator: setuptools (75.3.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

yt_dlp_host_api-0.1.1.dist-info/RECORD

@@ -1,10 +0,0 @@
-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=qFmyKQIOwmd_5C5V27iTrvYRsKWImksfeHSBJokMFdA,5414
-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.1.dist-info/LICENSE,sha256=-_Ad_xue4UymJ8jO-ZsSg0vmZ6SUm8WYdoEwHLyBUlc,1078
-yt_dlp_host_api-0.1.1.dist-info/METADATA,sha256=zkMxELh07KcHK3vpHeE19Ohy7gqdehSaDFwA2GX_rTc,4220
-yt_dlp_host_api-0.1.1.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
-yt_dlp_host_api-0.1.1.dist-info/top_level.txt,sha256=Mn3FZuqLCHr47sRjhtEOz7lDl4lpsHkymWANORYp72s,16
-yt_dlp_host_api-0.1.1.dist-info/RECORD,,