dynacover

Dynacover

Dynacover is a PHP GD + TwitterOAuth CLI app to dynamically generate Twitter header images and upload them via the API. This enables you to build cool little tricks, like showing your latest followers or GitHub sponsors, your latest content created, a qrcode to something, a progress bar for a goal, and whatever you can think of.

Installation

You can run Dynacover in three different ways:

• as a GitHub action: the easiest way to run Dynacover is by setting it up in a public repository with GitHub Actions, using repository secrets for credentials. Follow this step-by-step guide to set this up - no coding required.
• with Docker: you can use the public erikaheidi/dynacover Docker image to run Dynacover with a single command, no PHP required. Follow this guide to set this up.
  • to further customize your cover, you can clone the dynacover repo to customize banner resources (JSON template and header images, both located at app/Resources), then build a local copy of the Dynacover Docker image to use your custom changes.
• with a PHP CLI environment: this will require php-cli 8.1+, Composer, and a few extensions: php-gd, php-mbstring, php-curl, and php-json. Follow this guide to set it up.

Obtaining Required Tokens

To upload your header images, you'll need to register an application within the Twitter Developers Portal and obtain 4 tokens:

• Consumer / App Token
• Consumer / App Secret
• User / Access Token
• User / Access Token Secret

Additionally, you can set up a Personal GitHub API key to fetch your sponsors, in case you are enrolled in the GitHub Sponsors program. In this case, you should use the included template. This is optional.