2017 © Pedro Peláez
 

library sonus

A laravel audio and video conversion, thumbnail generator and metadata editor package powered by ffmpeg

image

rafasamp/sonus

A laravel audio and video conversion, thumbnail generator and metadata editor package powered by ffmpeg

  • Sunday, August 30, 2015
  • by rafasamp
  • Repository
  • 6 Watchers
  • 50 Stars
  • 3,852 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 20 Forks
  • 9 Open issues
  • 5 Versions
  • 1 % Grown

The README.md

Project Status

I regret to inform that I will not be updating Sonus any further. Unfortunately life has got in the way and I cannot dedicate the time for this project. There is a fork by closca here that supports Laravel 5. I will keep the Github page alive in case anyone needs to reference it., (*1)

Thank you to everyone who used this little project of mine!, (*2)

Sonus (Laravel 4 Package)

Latest Stable Version Build Status Total Downloads ProjectStatus License, (*3)

Sonus is a tool designed to leverage the power of Laravel 4 and ffmpeg to perform tasks such as:, (*4)

  • Audio/Video conversion
  • Video thumbnail generation
  • Metadata manipulation

Quick Start

Setup

Update your composer.json file and add the following under the require key, (*5)

"rafasamp/sonus": "dev-master"

Run the composer update command:, (*6)

$ composer update

In your config/app.php add 'Rafasamp\Sonus\SonusServiceProvider' to the end of the $providers array, (*7)

'providers' => array(

    'Illuminate\Foundation\Providers\ArtisanServiceProvider',
    'Illuminate\Auth\AuthServiceProvider',
    ...
    'Rafasamp\Sonus\SonusServiceProvider',

),

Still under config/app.php add 'Sonus' => 'Rafasamp\Sonus\Facade' to the $aliases array, (*8)

'aliases' => array(

    'App'             => 'Illuminate\Support\Facades\App',
    'Artisan'         => 'Illuminate\Support\Facades\Artisan',
    ...
    'Sonus'           => 'Rafasamp\Sonus\Facade',

),

Run the artisan command below to publish the configuration file, (*9)

$ php artisan config:publish rafasamp/sonus

Navigate to app/config/packages/Rafasamp/Sonus/config.php and update all four parameters, (*10)

Examples

Here is a simple example of a file being converted from FLAC to AAC:, (*11)

Sonus::convert()->input('foo.flac')->bitrate(128)->output('bar.aac')->go();

Sonus can also convert video files:, (*12)

Sonus::convert()->input('foo.avi')->bitrate(300, 'video')->output('bar.flv')->go();

Sonus can also return media information as an array or json, (*13)

Sonus::getMediaInfo('foo.mov');

Sonus can also easily generate smart movie thumbnails like this, (*14)

Sonus::getThumbnails('foo.mp4', 'foo-thumb' 5); // Yields 5 thumbnails

Although Sonus contains several preset parameters, you can also pass your own, (*15)

Sonus::convert()->input('foo.flac')->output('bar.mp3')->go('-b:a 64k -ac 1');

Tracking progress

Make sure the progress and tmp_dir options are set correctly in the config.php file, (*16)

'progress'      => true,
...
'tmp_dir'      => '/Applications/ffmpeg/tmp/'

Pass the progress method when initiating a conversion, (*17)

Sonus::convert()->input('foo.avi')->output('bar.mp3')->progress('uniqueid')->go();

Now you can write a controller action to return the progress for the job id you passed and call it using any flavor of JavaScript you like, (*18)

public function getJobProgress($id)
{
    return Sonus::getProgress('uniqueid');
}

Security and Compatibility

Sonus uses PHP's shell_exec function to perform ffmpeg and ffprobe commands. This command is disabled if you are running PHP 5.3 or below and safe mode is enabled., (*19)

Please make sure that ffmpeg and ffprobe are at least the following versions:, (*20)

  • ffmpeg: 2.1.*
  • ffprobe: 2.0.*

Also, remember that filepaths must be relative to the location of FFMPEG on your system. To ensure compatibility, it is good practice to pass the full path of the input and output files. Here's an example working in Laravel:, (*21)

$file_in  = Input::file('audio')->getRealPath();
$file_out = '\path\to\my\file.mp3'; 
Sonus::convert()->input($file_in)->output($file_out)->go();

Lastly, Sonus will only convert to formats which ffmpeg supports. To check if your version of ffmpeg is configured to encode or decode a specific format you can run the following commands using php artisan tinker, (*22)

var_dump(Sonus::canEncode('mp3'));
var_dump(Sonus::canDecode('mp3'));

To get a list of all supported formats you can run, (*23)

var_dump(Sonus::getSupportedFormats());

Troubleshooting

Please make sure the following statements are true before opening an issue:, (*24)

1) I am able to access FFMPEG on terminal using the same path I defined in the Sonus configuration file, (*25)

2) I have checked the error logs for the webserver and found no FFMPEG output messages, (*26)

Usually all concerns are taken care of by following these two steps. If you still find yourself having issues you can always open a trouble ticket., (*27)

Planned features

  • Support for filters
  • Setting metadata
  • Return meaningful error codes on exceptions

License

Sonus is free software distributed under the terms of the MIT license., (*28)

Aditional information

Any questions, feel free to contact me., (*29)

Any issues, please report here, (*30)

The Versions

30/08 2015

dev-master

9999999-dev

A laravel audio and video conversion, thumbnail generator and metadata editor package powered by ffmpeg

  Sources   Download

MIT

The Requires

 

The Development Requires

by Rafael Sampaio

laravel converter ffmpeg ffprobe

16/05 2014

v1.0.3

1.0.3.0

A laravel audio and video conversion, thumbnail generator and metadata editor package powered by ffmpeg

  Sources   Download

MIT

The Requires

 

The Development Requires

by Rafael Sampaio

laravel converter ffmpeg ffprobe

08/05 2014

v1.0.2

1.0.2.0

A laravel audio and video conversion, thumbnail generator and metadata editor package powered by ffmpeg

  Sources   Download

MIT

The Requires

 

by Rafael Sampaio

laravel converter ffmpeg ffprobe

14/02 2014

v1.0.1

1.0.1.0

A laravel audio and video conversion, thumbnail generator and metadata editor package powered by ffmpeg

  Sources   Download

MIT

The Requires

 

by Rafael Sampaio

laravel converter ffmpeg ffprobe

08/01 2014

v1.0.0

1.0.0.0

A laravel audio and video conversion, thumbnail generator and metadata editor package powered by ffmpeg

  Sources   Download

MIT

The Requires

 

by Rafael Sampaio

laravel converter ffmpeg ffprobe