riptube 0.1.0__tar.gz

riptube-0.1.0/LICENSE

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

riptube-0.1.0/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: riptube
+Version: 0.1.0
+Summary: YouTube video downloader with best quality
+Author: tsilva
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/tsilva/riptube
+Project-URL: Bug Tracker, https://github.com/tsilva/riptube/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: yt-dlp>=2023.0.0
+Dynamic: license-file
+
+<div align="center">
+  <img src="logo.png" alt="riptube" width="512"/>
+
+  # riptube
+
+  [![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://www.python.org/)
+  [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+  [![yt-dlp](https://img.shields.io/badge/Powered%20by-yt--dlp-red.svg)](https://github.com/yt-dlp/yt-dlp)
+
+  **📺 Download YouTube videos and extract audio with one command 🎵**
+
+  [Installation](#installation) · [Usage](#usage) · [Options](#options)
+</div>
+
+## Overview
+
+[![CI](https://github.com/tsilva/riptube/actions/workflows/release.yml/badge.svg)](https://github.com/tsilva/riptube/actions/workflows/release.yml)
+
+A CLI tool for downloading YouTube videos and extracting audio tracks. Built on top of yt-dlp, it handles the complexities of video downloading with automatic format selection, audio extraction, and cookie support for restricted content.
+
+## Features
+
+- **Best quality by default** - Automatically selects the highest available video and audio quality
+- **Audio extraction** - Extract audio tracks as MP3 files with a single flag
+- **Cookie support** - Access age-restricted or private videos using browser cookies
+- **Clean filenames** - Automatic sanitization of video titles for safe file names
+
+## Installation
+
+```bash
+pipx install riptube
+```
+
+### Development install with uv
+
+```bash
+uv tool install . --editable
+```
+
+The package is published on PyPI as `riptube`, and the installed command is `riptube`.
+
+### Dependencies
+
+| Dependency | Required | Purpose |
+|------------|----------|---------|
+| FFmpeg | Yes | Video/audio processing and merging |
+| aria2 | No | Faster downloads (optional) |
+
+**macOS:**
+```bash
+brew install ffmpeg aria2
+```
+
+**Linux:**
+```bash
+sudo apt install ffmpeg aria2
+```
+
+**Windows:**
+Download FFmpeg from [ffmpeg.org](https://ffmpeg.org/download.html)
+
+## Usage
+
+### Download a video
+
+```bash
+riptube https://www.youtube.com/watch?v=dQw4w9WgXcQ
+```
+
+### Specify output file
+
+```bash
+riptube https://www.youtube.com/watch?v=dQw4w9WgXcQ -o video.mp4
+```
+
+### Extract audio only
+
+```bash
+riptube https://www.youtube.com/watch?v=dQw4w9WgXcQ -a
+```
+
+### Use cookies for restricted videos
+
+```bash
+riptube https://www.youtube.com/watch?v=dQw4w9WgXcQ -c cookies.txt
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-o, --output` | Output file path (default: auto-generated from video title) |
+| `-a, --audio` | Extract audio track as MP3 |
+| `-c, --cookies` | Path to Netscape format cookies.txt file |
+
+## Development
+
+```bash
+# Clone and install in development mode
+git clone https://github.com/tsilva/riptube.git
+cd riptube
+uv tool install . --editable
+
+# Or install with pipx
+pipx install . --force
+
+# Run directly without installing
+python -m riptube.cli <url>
+```
+
+## Releases
+
+Bumping the version in `pyproject.toml` on `main` triggers the release workflow, which builds the package, publishes it to PyPI, and then creates the matching GitHub release. The workflow can also be re-run manually from GitHub via `workflow_dispatch`.
+
+## License
+
+[MIT](LICENSE)

riptube-0.1.0/README.md

@@ -0,0 +1,117 @@
+<div align="center">
+  <img src="logo.png" alt="riptube" width="512"/>
+
+  # riptube
+
+  [![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://www.python.org/)
+  [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+  [![yt-dlp](https://img.shields.io/badge/Powered%20by-yt--dlp-red.svg)](https://github.com/yt-dlp/yt-dlp)
+
+  **📺 Download YouTube videos and extract audio with one command 🎵**
+
+  [Installation](#installation) · [Usage](#usage) · [Options](#options)
+</div>
+
+## Overview
+
+[![CI](https://github.com/tsilva/riptube/actions/workflows/release.yml/badge.svg)](https://github.com/tsilva/riptube/actions/workflows/release.yml)
+
+A CLI tool for downloading YouTube videos and extracting audio tracks. Built on top of yt-dlp, it handles the complexities of video downloading with automatic format selection, audio extraction, and cookie support for restricted content.
+
+## Features
+
+- **Best quality by default** - Automatically selects the highest available video and audio quality
+- **Audio extraction** - Extract audio tracks as MP3 files with a single flag
+- **Cookie support** - Access age-restricted or private videos using browser cookies
+- **Clean filenames** - Automatic sanitization of video titles for safe file names
+
+## Installation
+
+```bash
+pipx install riptube
+```
+
+### Development install with uv
+
+```bash
+uv tool install . --editable
+```
+
+The package is published on PyPI as `riptube`, and the installed command is `riptube`.
+
+### Dependencies
+
+| Dependency | Required | Purpose |
+|------------|----------|---------|
+| FFmpeg | Yes | Video/audio processing and merging |
+| aria2 | No | Faster downloads (optional) |
+
+**macOS:**
+```bash
+brew install ffmpeg aria2
+```
+
+**Linux:**
+```bash
+sudo apt install ffmpeg aria2
+```
+
+**Windows:**
+Download FFmpeg from [ffmpeg.org](https://ffmpeg.org/download.html)
+
+## Usage
+
+### Download a video
+
+```bash
+riptube https://www.youtube.com/watch?v=dQw4w9WgXcQ
+```
+
+### Specify output file
+
+```bash
+riptube https://www.youtube.com/watch?v=dQw4w9WgXcQ -o video.mp4
+```
+
+### Extract audio only
+
+```bash
+riptube https://www.youtube.com/watch?v=dQw4w9WgXcQ -a
+```
+
+### Use cookies for restricted videos
+
+```bash
+riptube https://www.youtube.com/watch?v=dQw4w9WgXcQ -c cookies.txt
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-o, --output` | Output file path (default: auto-generated from video title) |
+| `-a, --audio` | Extract audio track as MP3 |
+| `-c, --cookies` | Path to Netscape format cookies.txt file |
+
+## Development
+
+```bash
+# Clone and install in development mode
+git clone https://github.com/tsilva/riptube.git
+cd riptube
+uv tool install . --editable
+
+# Or install with pipx
+pipx install . --force
+
+# Run directly without installing
+python -m riptube.cli <url>
+```
+
+## Releases
+
+Bumping the version in `pyproject.toml` on `main` triggers the release workflow, which builds the package, publishes it to PyPI, and then creates the matching GitHub release. The workflow can also be re-run manually from GitHub via `workflow_dispatch`.
+
+## License
+
+[MIT](LICENSE)

riptube-0.1.0/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "riptube"
+version = "0.1.0"
+description = "YouTube video downloader with best quality"
+authors = [
+    {name = "tsilva"}
+]
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "yt-dlp>=2023.0.0",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/tsilva/riptube"
+"Bug Tracker" = "https://github.com/tsilva/riptube/issues"
+
+[project.scripts]
+riptube = "riptube.cli:main"
+
+[tool.setuptools]
+packages = ["riptube"]
+
+[tool.pipx]
+install-deps = true
+python-version = ">=3.9"
+external-dependencies = {ffmpeg = "ffmpeg -version"}
+venv-provision-command = """
+pip install --upgrade pip
+python -c "import platform; import sys; exit('Not on Linux' != 'Linux' and 0 or 1)" || pip install aria2
+"""
+
+[tool.ruff]
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I"]

riptube-0.1.0/riptube/__init__.py

@@ -0,0 +1,3 @@
+from .downloader import download_video as download_video
+
+__version__ = "0.1.0"

riptube-0.1.0/riptube/cli.py

@@ -0,0 +1,38 @@
+#!/usr/bin/env python3
+import argparse
+import sys
+
+from .downloader import download_video
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Download YouTube videos with best quality")
+    parser.add_argument("url", help="YouTube video URL to download")
+    parser.add_argument(
+        "-c",
+        "--cookies",
+        dest="cookies_file",
+        help="Path to a Netscape format cookies.txt file",
+        default=None,
+    )
+    parser.add_argument(
+        "-o",
+        "--output",
+        help="Output file path (default: auto-generated from video title)",
+        default=None,
+    )
+    parser.add_argument(
+        "-a",
+        "--audio",
+        dest="audio_only",
+        help="Extract audio track as MP3 file",
+        action="store_true",
+    )
+    args = parser.parse_args()
+
+    success = download_video(args.url, args.cookies_file, args.output, args.audio_only)
+    sys.exit(0 if success else 1)
+
+
+if __name__ == "__main__":
+    main()

riptube-0.1.0/riptube/downloader.py

@@ -0,0 +1,103 @@
+#!/usr/bin/env python3
+
+import glob
+import os
+import re
+import shutil
+import sys
+
+import yt_dlp
+
+
+def sanitize_filename(filename):
+    """Sanitize filename to remove special characters that might cause issues."""
+    sanitized = re.sub(r'[\\/*?:"<>|]', '_', filename)
+    sanitized = re.sub(r'_+', '_', sanitized)
+    return sanitized.strip('_')
+
+def check_python_version():
+    if sys.version_info < (3, 9):
+        print("Warning: Python 3.8 is deprecated. Please use Python 3.9 or higher.")
+
+def check_dependencies():
+    if not shutil.which('ffmpeg'):
+        print("Warning: FFmpeg not found. Install with:")
+        print("  sudo apt install ffmpeg")
+    # aria2c is optional, not needed for yt-dlp to work basically
+
+def cleanup_part_files(directory="."):
+    part_files = glob.glob(os.path.join(directory, "*.part"))
+    for part_file in part_files:
+        try:
+            os.remove(part_file)
+            print(f"Removed leftover part file: {os.path.basename(part_file)}")
+        except Exception as e:
+            print(f"Could not remove {part_file}: {e}")
+
+def download_video(url, cookies_file=None, output=None, audio_only=False):
+    """
+    Download a video from YouTube with given parameters.
+    
+    Args:
+        url (str): YouTube video URL
+        cookies_file (str, optional): Path to a Netscape format cookies.txt file
+        output (str, optional): Output file path template
+        audio_only (bool, optional): Extract audio as MP3
+    
+    Returns:
+        bool: True if download was successful, False otherwise
+    """
+    check_python_version()
+    check_dependencies()
+
+    cleanup_part_files()
+
+    # Set yt-dlp options
+    ydl_opts = {
+        'format': 'bestaudio/best' if audio_only else 'bestvideo+bestaudio/best',
+        'merge_output_format': 'mkv',  # yt-dlp merges to mkv by default
+        'quiet': False,
+        'no_warnings': False,
+        'verbose': True,
+    }
+    
+    # Add output template if specified
+    if output:
+        ydl_opts['outtmpl'] = output
+    else:
+        ydl_opts['outtmpl'] = '%(title)s [%(id)s].%(ext)s'
+    
+    # Add cookies file if specified
+    if cookies_file:
+        if os.path.isfile(cookies_file):
+            ydl_opts['cookiefile'] = cookies_file
+        else:
+            print(f"Warning: Cookies file not found: {cookies_file}")
+    
+    # Configure audio extraction if requested
+    if audio_only:
+        ydl_opts['postprocessors'] = [{
+            'key': 'FFmpegExtractAudio',
+            'preferredcodec': 'mp3',
+            'preferredquality': '192',
+        }]
+
+    try:
+        with yt_dlp.YoutubeDL(ydl_opts) as ydl:
+            print(f"Downloading: {url}")
+            ydl.download([url])
+            return True
+    except Exception as e:
+        print(f"Download failed: {e}")
+        return False
+    finally:
+        cleanup_part_files()
+
+if __name__ == '__main__':
+    if len(sys.argv) < 2:
+        print("Usage: python3 youtube_downloader.py <YouTube URL>")
+        sys.exit(1)
+
+    url = sys.argv[1]
+    success = download_video(url)
+    sys.exit(0 if success else 1)

riptube-0.1.0/riptube.egg-info/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: riptube
+Version: 0.1.0
+Summary: YouTube video downloader with best quality
+Author: tsilva
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/tsilva/riptube
+Project-URL: Bug Tracker, https://github.com/tsilva/riptube/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: yt-dlp>=2023.0.0
+Dynamic: license-file
+
+<div align="center">
+  <img src="logo.png" alt="riptube" width="512"/>
+
+  # riptube
+
+  [![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://www.python.org/)
+  [![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+  [![yt-dlp](https://img.shields.io/badge/Powered%20by-yt--dlp-red.svg)](https://github.com/yt-dlp/yt-dlp)
+
+  **📺 Download YouTube videos and extract audio with one command 🎵**
+
+  [Installation](#installation) · [Usage](#usage) · [Options](#options)
+</div>
+
+## Overview
+
+[![CI](https://github.com/tsilva/riptube/actions/workflows/release.yml/badge.svg)](https://github.com/tsilva/riptube/actions/workflows/release.yml)
+
+A CLI tool for downloading YouTube videos and extracting audio tracks. Built on top of yt-dlp, it handles the complexities of video downloading with automatic format selection, audio extraction, and cookie support for restricted content.
+
+## Features
+
+- **Best quality by default** - Automatically selects the highest available video and audio quality
+- **Audio extraction** - Extract audio tracks as MP3 files with a single flag
+- **Cookie support** - Access age-restricted or private videos using browser cookies
+- **Clean filenames** - Automatic sanitization of video titles for safe file names
+
+## Installation
+
+```bash
+pipx install riptube
+```
+
+### Development install with uv
+
+```bash
+uv tool install . --editable
+```
+
+The package is published on PyPI as `riptube`, and the installed command is `riptube`.
+
+### Dependencies
+
+| Dependency | Required | Purpose |
+|------------|----------|---------|
+| FFmpeg | Yes | Video/audio processing and merging |
+| aria2 | No | Faster downloads (optional) |
+
+**macOS:**
+```bash
+brew install ffmpeg aria2
+```
+
+**Linux:**
+```bash
+sudo apt install ffmpeg aria2
+```
+
+**Windows:**
+Download FFmpeg from [ffmpeg.org](https://ffmpeg.org/download.html)
+
+## Usage
+
+### Download a video
+
+```bash
+riptube https://www.youtube.com/watch?v=dQw4w9WgXcQ
+```
+
+### Specify output file
+
+```bash
+riptube https://www.youtube.com/watch?v=dQw4w9WgXcQ -o video.mp4
+```
+
+### Extract audio only
+
+```bash
+riptube https://www.youtube.com/watch?v=dQw4w9WgXcQ -a
+```
+
+### Use cookies for restricted videos
+
+```bash
+riptube https://www.youtube.com/watch?v=dQw4w9WgXcQ -c cookies.txt
+```
+
+## Options
+
+| Option | Description |
+|--------|-------------|
+| `-o, --output` | Output file path (default: auto-generated from video title) |
+| `-a, --audio` | Extract audio track as MP3 |
+| `-c, --cookies` | Path to Netscape format cookies.txt file |
+
+## Development
+
+```bash
+# Clone and install in development mode
+git clone https://github.com/tsilva/riptube.git
+cd riptube
+uv tool install . --editable
+
+# Or install with pipx
+pipx install . --force
+
+# Run directly without installing
+python -m riptube.cli <url>
+```
+
+## Releases
+
+Bumping the version in `pyproject.toml` on `main` triggers the release workflow, which builds the package, publishes it to PyPI, and then creates the matching GitHub release. The workflow can also be re-run manually from GitHub via `workflow_dispatch`.
+
+## License
+
+[MIT](LICENSE)

riptube-0.1.0/riptube.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+riptube/__init__.py
+riptube/cli.py
+riptube/downloader.py
+riptube.egg-info/PKG-INFO
+riptube.egg-info/SOURCES.txt
+riptube.egg-info/dependency_links.txt
+riptube.egg-info/entry_points.txt
+riptube.egg-info/requires.txt
+riptube.egg-info/top_level.txt

riptube-0.1.0/riptube.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

riptube-0.1.0/riptube.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+riptube = riptube.cli:main

riptube-0.1.0/riptube.egg-info/requires.txt

@@ -0,0 +1 @@
+yt-dlp>=2023.0.0

riptube-0.1.0/riptube.egg-info/top_level.txt

@@ -0,0 +1 @@
+riptube

riptube-0.1.0/setup.cfg

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

riptube-0.1.0/setup.py

@@ -0,0 +1,5 @@
+from setuptools import setup
+
+# This setup.py file is maintained for backward compatibility
+# The primary configuration is now in pyproject.toml
+setup()