Сжать видео без потери качества

README из GitHub

Документация подтянута автоматически из репозитория. Открыть в GitHub

# Video Compressor — Compress Video Without Quality Loss

Free offline video compression tool. Works locally on your computer — no files are uploaded anywhere.

**Supported formats:** MP4, MOV, MKV, AVI, WEBM, M4V

---

## Download Ready-Made App

Go to [Releases](https://github.com/aglyamodinar/video-compressor/releases) and download:

| OS | File | What to do |
|----|------|-----------|
| **macOS** | `VideoCompressor-macOS.zip` | Unzip → see note below |
| **Windows** | `VideoCompressor-Windows.zip` | Unzip → run `VideoCompressor.exe` |

No Python, no terminal, no setup required.

> **macOS note:** If macOS says the app is "damaged", open Terminal and run:
> ```
> xattr -cr ~/Downloads/VideoCompressor.app
> ```
> This removes the quarantine flag from the unsigned app. After that it will open normally.

---

## One-Command Install (macOS)

```bash
git clone https://github.com/aglyamodinar/video-compressor.git && cd video-compressor && bash install.sh
```

This will install all dependencies, build `VideoCompressor.app`, and launch it. Done.

---

## Manual Setup

If you prefer to run without building `.app`:

```bash
git clone https://github.com/aglyamodinar/video-compressor.git
cd video-compressor
bash setup.sh
python3 gui_app.py
```

**Command line (advanced):**

```bash
python3 video_compressor.py video.mp4
```

---

## Compression Modes

| Mode | Use case | File size |
|------|----------|-----------|
| **No quality loss** | Archiving, quality matters most | Large |
| **For Telegram** | Telegram-ready (1280px, 30fps) | Medium |
| **For web** | YouTube, social media, websites | Medium |
| **Maximum compression** | Email, saving disk space | Small |

## GUI Features

- Add one or multiple video files
- Choose compression mode
- Click "Compress" and track progress for each file
- Open the output folder with one click

## CLI Examples

```bash
# Single file
python3 video_compressor.py input.mp4

# For Telegram
python3 video_compressor.py input.mp4 --preset telegram

# Compress all videos in a folder
python3 video_compressor.py ./videos -o ./compressed

# Target file size (e.g. 40 MB)
python3 video_compressor.py input.mp4 --preset telegram --target-size-mb 40

# Custom settings
python3 video_compressor.py input.mp4 --crf 28 --speed fast --audio-bitrate 96k --scale 1280 --fps 30
```

## Build standalone .app (macOS)

```bash
pip3 install pyinstaller
bash build_app.sh
```

The `VideoCompressor.app` will appear in `dist/`.

## Requirements

- macOS / Linux / Windows
- Python 3.10+
- ffmpeg

On macOS everything is installed automatically via `setup.sh`.

---

## For AI Agents (Claude Code, Codex, etc.)

See [CLAUDE.md](CLAUDE.md) for full architecture and instructions.

**TL;DR for agents:**
- To compress a video: `python3 video_compressor.py INPUT --preset telegram`
- To launch GUI: `python3 gui_app.py`
- To build .app: `bash install.sh`
- Core logic is in `video_compressor.py`, GUI is in `gui_app.py` (imports from core)
- Presets: `archive` (best quality), `telegram`, `web`, `mobile` (smallest)
- Adding a preset: add to `PRESETS` in video_compressor.py + `PRESET_UI` / `PRESET_ORDER` in gui_app.py

---

# Русская версия

## Скачать готовое приложение

Перейдите в [Releases](https://github.com/aglyamodinar/video-compressor/releases) и скачайте:

| ОС | Файл | Что делать |
|----|------|-----------|
| **macOS** | `VideoCompressor-macOS.zip` | Распаковать → см. примечание ниже |
| **Windows** | `VideoCompressor-Windows.zip` | Распаковать → запустить `VideoCompressor.exe` |

Не нужен Python, терминал, никакая установка.

> **Примечание для macOS:** Если macOS пишет «Приложение повреждено» — откройте Терминал и выполните:
> ```
> xattr -cr ~/Downloads/VideoCompressor.app
> ```
> Это снимает карантинный флаг с неподписанного приложения. После этого оно откроется нормально.

---

## Установка одной командой (macOS)

```bash
git clone https://github.com/aglyamodinar/video-compressor.git && cd video-compressor && bash install.sh
```

Установит зависимости, соберёт `VideoCompressor.app` и запустит. Всё.

---

## Ручная установка

Если не хотите собирать `.app`:

```bash
git clone https://github.com/aglyamodinar/video-compressor.git
cd video-compressor
bash setup.sh
python3 gui_app.py
```

**Из командной строки (для продвинутых):**

```bash
python3 video_compressor.py video.mp4
```

## Режимы сжатия

| Режим | Для чего | Размер файла |
|-------|----------|-------------|
| **Без потери качества** | Архивация, когда важно качество | Крупный |
| **Для Telegram** | Отправка в Telegram (1280px, 30fps) | Средний |
| **Для интернета** | YouTube, соцсети, сайты | Средний |
| **Максимальное сжатие** | Отправка по почте, экономия места | Маленький |

## GUI — графический интерфейс

- Добавьте один или несколько видеофайлов
- Выберите режим сжатия
- Нажмите «Сжать видео»
- Следите за прогрессом каждого файла в таблице
- Откройте папку с результатом одним кликом

## Примеры командной строки

```bash
# Сжать один файл
python3 video_compressor.py input.mp4

# Сжать для Telegram
python3 video_compressor.py input.mp4 --preset telegram

# Сжать все видео в папке
python3 video_compressor.py ./videos -o ./compressed

# Сжать под конкретный размер (40 МБ)
python3 video_compressor.py input.mp4 --preset telegram --target-size-mb 40
```

## Сборка .app (macOS)

```bash
pip3 install pyinstaller
bash build_app.sh
```

Готовый `VideoCompressor.app` появится в папке `dist/`.

## Требования

- macOS / Linux / Windows
- Python 3.10+
- ffmpeg

На macOS всё ставится автоматически через `setup.sh`.