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

yt_dlp_host_api/client.py

@@ -9,17 +9,39 @@ 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_quality="best", audio_quality="best"):
-        return self.send_task.get_video(url=url, video_quality=video_quality, audio_quality=audio_quality).get_result()
+    def get_video(self, url, video_format="bestvideo", audio_format="bestaudio", start_time=None, end_time=None):
+        return self.send_task.get_video(
+            url=url, 
+            video_format=video_format, 
+            audio_format=audio_format,
+            start_time=start_time,
+            end_time=end_time
+        ).get_result()
     
-    def get_audio(self, url, audio_quality="best"):
-        return self.send_task.get_audio(url=url, audio_quality=audio_quality).get_result()
+    def get_audio(self, url, audio_format="bestaudio", start_time=None, end_time=None):
+        return self.send_task.get_audio(
+            url=url, 
+            audio_format=audio_format,
+            start_time=start_time,
+            end_time=end_time
+        ).get_result()
     
-    def get_live_video(self, url, duration, start=0, video_quality="best", audio_quality="best"):
-        return self.send_task.get_live_video(url=url, start=start, duration=duration, video_quality=video_quality, audio_quality=audio_quality).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()
     
-    def get_live_audio(self, url, duration, start=0, audio_quality="best"):
-        return self.send_task.get_live_audio(url=url, start=start, duration=duration, audio_quality=audio_quality).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()
     
     def get_info(self, url):
         return self.send_task.get_info(url=url).get_result()
@@ -62,29 +84,35 @@ class Client:
         def __init__(self, client):
             self.client = client
 
-        def get_video(self, url, video_quality="best", audio_quality="best"):
-            data = {"url": url, "video_quality": video_quality, "audio_quality": audio_quality}
+        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}
+            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_quality="best"):
-            data = {"url": url, "audio_quality": audio_quality}
+        def get_audio(self, url, audio_format="bestaudio", start_time=None, end_time=None):
+            data = {"url": url, "audio_format": audio_format}
+            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'))
             return Task(self.client, response.json()['task_id'], 'get_audio')
         
-        def get_live_video(self, url, duration, start=0, video_quality="best", audio_quality="best"):
-            data = {"url": url, "start": start, "duration": duration, "video_quality": video_quality, "audio_quality": audio_quality}
+        def get_live_video(self, url, duration, start=0, video_format="bestvideo", audio_format="bestaudio"):
+            data = {"url": url, "start": start, "duration": duration, "video_format": video_format, "audio_format": audio_format}
             response = requests.post(f"{self.client.host_url}/get_live_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_live_audio(self, url, duration, start=0, audio_quality="best"):
-            data = {"url": url, "start": start, "duration": duration, "audio_quality": audio_quality}
+        def get_live_audio(self, url, duration, start=0, audio_format="bestaudio"):
+            data = {"url": url, "start": start, "duration": duration, "audio_format": audio_format}
             response = requests.post(f"{self.client.host_url}/get_live_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.0.dist-info → yt_dlp_host_api-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: yt_dlp_host_api
-Version: 0.1.0
+Version: 0.1.2
 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,26 @@ 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 (first 5 minutes)
+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")
+
+# Download a video segment (from 5 minutes to 10 minutes)
+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")
+
+# 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 +73,14 @@ client.delete_key("user_key")
 ## Features
 
 - Download YouTube videos
+  - Download complete videos
+  - Download specific time segments
+  - 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 +93,25 @@ client.delete_key("user_key")
 
 ### Client
 
-- `client.get_video(url, quality='best')`: Simple way to get the result of get_video
-- `client.get_audio(url)`: Simple way to get the result of get_audio
-- `client.get_live_video(url, duration, start=0, quality='best')`: Simple way to get the result of get_live_video
-- `client.get_live_audio(url, duration, start=0)`: 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, quality='best')`: Initiates a get_video task
-- `client.send_task.get_audio(url)`: Initiates a get_audio task
-- `client.send_task.get_live_video(url, duration, start=0, quality='best')`: Initiates a get_video task
-- `client.send_task.get_live_audio(url, duration, start=0)`: 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)`: 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_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_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
 
 ### Task
 

yt_dlp_host_api-0.1.2.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=6vGRfZ0WMLSzW_4pDGRL1_Nc8lDKZA2GkgFMxiXL_kI,6226
+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.0.dist-info → yt_dlp_host_api-0.1.2.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.0.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=l8-pdx4NiKggWsGpMtR_-59Ix4Fprhtt9dq-VU4twN8,5390
-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.0.dist-info/LICENSE,sha256=-_Ad_xue4UymJ8jO-ZsSg0vmZ6SUm8WYdoEwHLyBUlc,1078
-yt_dlp_host_api-0.1.0.dist-info/METADATA,sha256=26qGluTLCP0ci6bAG9SlwrX3XA1fKxtIqwZcu0L7faQ,3972
-yt_dlp_host_api-0.1.0.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
-yt_dlp_host_api-0.1.0.dist-info/top_level.txt,sha256=Mn3FZuqLCHr47sRjhtEOz7lDl4lpsHkymWANORYp72s,16
-yt_dlp_host_api-0.1.0.dist-info/RECORD,,