Skip to content
An open source Buffer app
Find file
Pull request Compare This branch is 97 commits behind julien-c:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


An open source Buffer app built on Backbone, Bootstrap and MongoDB

Tampon is built as a Backbone.js application that communicates with a MongoDB datastore through a REST API written in PHP.

The server part is intended to be the dumbest possible, i.e. we tried to put most "intelligence" in the Backbone app, not in the API. (For example, the API only takes UNIX timestamps and posts' content, while the Backbone app computes the scheduled timestamps).

A daemon based on PHP-Daemon then runs in the background and is responsible for sending your posts to Twitter when they're due.



  • MongoDB, and PHP's MongoDB driver
  • To run the background daemon based on PHP-Daemon, you need the POSIX and PCNTL extensions for PHP.


  • Make sure you cloned this repo recursively, i.e. with submodules that are in extlib
  • Create a new Twitter application on, then copy your credentials into api/config.php.sample and rename it to api/config.php
  • Your application's frontend should now be accessible where you set it up, for instance at http://localhost/Tampon. The MongoDB datastore's name will be tampon (you don't have to explicitly create it).
  • Start the daemon with php Daemon/run.php
    • Use option -d to run as daemon, i.e. detach and run in the background
    • Your daemon's log will be in /var/log/daemons/tampon, or if this is not writable, in Daemon/logs. You can use/rotate this log to monitor your daemon.
  • That's it!


Something went wrong with that request. Please try again.