SgithiDownloader 1.0.0__tar.gz

sgithidownloader-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AceCJM
+
+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.

sgithidownloader-1.0.0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: SgithiDownloader
+Version: 1.0.0
+Summary: A tool to download YouTube videos and audio with embedded thumbnails.
+Author-email: AceCJM <sgithi.sgigigtat@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/AceCJM/SgithiDownloader
+Keywords: youtube,downloader,video,audio,yt-dlp,pytube
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Multimedia :: Sound/Audio
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: certifi==2026.1.4
+Requires-Dist: charset-normalizer==3.4.4
+Requires-Dist: idna==3.11
+Requires-Dist: mutagen==1.47.0
+Requires-Dist: pillow==12.1.1
+Requires-Dist: pytube==15.0.0
+Requires-Dist: requests==2.32.5
+Requires-Dist: urllib3==2.6.3
+Requires-Dist: yt-dlp==2026.2.21
+Dynamic: license-file
+
+# sgithidownloader
+
+A Python tool to download YouTube videos and audio in various high-quality formats with embedded thumbnails and metadata.
+
+## Features
+
+- Download individual YouTube videos or entire playlists
+- Support for multiple video formats (MP4, WebM, etc.)
+- Convert and download audio in various formats (Opus, MP3, FLAC, AAC, etc.)
+- Automatically embed video thumbnails as album art
+- Include metadata (title, artist, album, date, description) in supported formats
+- Crop thumbnails to square format for better display
+
+## Installation
+
+### Prerequisites
+
+- Python 3.8 or higher
+- FFmpeg (for audio processing)
+
+### Install FFmpeg
+
+**On Ubuntu/Debian:**
+```bash
+sudo apt update
+sudo apt install ffmpeg
+```
+
+**On macOS:**
+```bash
+brew install ffmpeg
+```
+
+**On Windows:**
+Download from [ffmpeg.org](https://ffmpeg.org/download.html) and add to PATH.
+
+### Install the Package
+
+```bash
+git clone <your-repo-url>
+cd OpusDownloader
+pip install .
+```
+
+For development:
+```bash
+pip install -e .
+```
+
+## Usage
+
+### Download a Single Video
+
+```bash
+sgithidownloader -s "https://www.youtube.com/watch?v=VIDEO_ID" -o /path/to/output/
+```
+
+### Download a Playlist
+
+```bash
+sgithidownloader -p "https://www.youtube.com/playlist?list=PLAYLIST_ID" -o /path/to/output/
+```
+
+### Download Audio
+
+```bash
+sgithidownloader -s "https://www.youtube.com/watch?v=VIDEO_ID" -f audio -af opus -o /path/to/output/
+```
+
+### Options
+
+- `-s, --single URL`: Download a single video
+- `-p, --playlist URL`: Download all videos in a playlist
+- `-o, --output DIR`: Output directory (default: current directory)
+- `-f, --format FORMAT`: File format for video (mp4, webm, audio, etc.) (default: mp4)
+- `-af, --audio_format FORMAT`: Audio format (best, aac, alac, flac, m4a, mp3, opus, vorbis, wav) (default: best)
+- `-l, --listFormats`: List available audio formats and exit
+- `--help`: Show help message
+
+## Examples
+
+```bash
+# Download a single video to the current directory
+sgithidownloader -s "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
+
+# Download a playlist to a specific folder
+sgithidownloader -p "https://www.youtube.com/playlist?list=PLrAXtmRdnEQy4qtr5G1G8jQGzq9j9j9j" -o ~/Videos/
+
+# Download audio in MP3 format
+sgithidownloader -s "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -f audio -af mp3 -o ~/Music/
+
+# List available audio formats
+sgithidownloader -l
+```
+
+## Dependencies
+
+- yt-dlp: For downloading and extracting audio
+- mutagen: For embedding metadata in audio files
+- pytube: For playlist handling
+- pillow: For image processing
+- requests: For downloading thumbnails
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Submit a pull request
+
+## Disclaimer
+
+This tool is for personal use only. Respect YouTube's terms of service and copyright laws. The author is not responsible for misuse.

sgithidownloader-1.0.0/README.md

@@ -0,0 +1,117 @@
+# sgithidownloader
+
+A Python tool to download YouTube videos and audio in various high-quality formats with embedded thumbnails and metadata.
+
+## Features
+
+- Download individual YouTube videos or entire playlists
+- Support for multiple video formats (MP4, WebM, etc.)
+- Convert and download audio in various formats (Opus, MP3, FLAC, AAC, etc.)
+- Automatically embed video thumbnails as album art
+- Include metadata (title, artist, album, date, description) in supported formats
+- Crop thumbnails to square format for better display
+
+## Installation
+
+### Prerequisites
+
+- Python 3.8 or higher
+- FFmpeg (for audio processing)
+
+### Install FFmpeg
+
+**On Ubuntu/Debian:**
+```bash
+sudo apt update
+sudo apt install ffmpeg
+```
+
+**On macOS:**
+```bash
+brew install ffmpeg
+```
+
+**On Windows:**
+Download from [ffmpeg.org](https://ffmpeg.org/download.html) and add to PATH.
+
+### Install the Package
+
+```bash
+git clone <your-repo-url>
+cd OpusDownloader
+pip install .
+```
+
+For development:
+```bash
+pip install -e .
+```
+
+## Usage
+
+### Download a Single Video
+
+```bash
+sgithidownloader -s "https://www.youtube.com/watch?v=VIDEO_ID" -o /path/to/output/
+```
+
+### Download a Playlist
+
+```bash
+sgithidownloader -p "https://www.youtube.com/playlist?list=PLAYLIST_ID" -o /path/to/output/
+```
+
+### Download Audio
+
+```bash
+sgithidownloader -s "https://www.youtube.com/watch?v=VIDEO_ID" -f audio -af opus -o /path/to/output/
+```
+
+### Options
+
+- `-s, --single URL`: Download a single video
+- `-p, --playlist URL`: Download all videos in a playlist
+- `-o, --output DIR`: Output directory (default: current directory)
+- `-f, --format FORMAT`: File format for video (mp4, webm, audio, etc.) (default: mp4)
+- `-af, --audio_format FORMAT`: Audio format (best, aac, alac, flac, m4a, mp3, opus, vorbis, wav) (default: best)
+- `-l, --listFormats`: List available audio formats and exit
+- `--help`: Show help message
+
+## Examples
+
+```bash
+# Download a single video to the current directory
+sgithidownloader -s "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
+
+# Download a playlist to a specific folder
+sgithidownloader -p "https://www.youtube.com/playlist?list=PLrAXtmRdnEQy4qtr5G1G8jQGzq9j9j9j" -o ~/Videos/
+
+# Download audio in MP3 format
+sgithidownloader -s "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -f audio -af mp3 -o ~/Music/
+
+# List available audio formats
+sgithidownloader -l
+```
+
+## Dependencies
+
+- yt-dlp: For downloading and extracting audio
+- mutagen: For embedding metadata in audio files
+- pytube: For playlist handling
+- pillow: For image processing
+- requests: For downloading thumbnails
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Submit a pull request
+
+## Disclaimer
+
+This tool is for personal use only. Respect YouTube's terms of service and copyright laws. The author is not responsible for misuse.

sgithidownloader-1.0.0/SgithiDownloader.egg-info/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: SgithiDownloader
+Version: 1.0.0
+Summary: A tool to download YouTube videos and audio with embedded thumbnails.
+Author-email: AceCJM <sgithi.sgigigtat@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/AceCJM/SgithiDownloader
+Keywords: youtube,downloader,video,audio,yt-dlp,pytube
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Multimedia :: Sound/Audio
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: certifi==2026.1.4
+Requires-Dist: charset-normalizer==3.4.4
+Requires-Dist: idna==3.11
+Requires-Dist: mutagen==1.47.0
+Requires-Dist: pillow==12.1.1
+Requires-Dist: pytube==15.0.0
+Requires-Dist: requests==2.32.5
+Requires-Dist: urllib3==2.6.3
+Requires-Dist: yt-dlp==2026.2.21
+Dynamic: license-file
+
+# sgithidownloader
+
+A Python tool to download YouTube videos and audio in various high-quality formats with embedded thumbnails and metadata.
+
+## Features
+
+- Download individual YouTube videos or entire playlists
+- Support for multiple video formats (MP4, WebM, etc.)
+- Convert and download audio in various formats (Opus, MP3, FLAC, AAC, etc.)
+- Automatically embed video thumbnails as album art
+- Include metadata (title, artist, album, date, description) in supported formats
+- Crop thumbnails to square format for better display
+
+## Installation
+
+### Prerequisites
+
+- Python 3.8 or higher
+- FFmpeg (for audio processing)
+
+### Install FFmpeg
+
+**On Ubuntu/Debian:**
+```bash
+sudo apt update
+sudo apt install ffmpeg
+```
+
+**On macOS:**
+```bash
+brew install ffmpeg
+```
+
+**On Windows:**
+Download from [ffmpeg.org](https://ffmpeg.org/download.html) and add to PATH.
+
+### Install the Package
+
+```bash
+git clone <your-repo-url>
+cd OpusDownloader
+pip install .
+```
+
+For development:
+```bash
+pip install -e .
+```
+
+## Usage
+
+### Download a Single Video
+
+```bash
+sgithidownloader -s "https://www.youtube.com/watch?v=VIDEO_ID" -o /path/to/output/
+```
+
+### Download a Playlist
+
+```bash
+sgithidownloader -p "https://www.youtube.com/playlist?list=PLAYLIST_ID" -o /path/to/output/
+```
+
+### Download Audio
+
+```bash
+sgithidownloader -s "https://www.youtube.com/watch?v=VIDEO_ID" -f audio -af opus -o /path/to/output/
+```
+
+### Options
+
+- `-s, --single URL`: Download a single video
+- `-p, --playlist URL`: Download all videos in a playlist
+- `-o, --output DIR`: Output directory (default: current directory)
+- `-f, --format FORMAT`: File format for video (mp4, webm, audio, etc.) (default: mp4)
+- `-af, --audio_format FORMAT`: Audio format (best, aac, alac, flac, m4a, mp3, opus, vorbis, wav) (default: best)
+- `-l, --listFormats`: List available audio formats and exit
+- `--help`: Show help message
+
+## Examples
+
+```bash
+# Download a single video to the current directory
+sgithidownloader -s "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
+
+# Download a playlist to a specific folder
+sgithidownloader -p "https://www.youtube.com/playlist?list=PLrAXtmRdnEQy4qtr5G1G8jQGzq9j9j9j" -o ~/Videos/
+
+# Download audio in MP3 format
+sgithidownloader -s "https://www.youtube.com/watch?v=dQw4w9WgXcQ" -f audio -af mp3 -o ~/Music/
+
+# List available audio formats
+sgithidownloader -l
+```
+
+## Dependencies
+
+- yt-dlp: For downloading and extracting audio
+- mutagen: For embedding metadata in audio files
+- pytube: For playlist handling
+- pillow: For image processing
+- requests: For downloading thumbnails
+
+## License
+
+MIT License - see LICENSE file for details.
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Submit a pull request
+
+## Disclaimer
+
+This tool is for personal use only. Respect YouTube's terms of service and copyright laws. The author is not responsible for misuse.

sgithidownloader-1.0.0/SgithiDownloader.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+SgithiDownloader.egg-info/PKG-INFO
+SgithiDownloader.egg-info/SOURCES.txt
+SgithiDownloader.egg-info/dependency_links.txt
+SgithiDownloader.egg-info/entry_points.txt
+SgithiDownloader.egg-info/requires.txt
+SgithiDownloader.egg-info/top_level.txt
+sgithidownloader/__init__.py
+sgithidownloader/audio.py
+sgithidownloader/shared.py
+sgithidownloader/video.py

sgithidownloader-1.0.0/SgithiDownloader.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

sgithidownloader-1.0.0/SgithiDownloader.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+sgithidownloader = sgithidownloader:cli

sgithidownloader-1.0.0/SgithiDownloader.egg-info/requires.txt

@@ -0,0 +1,9 @@
+certifi==2026.1.4
+charset-normalizer==3.4.4
+idna==3.11
+mutagen==1.47.0
+pillow==12.1.1
+pytube==15.0.0
+requests==2.32.5
+urllib3==2.6.3
+yt-dlp==2026.2.21

sgithidownloader-1.0.0/SgithiDownloader.egg-info/top_level.txt

@@ -0,0 +1 @@
+sgithidownloader

sgithidownloader-1.0.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "SgithiDownloader"
+version = "1.0.0"
+description = "A tool to download YouTube videos and audio with embedded thumbnails."
+authors = [{name = "AceCJM", email = "sgithi.sgigigtat@gmail.com"}]
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+keywords = ["youtube", "downloader", "video", "audio", "yt-dlp", "pytube"]
+dependencies = [
+    "certifi==2026.1.4",
+    "charset-normalizer==3.4.4",
+    "idna==3.11",
+    "mutagen==1.47.0",
+    "pillow==12.1.1",
+    "pytube==15.0.0",
+    "requests==2.32.5",
+    "urllib3==2.6.3",
+    "yt-dlp==2026.2.21",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: End Users/Desktop",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+
+    "Operating System :: OS Independent",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Multimedia :: Sound/Audio",
+]
+urls = {Homepage = "https://github.com/AceCJM/SgithiDownloader"}
+
+[project.scripts]
+sgithidownloader = "sgithidownloader:cli"

sgithidownloader-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

sgithidownloader-1.0.0/sgithidownloader/__init__.py

@@ -0,0 +1,74 @@
+import sys, requests, base64, os
+import yt_dlp, re
+from pytube import Playlist
+import argparse
+
+from sgithidownloader.audio import audio_main
+from sgithidownloader.video import video_main
+
+def cli():
+    parser = argparse.ArgumentParser(
+        description="SgithiDownloader - Version 1.0 - Download YouTube videos"
+    )
+    parser.add_argument(
+        "-s", "--single", type=str, help="Download a single video from URL"
+    )
+    parser.add_argument(
+        "-p", "--playlist", type=str, help="Download all videos from playlist URL"
+    )
+    parser.add_argument(
+        "-o", "--output", type=str, default="./", help="Output directory (default: ./)"
+    )
+    parser.add_argument(
+        "-f",
+        "--format",
+        type=str,
+        default="mp4",
+        help="File format (mp4, webm, audio, etc.) (default: mp4)",
+    )
+    parser.add_argument(
+        "-af",
+        "--audio_format",
+        type=str,
+        default="best",
+        help="Audio format (opus, flac, etc.) (default: best)",
+    )
+    parser.add_argument(
+        "-l",
+        "--listFormats",
+        action="store_true",
+        help="List available audio formats and exit",
+    )
+
+    args = parser.parse_args()
+
+    if args.listFormats:
+        print("Available audio formats:")
+        print(
+            "- best (default, auto-selects the best format)\n- aac\n- alac\n- flac\n- m4a\n- mp3\n- opus\n- vorbis\n- wav",
+            "Metadata is only embedded in opus and mp3 formats due to mutagen limitations.",
+        )
+        return
+
+    if args.single:
+        if args.format == "audio":
+            format = args.audio_format
+            audio_main(args.single, args.output, format)
+        else:
+            video_main(args.single, args.output, args.format)
+    elif args.playlist:
+        yt_play = Playlist(args.playlist)
+        print(f"Downloading {len(yt_play.video_urls)} videos")
+        if args.format == "audio":
+            format = args.audio_format
+            for video in yt_play.videos:
+                audio_main(video.watch_url, args.output, format)
+        else:
+            for video in yt_play.videos:
+                video_main(video.watch_url, args.output, args.format)
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    cli()

sgithidownloader-1.0.0/sgithidownloader/audio.py

@@ -0,0 +1,115 @@
+import requests, base64, os
+import yt_dlp, re
+from mutagen.oggopus import OggOpus
+from mutagen.easyid3 import EasyID3
+from mutagen.id3 import ID3, APIC
+from mutagen.flac import Picture
+from PIL import Image
+
+from sgithidownloader.shared import *
+
+EasyID3.RegisterTextKey("description", "COMM")
+
+
+def crop_thumbnail_for_audio_file(image_file_path):
+    image_file = Image.open(image_file_path)
+    width, height = image_file.size
+    # Assuming width > height, crop to square
+    if width > height:
+        left = (width - height) // 2
+        top = 0
+        right = left + height
+        bottom = height
+    else:
+        # If height > width, but in this case it's not
+        top = (height - width) // 2
+        left = 0
+        bottom = top + width
+        right = width
+    cropped_img = image_file.crop((left, top, right, bottom))
+    cropped_img.save(image_file_path)
+    print(f"Cropped thumbnail to square: {image_file_path}")
+
+
+def download_audio_file(url: str, output, format="best"):
+    ydl_opts = {
+        "format": "bestaudio/best",
+        "embed-metadata": True,
+        "add-metadata": True,
+        "continuedl": False,
+        "outtmpl": os.path.join(output, "%(title)s [%(id)s]"),
+        "postprocessors": [
+            {
+                "key": "FFmpegExtractAudio",
+                "preferredcodec": format,
+                "preferredquality": "0",  # 0 is best
+            }
+        ],
+    }
+    with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+        info = ydl.extract_info(url, download=True)
+        filename = ydl.prepare_filename(info)
+        print(f"Downloaded: {filename}")
+        return f"{filename}.{format if format != 'best' else 'opus'}", info
+
+
+def embed_image_in_audio_file(audio_file_path, image_file_path, info):
+    try:
+        with open(image_file_path, "rb") as f:
+            image_data = f.read()
+
+        cover_art = Picture()
+        cover_art.data = image_data
+        cover_art.type = 3
+
+        encoded_picture = base64.b64encode(cover_art.write()).decode("ascii")
+        if audio_file_path.endswith(".mp3"):
+            # Use EasyID3 for text metadata
+            audio_file = EasyID3(audio_file_path)
+            audio_file["title"] = info.get("title", "")
+            audio_file["artist"] = info.get("uploader", "")
+            audio_file["album"] = info.get("album", "")
+            audio_file["date"] = str(info.get("upload_date", ""))
+            audio_file["description"] = info.get("description", "")
+            audio_file.save()
+
+            # Use ID3 for picture
+            id3 = ID3(audio_file_path)
+            id3.add(
+                APIC(
+                    encoding=3, mime="image/jpeg", type=3, desc="Cover", data=image_data
+                )
+            )
+            id3.save()
+        elif audio_file_path.endswith(".opus"):
+            audio_file = OggOpus(audio_file_path)
+            audio_file["metadata_block_picture"] = encoded_picture
+            audio_file["title"] = info.get("title", "")
+            audio_file["artist"] = info.get("uploader", "")
+            audio_file["album"] = info.get("album", "")
+            audio_file["date"] = str(info.get("upload_date", ""))
+            audio_file["description"] = info.get("description", "")
+            audio_file.save()
+        else:
+            print(
+                f"Unsupported format for embedding metadata: {audio_file_path}. Skipping metadata embedding."
+            )
+            return
+
+        print(f"Successfully embedded metadata and image into {audio_file_path}")
+
+    except FileNotFoundError:
+        print(
+            f"Error: Make sure files '{audio_file_path}' and '{image_file_path}' exist."
+        )
+    except Exception as e:
+        print(f"An error occurred: {e}")
+
+def audio_main(url, output="./", format="best"):
+    audio_file_path, info = download_audio_file(url, output, format)
+    image_file_path = grab_thumb(url, output)
+    crop_thumbnail_for_audio_file(image_file_path)
+    embed_image_in_audio_file(audio_file_path, image_file_path, info)
+    if os.path.exists(image_file_path):
+        os.remove(image_file_path)
+        print(f"Deleted thumbnail file {image_file_path}")

sgithidownloader-1.0.0/sgithidownloader/shared.py

@@ -0,0 +1,24 @@
+
+import requests, re
+
+def get_video_id(url):
+    youtube_regex = r"v=([^&]+)"
+    match = re.search(youtube_regex, url)
+    if match:
+        return match.group(1)
+    else:
+        return None
+
+def grab_thumb(url: str, output) -> str:
+    videoId = get_video_id(url)
+    url = f"http://img.youtube.com/vi/{videoId}/maxresdefault.jpg"
+    response = requests.get(url)
+    if response.status_code == 200:
+        image_file_path = f"{output}{videoId}_thumb.jpg"
+        with open(image_file_path, "wb") as f:
+            f.write(response.content)
+        print("Thumbnail downloaded")
+        return image_file_path
+    else:
+        print("Failed to download thumbnail")
+        return -1

sgithidownloader-1.0.0/sgithidownloader/video.py

@@ -0,0 +1,23 @@
+import os
+import yt_dlp
+
+def download_video_file(url: str, output, format="mp4"):
+    ydl_opts = {
+        "format": f"bestvideo[ext={format}]+bestaudio/best[ext={format}]/best",
+        "embed-metadata": True,
+        "add-metadata": True,
+        "continuedl": False,
+        "outtmpl": os.path.join(output, "%(title)s [%(id)s]"),
+    }
+    with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+        info = ydl.extract_info(url, download=True)
+        filename = ydl.prepare_filename(info)
+        print(f"Downloaded: {filename}")
+        return f"{filename}.{format}", info
+
+def video_main(url, output="./", format="mp4"):
+    try:
+        video_file_path, info = download_video_file(url, output, format)
+        print(f"Video downloaded successfully: {video_file_path}")
+    except Exception as e:
+        print(f"An error occurred while downloading the video: {e}")