Skip to content
Bring your user and service stories to life through automation
PHP Other
Latest commit 882f175 Apr 5, 2016 @stuartherbert stuartherbert Merge tag '2.3.9' into develop
- bugfix release
- see CHANGELOG for details


Bring your user and service stories to life through your tests.


Storyplayer should be installed via Composer. To install Storyplayer, create a composer.json file with the following contents:

    "require": {
        "datasift/storyplayer": "~2.0"

Then, run composer install. Once that's completed, run ./vendor/bin/storyplayer install to install any additional dependencies.


If your tests need a web browser, make sure you've started browsermob-proxy and selenium:

./vendor/bin/ start
./vendor/bin/ start

Basic usage is:

./vendor/bin/storyplayer <story>


  • <story> is the path to the PHP file containing your story and its test

Full Documentation

You'll find our docs at They're currently a work-in-progress.



Contributions are most welcome.

  1. Fork on GitHub
  2. Create a feature branch
  3. Commit your changes with tests
  4. New feature? Send a pull request against the develop branch.
  5. Bug fix? Send a pull request against the master branch.

Please don't break backwards-compatibility :)


New BSD license. Full details are in the LICENSE.txt file.

Something went wrong with that request. Please try again.