This package is abandoned and no longer maintained. No replacement package was suggested.

Bring your user and service stories to life through test automation

2.3.9 2016-04-05 10:31 UTC


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


This project is no longer maintained by DataSift.


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.