KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

AI-Clip-Maker

★ 1 Open GitHub ↗

AI Clip Maker — инструмент для автоматической нарезки видео на клипы, добавления субтитров и генерации вирусных описаний для TikTok/YouTube Shorts/Reels в единственном API-запросе.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# AI Clip Maker

**AI Clip Maker** — инструмент для автоматической нарезки видео на клипы, добавления субтитров и генерации вирусных описаний для TikTok/YouTube Shorts/Reels в единственном API-запросе.
**‼️ВАЖНО‼️**
С API ключем, который находится в проекте, запросы на OpenRouter не будут обрабатываться, так как после публикации они автоматически блокируются. Вы можете легко получить свой на сайте https://openrouter.ai/ и вставить в файл config.toml

---

## Содержание

1. [Ключевые возможности](#ключевые-возможности)  
2. [Техническое описание](#техническое-описание)  
3. [Требования и подготовка](#требования-и-подготовка)  
4. [Установка и запуск](#установка-и-запуск)  
5. [Структура проекта](#структура-проекта)  
6. [Настройка `config.toml`](#настройка-configtoml)  
7. [GUI: пошаговый сценарий](#gui-пошаговый-сценарий)  
8. [CLI: пример вызова](#cli-пример-вызова)  
9. [Логирование и отладка](#логирование-и-отладка)  
10. [Возможные вопросы](#частые-вопросы)

---

## Ключевые возможности

- **Нарезка клипов**  
  - По звуковым пикам (уровень громкости) и визуальным пикам (изменение кадров).
  - Параметры: количество клипов и длина каждого.

- **Субтитры (опция)**  
  - Транскрипция аудио с помощью Whisper.
  - Генерация `.srt` и наложение через ffmpeg.

- **Генерация описаний**  
  - **Единый** запрос к OpenRouter/Mistral по всем клипам.
  - Если для клипа есть субтитры → выдаётся описание + 2–4 хештега.
  - Если субтитров нет → только 3–5 популярных хештегов.

- **Графический интерфейс (Tkinter)**  
  - Выбор исходного видео.
  - Настройка клипов и субтитров.
  - Кнопки для просмотра готовых роликов.
  - Кнопка «Сгенерировать описания» → единственный API-запрос.

---

## Техническое описание

1. **Поиск пиков**  
   - `detect_audio_peaks`: делит аудио на 1-секунные интервалы, выбирает участки выше порога dBFS.  
   - `detect_motion_peaks`: считывает кадры через OpenCV, сравнивает по среднему значению абсолютной разницы.

2. **Нарезка и конвертация**  
   - `extract_clip`: MoviePy `.subclip(...)` → `.mp4` (H.264/AAC).  
   - `add_subtitles`:  
     1. ffmpeg → WAV,  
     2. Whisper → сегменты,  
     3. генерирует `.srt`,  
     4. ffmpeg + libass → видео с вшитыми субтитрами.

3. **Единый запрос описаний**  
   - Собирается `prompt` из всех субтитров:  
     ```
     Для каждого клипа:
     - если есть субтитры, 1–2 предложения + хештеги;
     - иначе только хештеги.
     Верни JSON вида { "Клип 1": "...", … }
     ```
   - Отправляется `requests.post` к `https://openrouter.ai/api/v1/chat/completions`.  
   - Ответ авто-фиксится (замена «косых» кавычек, пост-парсинг строк → JSON).  
   - Генерируются файлы `output/description_0.txt`, `description_1.txt`…

4. **GUI**  
   - Основное окно: выбор видео, галка субтитров, параметры клипов, кнопка **Старт**.  
   - После нарезки — фрейм с кнопками `🎬 Клип 1`, `🎬 Клип 2`… для открытия файлов.  
   - Кнопка **Сгенерировать описания** собирает карту субтитров, запускает единый запрос и сохраняет `descriptions_all.txt`.

---

## Требования и подготовка

- **Python 3.9+**  
- **ffmpeg** (доступен в PATH)  
- **API-ключ OpenRouter** (Mistral)

### Зависимости (в `requirements.txt`)

```text
moviepy==1.0.3
imageio>=2.5
imageio-ffmpeg>=0.4.2
proglog>=0.1.9
pydub
openai
whisper
toml
requests
numpy==1.24.4
opencv-python
regex
git+https://github.com/openai/whisper.git

```

---

## Установка и запуск

1. **Клонируем репозиторий**  
   ```bash
   git clone <репо_URL>
   cd AI_ClipMaker
   ```

2. **Создаём виртуальное окружение**  
   ```bash
   python -m venv .venv
   source .venv/bin/activate   # macOS/Linux
   .\.venv\Scripts\activate  # Windows PowerShell
   ```

3. **Устанавливаем зависимости**  
   ```bash
   pip install --upgrade pip
   pip install -r requirements.txt
   ```

4. **Создаём `config.toml`** (см. ниже).

5. **Запускаем GUI**  
   ```bash
   python clip_gui.py
   ```

---

## Структура проекта

```text
.
├── clipmaker.py
├── clip_gui.py
├── config.toml
├── requirements.txt
├── output/
│   ├── clip_0_raw.mp4
│   ├── clip_0_sub.mp4
│   ├── description_0.txt
│   └── descriptions_all.txt
└── README.md
```

---

## Настройка `config.toml`

```toml
OPENROUTER_KEY = "ваш_ключ_здесь"
LANG = "ru"
AUDIO_THRESHOLD = -30.0
FRAME_DIFF_THRESHOLD = 5.0
```

---

## GUI: шаги

1. Нажмите **«Выбрать видео»**.  
2. Отметьте **«Добавить субтитры»**, если нужно.  
3. Задайте **количество** и **длительность** клипов.  
4. Нажмите **«Старт»**.  
5. Нажмите **«Сгенерировать описания»** → `descriptions_all.txt`.

---

## CLI: пример

```bash
python - << 'EOF'
import clipmaker
clipmaker.main("input.mp4", None, 3, 20, True, log=print)
EOF
```

---

## Логирование

- Логи → `output/log.txt`.  
- Для отладки удалите `STDOUT=DEVNULL`.

---

## FAQ

### 1. Субтитры не создаются — что делать?

- **Проверьте установку ffmpeg**  
  Убедитесь, что вы можете выполнить в терминале `ffmpeg -version`.  
- **Проверьте наличие звуковой дорожки**  
  Если видео без звука, Whisper не сможет транскрибировать аудио.

---

### 2. Описания генерируются без учёта субтитров — только хештеги

- Если для клипа **нет** файла `.srt`, в запрос отправляется пустая строка, и модель возвращает «только хештеги».  
- Убедитесь, что после нарезки клипов действительно есть файлы `clip_#_sub.mp4` и рядом файл `clip_#.srt`.  
- Проверьте, что функция `add_subtitles()` завершилась успешно и удалила временные файлы.

---

### 3. Возникает ошибка, связанная с токенами openrouter

- Возможно, к этому моменту бесплатные запросы на тестовом api ключе уже закончились :(  
- Вы можете получить свой ключ на сайте https://openrouter.ai/

---

### 4. Как заменить модель Whisper на более лёгкую?

В файле `clipmaker.py` найдите строку:

```python
model = whisper.load_model("base")
и замените "base" на, например, "tiny" или "small":

model = whisper.load_model("tiny")
Это уменьшит потребление памяти и ускорит транскрипцию, но чуть снизит качество.
```
### 5. Как отрегулировать чувствительность поиска пиков?
Параметры детекции находятся в config.toml:

AUDIO_THRESHOLD = -30.0        # порог громкости (dBFS)
FRAME_DIFF_THRESHOLD = 5.0     # порог разницы кадров (0–255)

🢃

Увеличьте AUDIO_THRESHOLD, если шумы мешают и клипов получается слишком много.

Увеличьте FRAME_DIFF_THRESHOLD, если кадры мало меняются и субтитры срабатывают не по нужным моментам.

---  
Спасибо за использование AI Clip Maker! Хорошего Вам дня!ф

AI-Clip-Maker

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README