PHPackages                             arhitector/jumper - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. arhitector/jumper

ActiveLibrary[Image & Media](/categories/media)

arhitector/jumper
=================

Tools to transcoding/encoding audio or video, inspect and convert media formats

3285[2 issues](https://github.com/jack-theripper/transcoder/issues)PHP

Since Oct 4Pushed 7y ago7 watchersCompare

[ Source](https://github.com/jack-theripper/transcoder)[ Packagist](https://packagist.org/packages/arhitector/jumper)[ RSS](/packages/arhitector-jumper/feed)WikiDiscussions master Synced 2w ago

READMEChangelogDependenciesVersions (3)Used By (0)

Transcoder [![Latest Version](https://camo.githubusercontent.com/dddcf5484d0bf450f8d4c7c09e94905f9091ada2d4cbbd856f4573dc1cffcd4f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6a61636b2d7468657269707065722f7472616e73636f6465722e7376673f7374796c653d666c61742d737175617265)](https://github.com/jack-theripper/transcoder/releases)
=====================================================================================================================================================================================================================================================================================================================================================================

[](#transcoder-)

Tools to transcoding/encoding audio or video, inspect and convert media formats.

Инструмент для кодирования аудио или видео, получения информации и конвертирования в другие форматы.

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

[](#содержание)

- [С чего начать](#%D0%A1-%D1%87%D0%B5%D0%B3%D0%BE-%D0%BD%D0%B0%D1%87%D0%B0%D1%82%D1%8C)
    - [Установка](#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0)
    - [Требования](#%D0%A2%D1%80%D0%B5%D0%B1%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F)
- [События](#%D0%A1%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D1%8F)
    - [before](#%D0%A1%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D0%B5-before)
    - [before.pass](#%D0%A1%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D0%B5-beforepass)
    - [before.queue](#%D0%A1%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D0%B5-beforequeue)
    - [successful](#%D0%A1%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D0%B5-successful)
    - [failure](#%D0%A1%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D0%B5-failure)
    - [failure.codec](#%D0%A1%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D0%B5-failurecodec)
    - [after](#%D0%A1%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D0%B5-after)
    - [after.pass](#%D0%A1%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D0%B5-afterpass)
    - [after.queue](#%D0%A1%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D0%B5-afterqueue)
    - [progress](#%D0%A1%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D0%B5-progress)
    - [stream](#%D0%A1%D0%BE%D0%B1%D1%8B%D1%82%D0%B8%D0%B5-stream)
- [Фильтры](#%D0%A4%D0%B8%D0%BB%D1%8C%D1%82%D1%80%D1%8B)
    - [Простой фильтр](#%D0%9F%D1%80%D0%BE%D1%81%D1%82%D0%BE%D0%B9-%D1%84%D0%B8%D0%BB%D1%8C%D1%82%D1%80-simplefilter)
    - [Задержка звука](#%D0%97%D0%B0%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B0-%D0%B7%D0%B2%D1%83%D0%BA%D0%B0)
- [Примеры](#%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%80%D1%8B)
    - [Наложение текста](#%D0%9D%D0%B0%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5-%D1%82%D0%B5%D0%BA%D1%81%D1%82%D0%B0)

С чего начать
-------------

[](#с-чего-начать)

В зависимости от контента, вы можете использовать `Audio` для работы с аудио-файлами, `Frame` для изображений, а `Video` и `Subtitle` соответственно для работы с видео-файлами и субтитрами.

```
use Arhitector\Transcoder\Audio;
use Arhitector\Transcoder\Video;
use Arhitector\Transcoder\Frame;
use Arhitector\Transcoder\Subtitle;
```

Конструктор в общем виде выглядит так:

```
public < ... >::__construct(string $filePath, ServiceFactoryInterface $service = null)
```

`$filePath` - строка, путь до исходного файла.

> Вы не можете использовать удаленный источник или символические ссылки.

`$service` - параметр не обязателен. Экземпляр сервиса. По умолчанию `ServiceFactory`.

```
$audio = new Audio('sample.mp3');
$video = new Video('sample.avi');
$frame = new Frame('sample.jpg');
$subtitle = new Subtitle('sample.srt');
```

Вы можете использовать свою сервис-фабрику или изменить некоторые опции.

```
use Arhitector\Transcoder\Service\ServiceFactory;

$service = new ServiceFactory([
	'ffprobe.path' => 'E:\devtools\bin\ffprobe.exe',
	'ffmpeg.path'  => 'E:\devtools\bin\ffmpeg.exe'
]);

// используем это
$video = new Video('sample.avi', $service);
```

Установка
---------

[](#установка)

```
$ composer require --prefer-dist arhitector/transcoder dev-master
```

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

[](#требования)

- PHP &gt;= 5.6
- Установленный [FFMpeg](http://ffmpeg.org)

События
-------

[](#события)

Экземпляр формата регистрирует обработчики, такой обработчик будет выполнен при наступлении определённого события. Методы `addListener` или `addOneListener` регистрируют обработчик на событие. Читать подробнее [League\\Event](http://event.thephpleague.com/2.0/).

```
$format = new VideoFormat();
$format->addListener('*', function ($event) {
	// "*" - обработчик сработает на любое событие
});
```

В зависимости от события, обработчик может повлиять на дальнейший ход выполнения операции.

```
$format->addListener('before', function ($event) {
	$event->stopPropagation(); // дальнейшее выполнение будет остановлено
});
```

### Событие before

[](#событие-before)

Выполняется перед началом кодирования. Дальнейшее выполнение может быть остановлено.

```
$format->addListener('before', function ($event, $media, $format, $filePath) {
	// обработчик сработает после вызова `$media->save($format, ...`
});
```

### Событие before.pass

[](#событие-beforepass)

При многопроходном кодировании обработчик будет вызван перед каждым проходом. Событие срабатывает минимум 1 раз.

Событие срабатывает после `before` и не может отменить процесс кодирования.

```
use Symfony\Component\Process\Process;

$format->addListener('before.pass', function ($event, $media, $format, Process $process) {

});
```

### Событие before.queue

[](#событие-beforequeue)

### Событие successful

[](#событие-successful)

Событие наступает в том случае, если кодирование завершино без ошибок. При использовании очередей - в том случае, если задание добавлено в очередь.

```
$format->addListener('successful', function ($event, $media, $format, $filePath) {
	// работа завершена без ошибок
});
```

### Событие failure

[](#событие-failure)

Операция завершилась с ошибкой или не может корректно завершиться.

```
use Symfony\Component\Process\Exception\ProcessFailedException;

$format->addListener('failure', function ($event, ProcessFailedException $exception) {
	// кодирование не может быть завершено из-за возникшей ошибки
});
```

### Событие failure.codec

[](#событие-failurecodec)

### Событие after

[](#событие-after)

Обработчик будет вызван когда операция завершится, не зависимо от того была ли операция завершена успешно или нет.

```
$format->addListener('after', function ($event, $media, $format, $filePath) {
	// операция завершилась, но мы не знаем успешно или нет
});
```

### Событие after.pass

[](#событие-afterpass)

Срабатывает после завершения прохода при многопроходном кодировании. Будет вызвано минимум 1 раз.

```
use Symfony\Component\Process\Process;

$format->addListener('after.pass', function ($event, $media, $format, Process $process) {

});
```

### Событие after.queue

[](#событие-afterqueue)

### Событие progress

[](#событие-progress)

Событие наступает во время выполнения операции кодирования.

```
use Arhitector/Transcoder/Event/EventProgress;

$format->addListener('progress', function (EventProgress $event) {
	// $event->getPercent();
});
```

### Событие stream

[](#событие-stream)

### Поддержка очередей

[](#поддержка-очередей)

Вместо прямого транскодирования вы можете отправлять задачи в очередь, например, на сервер очередей. Такой функционал доступен прямо из коробки. Вы можете использовать опцию `ServiceFactoryInterface::OPTION_USE_QUEUE` при создании сервис-фабрики. Читать подробнее [SimpleQueue](https://github.com/fguillot/simple-queue).

**Пример**

```
$adapter = new SimpleQueue\Adapter\MemoryQueueAdapter();
$queue = new SimpleQueue\Queue($queue);

$service = new Arhitector\Transcoder\Service\ServiceFactory([
    Arhitector\Transcoder\Service\ServiceFactory::OPTION_USE_QUEUE => $queue
]);

$audio = new Arhitector\Transcoder\Audio('sample.mp3', $service);

// задача будет отправлена в очередь `$queue`
$audio->save($audio->getFormat(), 'new-sample.mp3');

var_dump($queue->pull()); // запросить задачу из очереди
```

Что можно настроить? Поддерживаемые опции
-----------------------------------------

[](#что-можно-настроить-поддерживаемые-опции)

### Опции сервис-фабрики

[](#опции-сервис-фабрики)

Вы можете использовать свою реализацию сервис-фабрики. Для этого необходимо реализовать интерфейс `Arhitector\Transcoder\Service\ServiceFactoryInterface`.

`ServiceFactory` поддерживает следующие опции:

1. `ffmpeg.path` - путь до исполняемого файла ffmpeg
2. `ffmpeg.threads` - FFMpeg-опция threads. По умолчанию `0`.
3. `ffprobe.path` - путь до исполняемого файла ffprobe
4. `timeout` - задаёт таймаут выполнения команды кодирования.
5. `use_queue` - Отправляет задачу в очередь. Значение должно быть объектом, реализующим `SimpleQueue\QueueAdapterInterface`.

Примеры
-------

[](#примеры)

### Извлечение информации из видео файла, аудио файла и т.д.

[](#извлечение-информации-из-видео-файла-аудио-файла-и-тд)

```
use Arhitector\Transcoder\Video;
use Arhitector\Transcoder\Audio;

$video = new Video('sample.avi');

var_dump($video->getWidth(), $video->getHeight());

$audio = new Audio(__DIR__.'/audio.mp3', $factory);

var_dump($audio->getAudioChannels());
var_dump($audio->getFormat()->getTags());
```

### Извлечение звука из видео файла с последующим сохранением в формате MP3

[](#извлечение-звука-из-видео-файла-с-последующим-сохранением-в-формате-mp3)

Этот простой пример показывает лишь принцип, таким же способом можно сохранить субтитры или обложку из Mp3-файла и т.д.

```
use Arhitector\Transcoder\Video;
use Arhitector\Transcoder\Stream\AudioStreamInterface;
use Arhitector\Transcoder\Format\Mp3;

$video = new Video('sample.mp4');

foreach ($video->getStreams() as $stream)
{
	// тут выбираем только аудио канал
	if ($stream instanceof AudioStreamInterface)
	{
		$stream->save(new Mp3(), __DIR__.'/only-audio.mp3');

		break; // видео может иметь несколько аудио потоков
	}
}
```

### Преобразование из одного формата в любой другой

[](#преобразование-из-одного-формата-в-любой-другой)

```
use Arhitector\Transcoder\Audio;
use Arhitector\Transcoder\Format\Mp3;

$audio = new Audio('audio-file.wav');
$audio->save(new Mp3(), 'audio-file.mp3');

use Arhitector\Transcoder\Video;
use Arhitector\Transcoder\Format\VideoFormat;

$video = new Video('video-file.avi');
$video->save(new VideoFormat('aac', 'h264'), 'video-file.mp4');
```

### Добавление/Изменение мета-информации

[](#добавлениеизменение-мета-информации)

```
use Arhitector\Transcoder\Audio;

$audio = new Audio('file.mp3');

$format = $audio->getFormat();
$format['artist'] = 'Новый артист';

$auiod->save($format, 'new-file.mp3');
```

### Как добавить/изменить обложку MP3-файла?

[](#как-добавитьизменить-обложку-mp3-файла)

```
use Arhitector\Transcoder\Audio;
use Arhitector\Transcoder\Frame;

$audio = new Audio(__DIR__.'/sample.mp3');
$streams = $audio->getStreams();

$new_cover = (new Frame(__DIR__.'/sample.jpg'))
    ->getStreams()
    ->getFirst();

// индекс `0` - аудио-дорожка, `1` - обложка.
$streams[1] = $new_cover;

$audio->save($audio->getFormat(), 'sample-with-new-cover.mp3');
```

### Наложение текста

[](#наложение-текста)

```
use Arhitector\Transcoder\Video;
use Arhitector\Transcoder\Filter\Text;
use Arhitector\Transcoder\Point;

$filter = new Text('Наложение текста на кадр');
$filter->setSize(24);
$filter->setColor('red');
$filter->setPosition(new Point(100, 100));

$video = new Video('sample.mp4');
$video->addFilter($filter);
$video->save($video->getFormat(), 'sample-with-text.mp4');
```

ООП-обёртки над форматами
-------------------------

[](#ооп-обёртки-над-форматами)

Такие обёртки (например, Mp3 или Jpeg и т.д.) созданы для удобства.

### Изображения

[](#изображения)

- Png, Jpeg, Ppm, Bmp, Gif

### Аудио-форматы

[](#аудио-форматы)

- Aac, Mp3, Oga, Flac

### Видео-форматы

[](#видео-форматы)

- Flv, Mkv

Фильтры
-------

[](#фильтры)

Фильтры необходимы для изменения исходного медиа контента. Могут иметь один или несколько входов и выходов, а также быть организованы в цепочки для изоляции некоторых фильтров друг от друга.

```
public TranscodeInterface::addFilter(FilterInterface $filter, $priority = 0);
```

Аудио фильтры реализуют интерфейс `AudioFilterInterface` и могут использоваться совместно только с `Audio` или `Video`.

Видео фильтры реализуют интерфейсы `FrameFilterInterface` или `VideoFilterInterface`, используются либо с `Frame` либо с `Video`.

```
// добавляем любой фильтр
$video->addFilter($filter);

// добавляем фильтр с приоритетом = 99.
$audio->addFilter($filter, 99);
```

#### Простой фильтр, SimpleFilter

[](#простой-фильтр-simplefilter)

Это самый простой фильтр, который позволяет устанавливать свои параметры для командной строки `ffmpeg`.

```
use Arhitector\Transcoder\Filter\SimpleFilter;
```

**Конструктор**

```
public SimpleFilter::__construct(array $parameters = [])
```

Создадим экземпляр и добавим параметр 'video\_codec'.

```
$filter = new SimpleFilter([
	'video_codec' => 'h264'
]);
```

Этот метод перезапишет ранее установленные значения.

```
$filter->setParameters([
	'video_codec' => 'libx264'
]);

// ArrayAccess
$filter['video_codec'] = 'x264';
```

### Фильтр Cut

[](#фильтр-cut)

Аудио фильтр, который позволяет обрезать медиа-файл до определённых значений продолжительности.

```
use Arhitector\Transcoder\Filter\Cut;
```

**Конструктор**

```
public Cut::__construct(TimeInterval|int $start [, TimeInterval $duration = null])
```

**Пример №1**

Пропустить 20 секунд от начала и сохранить последующие 60 секунд.

```
$filter = new Cut(new TimeInterval(20), new TimeInterval(60));
```

### Фильтр Volume

[](#фильтр-volume)

Аудио фильтр, который изменяет громкость аудио потока.

```
use \Arhitector\Transcoder\Filter\Volume;
```

**Конструктор**

```
public Volume::__construct(float $volume [, string $precision = null])
```

**Пример №1**

Пример показывает как уменьшить громкость аудио.

```
$filter = new Volume(0.5);
$filter = new Volume(1/2);
$filter = new Volume('6.0206dB');
```

**Пример №2**

Увеличение входной мощности звука на 6 дБ с фиксированной точностью.

```
$filter = new Volume('6dB', Volume::PRECISION_FIXED);
```

### Фильтр Fade

[](#фильтр-fade)

Фильтр накладывает эффект затухания звука на аудио дорожку.

```
use \Arhitector\Transcoder\Filter\Fade;
```

**Конструктор**

```
public Fade::__construct(TimeInterval|int $startTime = 0 [, TimeInterval|int $duration = null [, string $effectType = null]])
```

**Пример №1**

```
new Fade(2, 10, Fade::FADE_OUT)
```

### Фильтр AudioDelay

[](#фильтр-audiodelay)

```
use \Arhitector\Transcoder\Filter\AudioDelay;
```

### Фильтр Rotate

[](#фильтр-rotate)

```
use \Arhitector\Transcoder\Filter\Rotate;
```

**Конструктор**

```
public Rotate::__construct($angle = null)
```

### Фильтр Crop

[](#фильтр-crop)

```
use \Arhitector\Transcoder\Filter\Crop;
```

**Конструктор**

```
public Crop::__construct(Point $start, Dimension $dimension)
```

Лицензия
--------

[](#лицензия)

Распространяется под лицензией [MIT](http://opensource.org/licenses/MIT).

```
Copyright (c) 2017 Dmitry Arhitector

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

```

###  Health Score

24

—

LowBetter than 31% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/5256163?v=4)[Arhitector](/maintainers/Arhitector)[@Arhitector](https://github.com/Arhitector)

---

Top Contributors

[![jack-theripper](https://avatars.githubusercontent.com/u/6401841?v=4)](https://github.com/jack-theripper "jack-theripper (74 commits)")

---

Tags

audioconvertingffmpegphptranscodingvideo

### Embed Badge

![Health badge](/badges/arhitector-jumper/health.svg)

```
[![Health](https://phpackages.com/badges/arhitector-jumper/health.svg)](https://phpackages.com/packages/arhitector-jumper)
```

###  Alternatives

[goat1000/svggraph

Generates SVG graphs

133890.0k3](/packages/goat1000-svggraph)[imagekit/imagekit

PHP library for Imagekit

46877.3k10](/packages/imagekit-imagekit)[gravatarphp/gravatar

Gravatar URL builder which is most commonly called as a Gravatar library

12644.1k2](/packages/gravatarphp-gravatar)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)