Skip to content
This repository has been archived by the owner on Nov 28, 2023. It is now read-only.

Bring your user and service stories to life through automation


Notifications You must be signed in to change notification settings


Repository files navigation


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.