Skip to content
Back to search

youtube-hunter

YouTube Hunter — record YouTube live streams, download videos, cut them into 9:16 Shorts with karaoke subtitles, write trend-based titles/descriptions/tags in any language, and auto-upload to YouTube. Use for "youtube hunter", "record the stream", "make shorts from this video", "trend tags", "upload to youtube", "auto mode".

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/shuxratmusaev1990-design--youtube-hunter/badge.svg)](/listings/shuxratmusaev1990-design--youtube-hunter)

HTML

<a href="/listings/shuxratmusaev1990-design--youtube-hunter"><img src="/api/listings/shuxratmusaev1990-design--youtube-hunter/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 107 lines
  1. ---
  2. name: youtube-hunter
  3. description: YouTube Hunter — record YouTube live streams, download videos, cut them into 9:16 Shorts with karaoke subtitles, write trend-based titles/descriptions/tags in any language, and auto-upload to YouTube. Use for "youtube hunter", "record the stream", "make shorts from this video", "trend tags", "upload to youtube", "auto mode".
  4. ---
  5. # YouTube Hunter
  6. Reply in the user's language. Everything lives in `~/youtube-hunter/` (Windows: `%USERPROFILE%\youtube-hunter`).
  7. This skill's folder (the folder containing this SKILL.md, below called `SKILL_DIR`) holds the installers and scripts.
  8. ## 0. Where it runs
  9. Run on the user's own computer or server (Claude Code, a desktop shell, or a VPS).
  10. Sandboxed cloud environments usually block YouTube, so recording, downloading and uploading will not work there:
  11. in that case give the user this skill folder (or the GitHub repo) and walk them through running it locally.
  12. ## 1. Install (once) — do this first
  13. Check whether it is installed: `~/youtube-hunter/hunter` (Mac/Linux) or `%USERPROFILE%\youtube-hunter\hunter.bat` (Windows).
  14. If missing, run the installer from `SKILL_DIR`:
  15. | OS | Command |
  16. |---|---|
  17. | Windows | `"SKILL_DIR\install.bat"` (or the user double-clicks it) |
  18. | Mac / Linux | `bash "SKILL_DIR/install.sh"` |
  19. The installer installs/checks everything and prints a check at the end:
  20. | What | Why | How it is installed |
  21. |---|---|---|
  22. | Python 3.10+ | runs the scripts | winget (Windows), brew (Mac), apt/dnf/pacman (Linux) |
  23. | FFmpeg | cut, 9:16, subtitles, audio | winget / brew / apt |
  24. | Python venv `~/youtube-hunter/.venv` | isolated libraries | `python -m venv` |
  25. | yt-dlp | record live streams, download videos, trend search | pip |
  26. | faster-whisper | speech-to-text with word timings (auto language detection) | pip |
  27. | requests | YouTube Data API trend queries | pip |
  28. | google-api-python-client, google-auth-oauthlib, google-auth-httplib2 | upload to YouTube | pip |
  29. | anthropic | optional: Claude picks clips in auto mode | pip |
  30. It also copies the scripts to `~/youtube-hunter/scripts/`, creates `config.json` (from `config.example.json`),
  31. `.env` (from `.env.example`, empty keys) and the `hunter` / `hunter.bat` command.
  32. First transcription downloads the Whisper model (~3 GB for `large-v3`; use `medium`/`small` in config on weak PCs).
  33. If the installer fails, read its output, fix the one missing piece, and re-run it (it is safe to re-run).
  34. ## 2. Connect YouTube (once, only needed for uploading)
  35. Walk the user through this; never ask them to paste secrets into the chat.
  36. 1. https://console.cloud.google.com → create a project → APIs & Services → Library → enable **YouTube Data API v3**.
  37. 2. Google Auth Platform / OAuth consent screen → External → app name, support email → **Test users**: add the
  38. Google account that owns the channel.
  39. 3. Clients / Credentials → Create OAuth client ID → **Desktop app** → **Download JSON**.
  40. 4. Save it as `~/youtube-hunter/client_secret.json`. First upload opens the browser for consent; `token.json` is saved.
  41. Notes: while the app is in "Testing", Google may expire the consent after about a week (re-consent, or publish the app).
  42. Videos uploaded from an unverified API project may stay private until Google's audit. The daily API quota is limited;
  43. `max_uploads_per_day` (default 6) respects it.
  44. Optional keys go in `~/youtube-hunter/.env` (the user fills them in themselves):
  45. - `YT_API_KEY` — faster, more accurate trend data (without it, yt-dlp search is used).
  46. - `ANTHROPIC_API_KEY` — in unattended auto mode, Claude picks the clips and writes metadata (without it, a heuristic is used).
  47. ## 3. Commands
  48. Mac/Linux: `~/youtube-hunter/hunter <cmd> ...` · Windows: `%USERPROFILE%\youtube-hunter\hunter.bat <cmd> ...`
  49. | Task | Command |
  50. |---|---|
  51. | Record a live stream in chunks | `hunter record URL [--segment 600] [--wait]` (URL = stream or `https://www.youtube.com/@channel/live`) |
  52. | Record a live stream from its start | `hunter record URL --from-start` (needs DVR on the stream) |
  53. | Download a video / playlist / channel | `hunter download URL [--max 5] [--after 20261101]` |
  54. | Transcribe | `hunter transcribe VIDEO [--lang auto]` → `.words.json`, `.transcript.txt` |
  55. | Make one Short | `hunter short VIDEO --start S --end E --out x.mp4 --words VIDEO.words.json --hook "text" [--layout blur\|crop\|fit]` |
  56. | Trend research | `hunter trends "topic" [--days 30] [--region US] [--lang en]` (no region = worldwide) |
  57. | Upload | `hunter upload x.mp4 --meta x.json --shorts [--publish-at 2026-12-01T15:00:00Z]` |
  58. | Full auto, one file | `hunter auto process VIDEO [--topic "..."] [--region US] [--no-upload]` |
  59. | Full auto, watch channels | `hunter auto watch [--interval 300] [--no-upload]` |
  60. Downloads go to `~/youtube-hunter/downloads/`, live chunks to `live/`, finished Shorts to `shorts/` (or `queue/` with `--no-upload`).
  61. ## 4. Best-quality workflow (Claude drives it)
  62. 1. **Source:** live stream → `hunter record`; normal video → `hunter download`.
  63. 2. **Transcribe:** `hunter transcribe`, then read the `.transcript.txt` yourself.
  64. 3. **Pick moments yourself:** 3–7 clips, `short_min_sec`–`short_max_sec` (default 20–59 s); strong hook in the
  65. first 2 seconds, one complete idea, no cut mid-sentence, no overlap. Show the list (times, hook, why).
  66. 4. **Edit:** `hunter short` for each (`--hook` = 3–6 on-screen words). Extract one frame with ffmpeg and look at it.
  67. 5. **Trends:** `hunter trends "<topic>" --lang <lang> [--region <country>]`.
  68. 6. **Metadata:** write a `meta.json` per Short: `title` ≤70 chars (keyword + curiosity), `description` 2–3 sentences
  69. + 3–5 hashtags incl. `#Shorts`, `tags` 10–15 (trend + specific). No clickbait the clip does not deliver.
  70. Language = `output_language` (auto = the video's language).
  71. 7. **Confirm:** show the Shorts, texts and schedule to the user. Do not upload until they say so.
  72. 8. **Upload:** `hunter upload ... --shorts`; several Shorts → spread them with `--publish-at` 3–4 hours apart.
  73. ## 5. Auto mode
  74. `hunter auto watch` checks `channels_to_watch` every 5 minutes: records live streams, processes finished chunks
  75. and new uploads → Shorts → trend metadata → scheduled upload (`privacy`, `schedule_every_hours`,
  76. `max_uploads_per_day` from config). Recommend `--no-upload` for the first week so the user reviews `queue/`.
  77. Keep it running: Windows Task Scheduler, Mac/Linux `tmux`/`nohup`/`systemd`, or a VPS.
  78. State is in `state.json`; upload log in `uploads.jsonl`.
  79. ## 6. Any audience
  80. Nothing is tied to one language or country. `language: auto` lets Whisper detect the video language;
  81. `output_language` sets the metadata language (e.g. Russian video, English titles: `en`);
  82. `trend_region` empty = worldwide, or a country code (`US`, `IN`, `BR`, `UZ`...). If the user names an audience,
  83. set `--lang` / `--region` / `output_language` for that run. For several languages, write one `meta.json` per language.
  84. ## 7. Rules
  85. - Only use the user's own content or content they have permission to reuse. Re-uploading other people's videos
  86. without permission leads to copyright strikes — say so plainly when relevant.
  87. - Default `privacy: private`; switch to `public` only when the user explicitly asks.
  88. - Never print, copy into chat, or commit `client_secret.json`, `token.json`, `.env` or cookies.
  89. - Troubleshooting order: `hunter` venv `python -m pip install -U yt-dlp` → cookies (`config.json` → `cookies`,
  90. a `cookies.txt` exported from the browser) → FFmpeg/Python versions → re-run the installer.
README.md · README · 109 lines
  1. # 🎯 YouTube Hunter
  2. YouTube jonli efirlarini yozib oladi, videolarni yuklab oladi, ulardan **9:16 Shorts** yasaydi (karaoke subtitr, hook yozuvi, ovozni tekislash), **trend asosida** nom/tavsif/teg yozadi va **YouTube'ga avtomatik joylaydi**. Har qanday til va auditoriya uchun.
  3. Claude skill sifatida ham, oddiy buyruqlar to'plami sifatida ham ishlaydi.
  4. *English summary below.*
  5. ---
  6. ## Imkoniyatlar
  7. | | |
  8. |---|---|
  9. | 🔴 Jonli efir | Efirni bo'laklab yozadi, uzilsa qayta ulanadi; efirni boshidan yozish ham mumkin |
  10. | ⬇️ Yuklab olish | Bitta video, playlist yoki butun kanal; qayta yuklamaydi |
  11. | 🗣 Transkripsiya | faster-whisper, so'zma-so'z vaqt, **tilni o'zi aniqlaydi** |
  12. | ✂️ Shorts | 9:16 (xira fon / kesish / qora chiziq), karaoke subtitr, hook, loudnorm |
  13. | 📈 Trend | Mavzu bo'yicha oxirgi 30 kundagi top videolar, teglar, sarlavha so'zlari (dunyo yoki davlat bo'yicha) |
  14. | 🚀 Joylash | YouTube Data API, jadval (`publishAt`), kunlik limit |
  15. | 🤖 Avtomat | Kanallarni kuzatadi: efir / yangi video → Shorts → matn → joylash |
  16. ## O'rnatish
  17. Repo'ni yuklab oling (`Code → Download ZIP` yoki `git clone`), keyin:
  18. **Windows:** `install.bat` ni 2 marta bosing.
  19. **Mac / Linux:** `bash install.sh`
  20. O'rnatuvchi o'zi tekshiradi va kerak bo'lsa o'rnatadi:
  21. | Nima | Nega kerak |
  22. |---|---|
  23. | Python 3.10+ | skriptlar |
  24. | FFmpeg | kesish, 9:16, subtitr |
  25. | yt-dlp | efir yozish, video yuklash, trend qidiruv |
  26. | faster-whisper | nutqni matnga aylantirish |
  27. | requests | trend (YouTube Data API) |
  28. | google-api-python-client, google-auth-oauthlib, google-auth-httplib2 | YouTube'ga yuklash |
  29. | anthropic | ixtiyoriy: avto rejimda Claude lahza tanlaydi |
  30. Hammasi `~/youtube-hunter/` (Windows: `C:\Users\<siz>\youtube-hunter\`) ichiga, alohida `.venv` muhitiga o'rnatiladi — tizimingizdagi Python'ga tegmaydi.
  31. ### Claude skill sifatida
  32. Bu papkani Claude'ga skill qilib qo'shing (masalan Claude Code: `~/.claude/skills/youtube-hunter/`, yoki claude.ai'da ZIP qilib yuklang). Claude birinchi ishlatishda o'rnatuvchini o'zi ishga tushiradi va qolgan qadamlarda yo'l ko'rsatadi.
  33. ## YouTube'ga ulash (faqat joylash uchun, bir marta)
  34. 1. [Google Cloud Console](https://console.cloud.google.com) → yangi loyiha → **APIs & Services → Library** → **YouTube Data API v3** → Enable.
  35. 2. **OAuth consent screen** → External → ilova nomi, email → **Test users** ga kanal egasi bo'lgan Google akkauntni qo'shing.
  36. 3. **Credentials / Clients** → Create OAuth client ID → **Desktop app** → **Download JSON**.
  37. 4. Faylni `~/youtube-hunter/client_secret.json` qilib saqlang. Birinchi yuklashda brauzer ochiladi, ruxsat berasiz.
  38. > "Testing" holatida Google ruxsatni taxminan haftada bir yangilashni so'rashi mumkin. Tekshirilmagan (audit qilinmagan) loyihadan yuklangan videolar private qolishi mumkin.
  39. ### Ixtiyoriy kalitlar — `~/youtube-hunter/.env`
  40. ```
  41. YT_API_KEY= # trend tahlili tezroq va aniqroq
  42. ANTHROPIC_API_KEY= # avto rejimda Claude lahza va matn tanlaydi
  43. ```
  44. Bo'sh qolsa ham ishlaydi. **`.env`, `client_secret.json`, `token.json` ni hech qachon GitHub'ga yuklamang** (`.gitignore` ularni bloklaydi).
  45. ## Ishlatish
  46. Mac/Linux: `~/youtube-hunter/hunter ...` · Windows: `%USERPROFILE%\youtube-hunter\hunter.bat ...`
  47. ```bash
  48. hunter record https://www.youtube.com/@kanal/live --wait # efirni yozish
  49. hunter download "https://youtu.be/VIDEO_ID" # video yuklash
  50. hunter auto process ~/youtube-hunter/downloads/VIDEO_ID.mp4 --no-upload # Shorts (joylamasdan)
  51. hunter trends "how jet engines work" --region US # trend
  52. hunter upload short_01.mp4 --meta short_01.json --shorts # joylash
  53. hunter auto watch --no-upload # to'liq avtomat
  54. ```
  55. ## Sozlamalar — `~/youtube-hunter/config.json`
  56. | Kalit | Standart | Izoh |
  57. |---|---|---|
  58. | `language` | `auto` | video tili; `auto` = o'zi aniqlaydi |
  59. | `output_language` | `auto` | nom/tavsif/teg tili |
  60. | `trend_region` | `""` | bo'sh = butun dunyo; `US`, `IN`, `UZ`... |
  61. | `whisper_model` | `large-v3` | kuchsiz kompyuterda `medium` / `small` |
  62. | `short_min_sec` / `short_max_sec` | 20 / 59 | Shorts uzunligi |
  63. | `clips_per_video` | 5 | bitta videodan nechta Shorts |
  64. | `layout` | `blur` | `blur` / `crop` / `fit` |
  65. | `privacy` | `private` | `private` / `unlisted` / `public` |
  66. | `schedule_every_hours` | 4 | Shorts orasidagi vaqt |
  67. | `max_uploads_per_day` | 6 | API kvotasi |
  68. | `channels_to_watch` | `[]` | avto rejim kuzatadigan kanallar |
  69. | `cookies` | `""` | YouTube bloklasa `cookies.txt` yo'li |
  70. ## ⚠️ Mualliflik huquqi
  71. Faqat o'zingizning yoki ruxsat olingan kontent bilan ishlating. Boshqalarning videolarini ruxsatsiz qayta yuklash copyright strike va kanal o'chirilishiga olib keladi. Foydalanish uchun javobgarlik foydalanuvchida.
  72. ---
  73. ## English summary
  74. YouTube Hunter records YouTube live streams, downloads videos, turns them into 9:16 Shorts (karaoke captions, hook text, loudness normalization), writes trend-based titles/descriptions/tags in any language, and uploads to YouTube on a schedule — manually or fully automatic.
  75. **Install:** Windows → run `install.bat`; Mac/Linux → `bash install.sh`. Everything goes into `~/youtube-hunter/` with its own virtualenv.
  76. **Upload setup:** create a Google Cloud project, enable YouTube Data API v3, create an OAuth **Desktop app** client, save the JSON as `~/youtube-hunter/client_secret.json`.
  77. **Optional keys** in `~/youtube-hunter/.env`: `YT_API_KEY`, `ANTHROPIC_API_KEY`.
  78. **Use:** `hunter record|download|transcribe|short|trends|upload|auto ...`. Works as a Claude skill too (`SKILL.md`).
  79. Only use content you own or have rights to.
  80. ## Litsenziya
  81. MIT — `LICENSE` faylida.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.