Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vsnthdev/twitter-banner

Automatically ๐Ÿค– updates Twitter banner โŒš every few minutes.
https://github.com/vsnthdev/twitter-banner

actions artwork github-actions puppeteer social-media twitter

Last synced: about 14 hours ago
JSON representation

Automatically ๐Ÿค– updates Twitter banner โŒš every few minutes.

Awesome Lists containing this project

README

        


twitter-banner

Automatically ๐Ÿค– updates Twitter banner โŒš every few minutes.




CI/CD Status


Twitter followers


Project issues


Project commits

Unlike my previous approach where I used Redis + Digital Ocean + Docker to update the Twitter profile banner, this approach does not need to be deployed separately & uses Github Actions instead. Read how it works for more information.

> Tweet me @vsnthdev, I would love to know your opinion/experience on this project ๐Ÿ˜

## โœจ Usage Guide

You can easily have this project change your Twitter profile's cover image by following the below steps:

1. Fork [this repository](https://github.com/vsnthdev/twitter-banner/fork)
2. Set the [below environment variables](#%EF%B8%8F-environment-variables) as repository secrets
3. Enable workflows on the forked repository
4. Update the banner image at [`data/background.png`](https://github.com/vsnthdev/twitter-banner/blob/main/data/background.png)
5. Optionally update the stylesheet at [`data/styles.css`](https://github.com/vsnthdev/twitter-banner/blob/main/data/styles.css)
6. Select the "Banner Update" workflow & click on "Run workflow"

## ๐Ÿ’ก How It Works

## ๐Ÿ•๏ธ Environment Variables

| Variable | Description | Default Value |
| -------- | ----------- | ------------- |
| `BACKGROUND_IMAGE` | Background image name | `background.png` |
| `STYLESHEET_NAME` | The CSS filename | `styles.css` |
| `NO_FOLLOWERS` | Number of followers to get images of | `4` |
| `TWITTER_USERNAME` | Your Twitter username | |
| `TWITTER_API_KEY` | Twitter API key from developer dashboard | |
| `TWITTER_API_SECRET` | Twitter API secret from developer dashboard | |
| `TWITTER_ACCESS_TOKEN` | Twitter API access token with read/write permissions | |
| `TWITTER_TOKEN_SECRET` | Twitter API token secret with read/write permissions | |
| `IMAGES_CONTAINER_ID` | ID of the div where images will be attached | `images` |

## ๐Ÿ“‹ License

> The **twitter-banner** project is released under the [GPL v2](https://github.com/vsnthdev/twitter-banner/blob/main/LICENSE.md).
Developed & maintained By Vasanth Srivatsa. Copyright 2022 ยฉ Vasanth Developer.


> vsnth.dev ย ยทย 
> YouTube @vasanthdeveloper ย ยทย 
> Twitter @vsnthdev ย ยทย 
> Discord Vasanth Developer