yt-dlp-host-api 0.2.0__py3-none-any.whl → 0.2.1__py3-none-any.whl

yt_dlp_host_api/client.py

@@ -9,43 +9,47 @@ 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", output_format="mp4", start_time=None, end_time=None, force_keyframes=False):
+    def get_video(self, url, video_format="bestvideo", audio_format="bestaudio", audio_language=None, output_format="mp4", 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,
+            audio_language=audio_language,
             output_format=output_format,
             start_time=start_time,
             end_time=end_time,
             force_keyframes=force_keyframes
         ).get_result()
     
-    def get_audio(self, url, audio_format="bestaudio", output_format=None, start_time=None, end_time=None, force_keyframes=False):
+    def get_audio(self, url, audio_format="bestaudio", audio_language=None, output_format=None, start_time=None, end_time=None, force_keyframes=False):
         return self.send_task.get_audio(
             url=url, 
             audio_format=audio_format,
+            audio_language=audio_language,
             output_format=output_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", output_format="mp4"):
+    def get_live_video(self, url, duration, start=0, video_format="bestvideo", audio_format="bestaudio", audio_language=None, output_format="mp4"):
         return self.send_task.get_live_video(
             url=url, 
             start=start, 
             duration=duration, 
             video_format=video_format, 
             audio_format=audio_format,
+            audio_language=audio_language,
             output_format=output_format
         ).get_result()
     
-    def get_live_audio(self, url, duration, start=0, audio_format="bestaudio", output_format=None):
+    def get_live_audio(self, url, duration, start=0, audio_format="bestaudio", audio_language=None, output_format=None):
         return self.send_task.get_live_audio(
             url=url, 
             start=start, 
             duration=duration, 
             audio_format=audio_format,
+            audio_language=audio_language,
             output_format=output_format
         ).get_result()
     
@@ -90,7 +94,7 @@ class Client:
         def __init__(self, client):
             self.client = client
 
-        def get_video(self, url, video_format="bestvideo", audio_format="bestaudio", output_format="mp4", start_time=None, end_time=None, force_keyframes=False):
+        def get_video(self, url, video_format="bestvideo", audio_format="bestaudio", audio_language=None, output_format="mp4", start_time=None, end_time=None, force_keyframes=False):
             data = {
                 "url": url, 
                 "video_format": video_format, 
@@ -98,6 +102,7 @@ class Client:
                 "output_format": output_format,
                 "force_keyframes": force_keyframes
             }
+            if audio_language is not None: data["audio_language"] = audio_language
             if start_time is not None: data["start_time"] = start_time
             if end_time is not None: data["end_time"] = end_time
                 
@@ -106,12 +111,13 @@ 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", output_format=None, start_time=None, end_time=None, force_keyframes=False):
+        def get_audio(self, url, audio_format="bestaudio", audio_language=None, output_format=None, start_time=None, end_time=None, force_keyframes=False):
             data = {
                 "url": url, 
                 "audio_format": audio_format, 
                 "force_keyframes": force_keyframes
             }
+            if audio_language is not None: data["audio_language"] = audio_language
             if output_format is not None: data["output_format"] = output_format
             if start_time is not None: data["start_time"] = start_time
             if end_time is not None: data["end_time"] = end_time
@@ -121,7 +127,7 @@ class Client:
                 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_format="bestvideo", audio_format="bestaudio", output_format="mp4"):
+        def get_live_video(self, url, duration, start=0, video_format="bestvideo", audio_format="bestaudio", audio_language=None, output_format="mp4"):
             data = {
                 "url": url, 
                 "start": start, 
@@ -130,18 +136,21 @@ class Client:
                 "audio_format": audio_format,
                 "output_format": output_format
             }
+            if audio_language is not None: data["audio_language"] = audio_language
+            
             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_format="bestaudio", output_format=None):
+        def get_live_audio(self, url, duration, start=0, audio_format="bestaudio", audio_language=None, output_format=None):
             data = {
                 "url": url, 
                 "start": start, 
                 "duration": duration, 
                 "audio_format": audio_format
             }
+            if audio_language is not None: data["audio_language"] = audio_language
             if output_format is not None: data["output_format"] = output_format
             
             response = requests.post(f"{self.client.host_url}/get_live_audio", json=data, headers=self.client.headers)

yt_dlp_host_api/task.py

@@ -58,11 +58,25 @@ class TaskResult:
             raise APIError("This method is only available for get_info tasks")
         url = self.get_file_url()
         if fields:
-            url += "?"
-            for field in fields:
-                url += f'{field}&'
+            if isinstance(fields, str):
+                url += f"?{fields}"
+            else:
+                url += "?"
+                for field in fields:
+                    url += f'{field}&'
+                url = url.rstrip('&')
         response = requests.get(url, headers=self.client.headers)
         if response.status_code != 200:
             raise APIError(response.json().get('error', 'Unknown error'))
         data = json.loads(response.text)
         return data
+    
+    def get_qualities(self):
+        if self.status['task_type'] != 'get_info':
+            raise APIError("This method is only available for get_info tasks")
+        return self.get_json('qualities')
+    
+    def get_languages(self):
+        if self.status['task_type'] != 'get_info':
+            raise APIError("This method is only available for get_info tasks")
+        return self.get_json('languages')

{yt_dlp_host_api-0.2.0.dist-info → yt_dlp_host_api-0.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: yt_dlp_host_api
-Version: 0.2.0
+Version: 0.2.1
 Summary: A Python library for interacting with the yt-dlp-host API
 Author-email: "Amadeus (Wasys)" <tubik.corp@gmail.com>
 License-Expression: MIT
@@ -73,8 +73,20 @@ print("Audio saved to test_audio.mp3")
 client.get_audio(url='https://youtu.be/1FPdtR_5KFo', output_format='flac').save_file("test_audio.flac")
 print("Audio saved to test_audio.flac")
 
-# Get info
-info_json = client.get_info(url='https://youtu.be/1FPdtR_5KFo').get_json(['qualities', 'title'])
+# Get info with available qualities and languages
+info_result = client.get_info(url='https://youtu.be/1FPdtR_5KFo')
+
+# Get available qualities
+qualities = info_result.get_qualities()
+print("Available qualities:", qualities)
+
+# Get available languages
+languages = info_result.get_languages()
+print("Available audio languages:", languages['languages']['audio'])
+print("Available subtitle languages:", languages['languages']['subtitles'])
+
+# Get specific fields from info
+info_json = info_result.get_json(['title', 'duration', 'upload_date'])
 print("Video info:", info_json)
 
 # Admin operations (requires admin API key)
@@ -93,13 +105,18 @@ client.delete_key("user_key")
     - Fast cutting at keyframes
   - Choose video and audio quality
   - Choose output format (MP4, MKV, WebM, AVI, MOV, FLV, 3GP)
+  - Select specific audio language or download all audio tracks
 - Download YouTube audio
   - Download complete audio
   - Download specific time segments
   - Choose audio quality
   - Choose output format (MP3, M4A, Opus, FLAC, WAV, AAC, OGG)
+  - Select specific audio language
 - Extract live stream segments
 - Retrieve video information
+  - Get available video and audio qualities
+  - Get available audio and subtitle languages
+  - Filter specific fields from video metadata
 - Checking client permissions
 - Admin operations:
   - Create new API keys
@@ -111,15 +128,15 @@ client.delete_key("user_key")
 
 ### Client
 
-- `client.get_video(url, video_format="bestvideo", audio_format="bestaudio", output_format="mp4", start_time=None, end_time=None, force_keyframes=False)`: Get video with optional time segment selection
-- `client.get_audio(url, audio_format="bestaudio", output_format=None, 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", output_format="mp4")`: Get live video segment
-- `client.get_live_audio(url, duration, start=0, audio_format="bestaudio", output_format=None)`: Get live audio segment
+- `client.get_video(url, video_format="bestvideo", audio_format="bestaudio", audio_language=None, output_format="mp4", start_time=None, end_time=None, force_keyframes=False)`: Get video with optional time segment selection and language preference
+- `client.get_audio(url, audio_format="bestaudio", audio_language=None, output_format=None, start_time=None, end_time=None, force_keyframes=False)`: Get audio with optional time segment selection and language preference
+- `client.get_live_video(url, duration, start=0, video_format="bestvideo", audio_format="bestaudio", audio_language=None, output_format="mp4")`: Get live video segment with language preference
+- `client.get_live_audio(url, duration, start=0, audio_format="bestaudio", audio_language=None, output_format=None)`: Get live audio segment with language preference
 - `client.get_info(url)`: Get video information
-- `client.send_task.get_video(url, video_format="bestvideo", audio_format="bestaudio", output_format="mp4", start_time=None, end_time=None, force_keyframes=False)`: Initiate a video download task
-- `client.send_task.get_audio(url, audio_format="bestaudio", output_format=None, 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", output_format="mp4")`: Initiate a live video download task
-- `client.send_task.get_live_audio(url, duration, start=0, audio_format="bestaudio", output_format=None)`: Initiate a live audio download task
+- `client.send_task.get_video(...)`: Initiate a video download task
+- `client.send_task.get_audio(...)`: Initiate an audio download task
+- `client.send_task.get_live_video(...)`: Initiate a live video download task
+- `client.send_task.get_live_audio(...)`: 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
 
@@ -127,7 +144,7 @@ client.delete_key("user_key")
 
 #### Video Formats
 - **mp4** - MPEG-4 Part 14 (recommended)
-- **mkv** - Matroska
+- **mkv** - Matroska (supports multiple audio tracks)
 - **webm** - WebM
 - **avi** - Audio Video Interleave
 - **mov** - QuickTime File Format
@@ -145,10 +162,30 @@ client.delete_key("user_key")
 
 Note: If `output_format` is not specified for audio, the original format will be used.
 
+### Audio Language Support
+
+The `audio_language` parameter allows you to specify which audio track to download:
+- **None** (default): yt-dlp automatically selects the best available audio track
+- **ISO Language Code** (e.g., "en", "ru", "es", "de", "fr", "ja"): Downloads the specific language audio track
+- **"all"**: Downloads all available audio tracks (video will be saved in MKV format with multiple audio streams)
+
+Examples:
+```python
+# Default audio track (auto-selected by yt-dlp)
+client.get_video(url='...', output_format='mp4')
+
+# Specific language
+client.get_video(url='...', audio_language='ru', output_format='mp4')
+
+# All audio tracks
+client.get_video(url='...', audio_language='all', output_format='mkv')
+```
+
 ### 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
@@ -166,10 +203,12 @@ The `force_keyframes` parameter determines how video/audio segments are cut:
 
 ### TaskResult
 
-- `result.get_file()`: Get the file
+- `result.get_file()`: Get the file content
 - `result.get_file_url()`: Get the URL of the downloaded file
 - `result.save_file(path)`: Save the downloaded file to the specified path
 - `result.get_json(fields=None)`: Get the JSON data for info tasks (optionally filtered by fields)
+- `result.get_qualities()`: Get available video and audio qualities (info tasks only)
+- `result.get_languages()`: Get available audio and subtitle languages (info tasks only)
 
 ### Admin
 
@@ -178,10 +217,90 @@ The `force_keyframes` parameter determines how video/audio segments are cut:
 - `client.get_key(name)`: Get API key by key name
 - `client.delete_key(name)`: Delete an API key
 
+## Advanced Examples
+
+### Checking available languages before downloading
+
+```python
+import yt_dlp_host_api
+
+api = yt_dlp_host_api.api('http://your-api-url.com')
+client = api.get_client('YOUR_API_KEY')
+
+# First, get video info to check available languages
+info_result = client.get_info(url='https://youtu.be/1FPdtR_5KFo')
+languages = info_result.get_languages()
+
+print(f"Available audio languages: {languages['languages']['audio']}")
+print(f"Available subtitle languages: {languages['languages']['subtitles']}")
+
+# Download with a specific language if available
+if 'ru' in languages['languages']['audio']:
+    client.get_video(
+        url='https://youtu.be/1FPdtR_5KFo',
+        audio_language='ru',
+        output_format='mp4'
+    ).save_file("video_russian.mp4")
+    print("Downloaded video with Russian audio")
+```
+
+### Getting video qualities information
+
+```python
+import yt_dlp_host_api
+
+api = yt_dlp_host_api.api('http://your-api-url.com')
+client = api.get_client('YOUR_API_KEY')
+
+info_result = client.get_info(url='https://youtu.be/1FPdtR_5KFo')
+qualities = info_result.get_qualities()
+
+# Display available video qualities
+print("Available video qualities:")
+for format_id, details in qualities['qualities']['video'].items():
+    print(f"  Format {format_id}: {details['height']}p, {details['fps']}fps, {details['vcodec']}")
+
+# Display available audio qualities
+print("\nAvailable audio qualities:")
+for format_id, details in qualities['qualities']['audio'].items():
+    print(f"  Format {format_id}: {details['abr']}kbps, {details['acodec']}, language: {details.get('language', 'unknown')}")
+```
+
+### Downloading with specific quality selection
+
+```python
+import yt_dlp_host_api
+
+api = yt_dlp_host_api.api('http://your-api-url.com')
+client = api.get_client('YOUR_API_KEY')
+
+# Download 720p video with 128kbps audio
+client.get_video(
+    url='https://youtu.be/1FPdtR_5KFo',
+    video_format='bestvideo[height<=720]',
+    audio_format='bestaudio[abr<=128]',
+    output_format='mp4'
+).save_file("video_720p_128k.mp4")
+```
+
 ## Error Handling
 
 The library uses exceptions to handle errors. Catch `yt_dlp_host_api.exceptions.APIError` to handle API-related errors.
 
+```python
+import yt_dlp_host_api
+from yt_dlp_host_api.exceptions import APIError
+
+api = yt_dlp_host_api.api('http://your-api-url.com')
+client = api.get_client('YOUR_API_KEY')
+
+try:
+    result = client.get_video(url='https://youtu.be/invalid-url')
+    result.save_file("video.mp4")
+except APIError as e:
+    print(f"API Error: {e}")
+```
+
 ## Contributing
 
 Contributions to yt-dlp-host-api are welcome! If you have any suggestions, bug reports, or feature requests, please open an issue on the GitHub repository. Pull requests are also encouraged.

yt_dlp_host_api-0.2.1.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=d0EUMGS-k4ndKG_xATDkg6hQgSUsSH_z_aDFkz95dp0,8126
+yt_dlp_host_api/exceptions.py,sha256=U_70W1R_ZcUfKptUShGB5VPWQXwc5M29_sNC8pwwq8g,38
+yt_dlp_host_api/task.py,sha256=pn0KcEfCDrSuE0DUnAF1YGpMnJL6vc3sXN2im1jBdeI,3244
+yt_dlp_host_api-0.2.1.dist-info/licenses/LICENSE,sha256=-_Ad_xue4UymJ8jO-ZsSg0vmZ6SUm8WYdoEwHLyBUlc,1078
+yt_dlp_host_api-0.2.1.dist-info/METADATA,sha256=6t-5ua00ltERunJqjlO1EaTOq_DPJtKEwNgBp5nbtu4,11261
+yt_dlp_host_api-0.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+yt_dlp_host_api-0.2.1.dist-info/top_level.txt,sha256=Mn3FZuqLCHr47sRjhtEOz7lDl4lpsHkymWANORYp72s,16
+yt_dlp_host_api-0.2.1.dist-info/RECORD,,

yt_dlp_host_api-0.2.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=5Wf7Ue0A1HQX2EuaBk_TndOpWoDlb6t5NBslB0EljGI,7432
-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.2.0.dist-info/licenses/LICENSE,sha256=-_Ad_xue4UymJ8jO-ZsSg0vmZ6SUm8WYdoEwHLyBUlc,1078
-yt_dlp_host_api-0.2.0.dist-info/METADATA,sha256=NBsJNdGgaSDD3z5Q-S7Sd1ZdjuXbQm8k_064IfMVBf0,7368
-yt_dlp_host_api-0.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-yt_dlp_host_api-0.2.0.dist-info/top_level.txt,sha256=Mn3FZuqLCHr47sRjhtEOz7lDl4lpsHkymWANORYp72s,16
-yt_dlp_host_api-0.2.0.dist-info/RECORD,,