PHP Classes
elePHPant
Icontem

PHP Screen Recorder: Capture videos of the current screen with ffmpeg

Recommend this page to a friend!

  Author Author  
Name: Dawood Ikhlaq <contact>
Classes: 3 packages by
Country: Italy Italy
Age: 23
All time rank: 2840110 in Italy Italy
Week rank: 48 Up2 in Italy Italy Up
Innovation award
Innovation award
Nominee: 2x


  Detailed description   Download Download .zip .tar.gz   Install with Composer Install with Composer  
This class can capture videos of the current screen with ffmpeg.

It executes the ffmpeg program passing some options to configure details of the recording such as the screen size to capture.

The video file is saved to a configurable file in Flash Video.

Details

PHP Screen Recorder

A lightweight php wrapper around ffmpeg to record the screen, best for recording your acceptance tests using selenium, it's easy to use and clean OOP interface.

History

I was given a task to make an acceptance test suite which included recording videos of the tests. I was using selenium for the task and for the video recording, however, I was unable to find an elegant solution which is why i created this library.

Usage

One of the best features of this library is its ease of use.

The startRecording method is called when the user wants to start the recording after which this library will start the video recording in the background. When the user has completed their task they can call stopRecording to stop the recording .

Installation

The library is easily installed as a package through composer:

composer require dawood/phpscreenrecorder

that's it, nothing else is required for the installation

Examples

There are examples provided in examples folder as well.

Make sure, that you include the composer autoloader somewhere in your codebase.

Capture the screen


include "../vendor/autoload.php";

use dawood\PhpScreenRecorder\ScreenRecorder;

$screenRecorder=new ScreenRecorder();
$screenRecorder->setScreenSizeToCapture(1920,1080);

$screenRecorder->startRecording(__DIR__.DIRECTORY_SEPARATOR.'myVideo');
sleep(5+2);//doing random stuff
//when done stop recording
$screenRecorder->stopRecording();

print "video is saved at :\"".$screenRecorder->getVideo().'"'.PHP_EOL;

Selenium test example


public function testLoginUserCorrectly()
{
    $this->screenRecorder->setScreenSizeToCapture(1920,1080);
    $this->screenRecorder->startRecording(__DIR__."/videos/loginCorrectly.flv",2);
    $loginInput = [
        'username' => 'test',
        'password' => 'password'
    ];
    $this->visit('/')
        ->submitForm("#loginform > form",$loginInput)
        ->wait(3)
        ->see("Logout")
        ->wait(2);
    $this->screenRecorder->stopRecording(0);

}

Setting options

The ffmpeg shell command can accept different options: for a complete list of options you can visit: http://ffmpeg.org/ffmpeg.html

Wrapper Methods

* setOptions accepts the options in the array. You can provide any option in following way:

       $options['-show_region'=>'1']
       $screenRecorder->setOptions($options);

> Note: you have to write complete option including "-" , i had to do this way because there are some options which need "-" this and some which not so it's difficult to know for which option i have to set that that's why you have to provide complete option.

  • setScreenSizeToCapture screen size to capture, it accepts two arguments the first being the width and other being the height.
  • startRecording call this method after you have set all the desired options, this will start the screen recording. The method accepts two optional arguments, firstly the desired location to save the video file and secondly the number of seconds to sleep after starting the process. This is useful because ffmpeg takes 1-2 seconds to start the recording, the default value for this is 2 seconds. You can may change this according to your requirements.
  • stopRecording this will stop the screen recording. The method can also take one optional argument, the number of seconds to sleep after starting the process. This is useful because ffmpeg takes 1-2 seconds to start the recording.
  • getVideo returns the saved video file.
  • setBinary for this library you do not require any binary as everything is already included, however, if you need to use any other binary you can provide it using this method.
  • getCommandToRun returns the generated command that will be executed by library. This is useful to check how you have set the options or to debug.
  • getOptions returns an array of all the set options.
  • getBinary returns the currently set binary file i.e ffmpeg.

License

The PHP Screen Recorder is open-sourced software licensed under the MIT license.

Contribution

Thanks to all of the contributors , fork this repository and send me a pull request

Author

Dawood Ikhlaq and Open source community


  Classes of Dawood Ikhlaq  >  PHP Screen Recorder  >  Download Download .zip .tar.gz  >  Support forum Support forum (1)  >  Blog Blog  >  RSS 1.0 feed RSS 2.0 feed Latest changes  
Name: PHP Screen Recorder
Base name: phpscreenrecorder
Description: Capture videos of the current screen with ffmpeg
Version: 1.0.1
PHP version: 5
License: MIT/X Consortium License
All time users: 197 users
All time rank: 8062
Week users: 8 users
Week rank: 86 Up
 
  Groups   Rate classes User ratings   Applications   Files Files  

  Groups  
Group folder image PHP 5 Classes using PHP 5 specific features View top rated classes
Group folder image Graphics Colors, images, charts and picture formats View top rated classes
Group folder image Debug Debug data dumping, bug detection and reporting View top rated classes
Group folder image Audio Voice and music data generation and manipulation View top rated classes
Group folder image Video Movies and video data generation and manipulation View top rated classes


  Innovation Award  
PHP Programming Innovation award nominee
August 2017
Number 2


Prize: PhpStorm IDE 1 year individual subscription
Capturing videos from the user computer screen is useful to help developers understand the way users are interacting with their applications.

This class can capture the current screen by using the ffmpeg program.

Manuel Lemos

  User ratings  
Not enough user ratings

  Applications that use this package  
No pages of applications that use this class were specified.

Add link image If you know an application of this package, send a message to the author to add a link here.

  Files folder image Files  
File Role Description
Files folder imageexamples (1 file)
Files folder imagesrc (1 file)
Files folder imagetests (1 file)
Accessible without login Plain text file composer.json Data Auxiliary data
Accessible without login Plain text file phpunit.xml Data Auxiliary data
Accessible without login Plain text file README.md Doc. Documentation

  Files folder image Files  /  examples  
File Role Description
  Accessible without login Plain text file index.php Example Example script

  Files folder image Files  /  src  
File Role Description
  Plain text file ScreenRecorder.php Class Class source

  Files folder image Files  /  tests  
File Role Description
  Plain text file ScreenRecorderTestSuite.php Class Class source

Install with Composer Install with Composer - Download Download all files: phpscreenrecorder.tar.gz phpscreenrecorder.zip
NOTICE: if you are using a download manager program like 'GetRight', please Login before trying to download this archive.