letterboxd-ics is a package to render a Letterboxd diary in iCalendar format.

How to install (Heroku)

Deploy to Heroku

The installation will prompt you to set the LETTERBOXD_USERNAME and LETTERBOXD_PASSWORD secrets.

How to install (standalone)

If you want to use the standalone package, you can do the following:

git clone https://github.com/cmbuckley/letterboxd-ics.git
cd letterboxd-ics
composer install

Once you have the package and its dependencies, set environment variables LETTERBOXD_USERNAME and LETTERBOXD_PASSWORD to your credentials, then point a Web server at the public folder.

How to install (Packagist)

Alternatively, letterboxd-ics is available on Packagist, so it can be specified as a dependency using Composer:

    "require": {
        "cmbuckley/letterboxd-ics": "~5.0"

How to use

You can specify your own options:

require 'vendor/autoload.php';

$calendar = new Starsquare\Letterboxd\Calendar(array(
    'auth' => array(
        'username' => 'user@example.com',
        'password' => 'password',

echo $calendar;

Other configuration options:

Alternatively, you can define your configuration options in a JSON-encoded config file, and pass the file path to the Calendar object. An example is provided in the public folder.