Skip to content
Back to search

clipper

Long video to 9:16 clips with burned-in subtitles, face reframe and captions. Includes an MCP server so Claude Code / Codex can drive it.

Safety scan

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

Checked today

Check it deeper on your machine

It has changed since its scan on 17 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/reyhanfebrizioresman/clipper with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/reyhanfebrizioresman/clipper'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/reyhanfebrizioresman--clipper/badge.svg)](/listings/reyhanfebrizioresman--clipper)

HTML

<a href="/listings/reyhanfebrizioresman--clipper"><img src="/api/listings/reyhanfebrizioresman--clipper/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.

README.md · README · 89 lines
  1. # clipper
  2. Mesin pemotong klip untuk campaign clipping (Clippo/TernakKlip).
  3. Dari satu video panjang jadi beberapa klip 9:16 siap unggah + caption berisi hashtag wajib.
  4. ```
  5. python scripts/make_clips.py campaigns/ftm-potrade.json <url-atau-file> --jumlah 5
  6. ```
  7. Alur: unduh (yt-dlp) → transkrip (subtitle bawaan, atau Whisper kalau tidak ada)
  8. → pilih momen (batas kalimat + skor kata kunci brief) → potong 9:16 + subtitle
  9. → tulis caption.
  10. **Unggah tetap manual.** TikTok/Instagram melarang unggah otomatis; script berhenti
  11. di file siap kirim. Aturan campaign (durasi, hashtag, larangan) ada di `campaigns/*.json`.
  12. ## Clipper Studio — web UI (pintu 1)
  13. ```
  14. .venv/bin/python scripts/web.py # http://127.0.0.1:8780
  15. ```
  16. - **Sumber**: unduh dari URL atau unggah video; progres & batal di panel Job.
  17. - **Studio**: putar video sumber, pratinjau kandidat (mulai di awal kalimat; yang
  18. berhenti di tengah kalimat diberi tanda), cari di transkrip, tandai awal/akhir sendiri,
  19. geser ±1 dtk, tulis hook, lalu render. Ada juga "Klip otomatis" (kata kunci / Gemini).
  20. - **Pustaka klip**: putar, unduh, salin caption per platform (TikTok satu baris).
  21. - **Campaign**: ubah brief; field yang tidak ada di form tetap dipertahankan.
  22. Durasi maks bawaan 60 dtk (batas umum TikTok/Reels/Shorts), bisa dinaikkan sampai batas
  23. campaign. Saat render, waktu ditempel ke kalimat utuh, tapi tidak akan memangkas lebih
  24. dari 40% dari durasi yang dipilih (hasil = yang dipratinjau).
  25. Tanpa login, jadi hanya mendengarkan 127.0.0.1 (host lain ditolak kecuali
  26. `--izinkan-tanpa-auth`). Header `Host` harus loopback dan request yang mengubah data wajib
  27. membawa `X-Clipper: 1`, supaya situs lain tidak bisa memicu aksi lewat browsermu.
  28. Buka dari laptop lewat SSH tunnel, mis. lewat host perantara:
  29. ```
  30. ssh -F ~/.ssh/config -L 8780:127.0.0.1:8780 reyhan "ssh -F /home/reyhan/.ssh/config -N -L 8780:127.0.0.1:8780 devodo"
  31. ```
  32. ## Server MCP (pintu 2)
  33. **Panduan setup lengkap:** [Codex, Claude, SSH reyhan/devodo, dan tes koneksi](docs/mcp-setup.md).
  34. Pilih `clipper-devodo` untuk memakai sumber dan pustaka yang sama dengan web UI
  35. di devodo. Contoh di bawah menjalankan engine pada server `reyhan`.
  36. Klien AI kamu sendiri (Claude Code / Claude Desktop / Codex) yang memilih momen dan menulis
  37. hook; engine yang memotong, memberi subtitle, dan menulis caption. Server tidak memanggil LLM.
  38. ```
  39. .venv/bin/python scripts/mcp_server.py # stdio
  40. .venv/bin/python scripts/mcp_server.py --http --port 8765 # streamable HTTP (127.0.0.1)
  41. ```
  42. Dari mesin lain lewat SSH (konfigurasi Claude Code, `~/.claude.json` → `mcpServers`):
  43. ```json
  44. "clipper": {"type": "stdio", "command": "ssh",
  45. "args": ["-F", "/home/reyhan/.ssh/config", "-T", "-o", "BatchMode=yes", "reyhan",
  46. "/home/reyhan/clipper-v2/.venv/bin/python",
  47. "/home/reyhan/clipper-v2/scripts/mcp_server.py"]}
  48. ```
  49. Tool cepat: `list_campaigns`, `get_campaign_brief`, `save_campaign_brief`, `list_sources`,
  50. `get_transcript`, `list_candidate_windows`, `list_clips`, `get_clip`, `get_summary`.
  51. Kelola klip: `update_clip` (ubah hook/caption tanpa render, status baru/diunggah/disubmit,
  52. tautan postingan), `delete_clip` (wajib `konfirmasi=true`), `rerender_clip` (job).
  53. Pengaturan: `get_settings` / `update_settings`, sama dengan halaman Pengaturan web UI;
  54. API key Gemini hanya bisa diatur dari web UI supaya tidak masuk riwayat percakapan AI.
  55. Tool job (kerja panjang): `fetch_source`, `render_clips`, `auto_clips`, `rerender_clip` berjalan di latar.
  56. Tool menunggu paling lama `tunggu_s` (bawaan 45 dtk, aman untuk batas waktu Codex), lalu
  57. mengembalikan `{job_id, status}`; pantau dengan `job_status`, hentikan dengan `cancel_job`
  58. (ffmpeg/yt-dlp dibunuh), lihat semua dengan `list_jobs`. Job hidup selama sesi server;
  59. hasilnya (transkrip, klip) tetap di disk.
  60. Reframe ikut-wajah memakai MediaPipe Tasks `FaceDetector` (dideteksi per 3 petak lebar frame
  61. lalu digabung NMS, karena model short-range melewatkan wajah di bidikan lebar) dengan model
  62. `models/blaze_face_short_range.tflite` (atau env `CLIPPER_FACE_MODEL`). API lama
  63. `mp.solutions` sudah dihapus sejak mediapipe 0.10.30. Tanpa model, klip memakai blur-pad
  64. dan peringatannya muncul di progres job / stderr. Hasil deteksi wajah di-cache per sumber
  65. di `work/_sources/<source_id>/wajah-5fps.json`. Inti logikanya di `clipper/service.py` (dipakai ulang web app nanti).
  66. Penyimpanan: `work/_sources/<source_id>/` (cache unduhan + transkrip) dan
  67. `work/<campaign>/<source_id>/clips/` (mp4 + srt + caption .txt, manifest `clips.json`).
  68. Env opsional: `CLIPPER_WORK`, `CLIPPER_CAMPAIGNS`, `GEMINI_API_KEY` (untuk `auto_clips ai=gemini`).

Ratings and comments

Sign in to rate this skill.

Sign in

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