{"id":19816930,"url":"https://github.com/flyingfathead/youclipper","last_synced_at":"2025-07-06T10:03:59.122Z","repository":{"id":226491856,"uuid":"768840111","full_name":"FlyingFathead/youclipper","owner":"FlyingFathead","description":"A quick `yt-dlp` and `ffmpeg` utilizing Python tool to clip a i.e. a YouTube video","archived":false,"fork":false,"pushed_at":"2024-05-30T15:59:47.000Z","size":31,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-02T07:39:50.762Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FlyingFathead.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-07T20:42:17.000Z","updated_at":"2024-07-24T21:57:24.000Z","dependencies_parsed_at":"2024-05-30T13:15:11.341Z","dependency_job_id":"a2bbd0ba-0bdd-46c2-abe2-a3a1a38b69e2","html_url":"https://github.com/FlyingFathead/youclipper","commit_stats":null,"previous_names":["flyingfathead/youclipper"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/FlyingFathead/youclipper","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlyingFathead%2Fyouclipper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlyingFathead%2Fyouclipper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlyingFathead%2Fyouclipper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlyingFathead%2Fyouclipper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FlyingFathead","download_url":"https://codeload.github.com/FlyingFathead/youclipper/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FlyingFathead%2Fyouclipper/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263882260,"owners_count":23524459,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-12T10:11:06.226Z","updated_at":"2025-07-06T10:03:59.104Z","avatar_url":"https://github.com/FlyingFathead.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# youclipper\n\n`youclipper` is a Python-based command-line tool that leverages `yt-dlp` and `ffmpeg` to download and clip sections from online videos, such as those available on YouTube. It allows you to specify the exact start and end times, even down to milliseconds, to get the precise clip you need. You can also use the included `yousubtitler` to automatically create hard subtitles for your created clips.\n\n## Features\n\n- Download videos from YouTube and other platforms supported by `yt-dlp`.\n- Clip videos to your specified start and end times with support for millisecond precision.\n- Output your clip directly to a specified filename.\n- Subtitle your clips with word-level highlighting.\n\n## Installation\n\nBefore you use `youclipper`, ensure you have the following dependencies installed (or use the included `requirements.txt` with `pip install -r requirements.txt`):\n\n- Python 3\n- `yt-dlp`\n- `ffmpeg`\n- `openai-whisper` (or `whisperx`)\n- `moviepy`\n\nYou can install `yt-dlp` and `ffmpeg` using your operating system's package manager or download them directly from their official websites.\n\nHere's how you can install `ffmpeg` on commonly used operating systems:\n\n```bash\n# On Ubuntu or Debian\nsudo apt update \u0026\u0026 sudo apt install ffmpeg\n\n# On Windows using Chocolatey\nchoco install ffmpeg\n\n# On MacOS using Homebrew\nbrew install ffmpeg\n```\n\n### Optional Dependencies\n\nTo install optional dependencies like `whisperx`, run:\n\n```sh\npip install git+https://github.com/m-bain/whisperx.git\n```\n\n## Usage\n\nTo view all available commands and their descriptions, you can use the `--help` flag:\n\n```bash\npython youclipper.py --help\n```\n\n### Basic Clipping\n\nTo clip a video without specifying milliseconds:\n\n```bash\npython youclipper.py --url \u003cvideo-url\u003e --start mm:ss --end mm:ss --output \u003coutput-filename\u003e\n```\n\n### Clipping with Millisecond Precision\n\nTo clip a video and specify times down to the millisecond:\n\n```bash\npython youclipper.py --url \u003cvideo-url\u003e --start mm:ss.xxx --end mm:ss.xxx --output \u003coutput-filename\u003e\n```\n\nNote: Replace \u003cvideo-url\u003e with the actual URL of the video you wish to clip, mm:ss with the start and end times in minutes and seconds, xxx with milliseconds, and \u003coutput-filename\u003e with the desired name of your output file (without adding the .mp4 extension, as it is appended automatically).\n\n### Subtitling Your Clips\n\nYou can use the included yousubtitler.py to subtitle your videos. This requires `ImageMagick` as well as the `moviepy` and `openai-whisper` (or `whisperx`) pip packages:\n\n```bash\npython yousubtitler.py inputfile.mp4\n```\n\nThis will automatically create a subtitled version of your clip which will be in the format: `\u003coriginal_filename\u003e_subtitled.mp4`.\n\n### Configuration Flag for Subtitling\n\nTo choose between `openai-whisper` and `whisperx` for subtitling, set the `USE_WHISPERX` flag in `yousubtitler.py`:\n\n```python\n# yousubtitler.py\nUSE_WHISPERX = True  # Set to False to use OpenAI's Whisper\n```\n\n## Changelog\n- v0.14 - (yousubtitler) ditched pydub; using ffmpeg for all audio+video from now on\n- v0.13 - (yousubtitler) normalize audio to -0.1dBFS by default (can be set via true/false on `NORMALIZE_AUDIO` variable)\n- v0.12 - (yousubtitler) text animations (can be configured from `yousubtitler.py`)\n- v0.11 - (yousubtitler) added confirmation prompts for all subtitle entries + confirm overwrites\n- v0.10 - (yousubtitler) check for CUDA compatible GPU availablility on launch\n- v0.09 - (yousubtitler) added support for word-level highlighting subtitles using `whisperx` or `openai-whisper`.\n- v0.08 - (yousubtitler) included `yousubtitler.py` for quick, automatic hard subtitling of clips\n- v0.07 - (youclipper) recode instead of copying when clipping to avoid video/audio desync issues\n- v0.06 - (youclipper) first public release\n\n## Contributing\n\nContributions to youclipper are welcome! If you have suggestions for improvements or encounter any issues, please open an issue or submit a pull request.\n\n## About\n\nDeveloped by FlyingFathead, with ghostcode by ChaosWhisperer.\n- [FlyingFathead on GitHub](https://github.com/FlyingFathead/)\n- [youclipper on GitHub](https://github.com/FlyingFathead/youclipper)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflyingfathead%2Fyouclipper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflyingfathead%2Fyouclipper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflyingfathead%2Fyouclipper/lists"}