Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.
Awesome Lists | Featured Topics | Projects
https://github.com/yihong0618/githubposter

Make everything a GitHub svg poster and Skyline!
https://github.com/yihong0618/githubposter
bilibili dota2 duolingo github-svg-poster gitlab gpx kindle leetcode shanbay skyline strava twitter wakatime xhr youtube
Last synced: about 8 hours ago
JSON representation
Make everything a GitHub svg poster and Skyline!
Host: GitHub
URL: https://github.com/yihong0618/githubposter
Owner: yihong0618
License: mit
Created: 2021-04-21T04:06:34.000Z (almost 4 years ago)
Default Branch: main
Last Pushed: 2025-01-19T00:17:31.000Z (3 days ago)
Last Synced: 2025-01-19T15:44:32.037Z (2 days ago)
Topics: bilibili, dota2, duolingo, github-svg-poster, gitlab, gpx, kindle, leetcode, shanbay, skyline, strava, twitter, wakatime, xhr, youtube
Language: Python
Homepage:
Size: 154 MB
Stars: 1,795
Watchers: 10
Forks: 294
Open Issues: 9
Metadata Files:
- Readme: README-EN.md
- License: LICENSE
Awesome Lists containing this project

README

        # GitHubPoster

Make everything a GitHub svg poster and [skyline](https://skyline.github.com/)!

##  `svg` in `README` examples

![](https://github.com/yihong0618/GitHubPoster/blob/main/examples/twitter.svg)

## Circular

![](https://github.com/yihong0618/GitHubPoster/blob/main/examples/strava_circular.svg)

## Skyline

![image](https://user-images.githubusercontent.com/15976103/120966953-80d07180-c799-11eb-8769-92554905ab3f.png)

## Support

- **[Strava](#strava)**

- **[Nintendo Switch](#ns)**

- **[GPX](#GPX)**

- **[Duolingo](#duolingo)**

- **[Issue](#Issue)**

- **[YouTube](#Youtube)**

- **[Bilibili](#Bilibili)**

- **[GitHub](#GitHub)**

- **[GitLab](#GitLab)**

- **[Kindle](#Kindle)**

- **[WakaTime](#WakaTime)**

- **[Dota2](#Dota2)**

- **[Nike](#Nike)**

- **[Notion](#Notion)**

- **[Garmin](#Garmin)**

- **[Forest](#Forest)**

- **[Json](#Json)**

- **[Multiple](#Multiple)**

- **[Jike](#Jike)**

- **[Summary](#Summary)**

- **[Todoist](#Todoist)**

- **[OpenLanguage](#OpenLanguage)**

- **[Apple Health](#AppleHealth)**

- **[ChatGPT](#ChatGPT)**

- **[NeoDB](#NeoDB)**

- **[AutoSleep](#AutoSleep)**

## Download

```

git clone https://github.com/yihong0618/GitHubPoster.git

```

## pip install

```

pip3 install -U 'github_poster[all]'

```

## Install(Python3.6+)

```

pip3 install -r requirements.txt

```

## Use

The generated svg is in `OUT_FOLDER`, named with type (for now)

Different types are used as specified below:

- `--year 2021`: You can specify a year (default) or a year range `--year 2012-2021`

- `--special-number1 10 -- special_number2 20`: By default, the number of different colors is automatically generated (special colors), you can also specify the color

- `--special-color1 pink --special-color2 '#33C6A4'`: You can also specify the color

- `--with-animation`: You can add animation (add GOGOGO animation)

- `--animation-time 14`: you can control the animation time (default is 10s), use with `--with-animation`

- `--with-skyline`: You can save skyline `stl` file (default skyline year is to_year),

- `--skyline-with-name`: set to print user name on model, use with `--with-skyline`

- `--is-circular`: With this command, the svg will be circular and with animation

- `--without-type-name`: Support for hiding the name of the build type in the title

- `---stand-with-ukraine`

Other parameters can be found with `python3 -m github_poster  --help`

### GPX

Make your GPX GitHub poster




mv gpx files to `GPX_FOLDER` then run the code

```

python3 -m github_poster gpx --gpx_dir ~/blog/GPX_OUT/ --year 2013-2021

or pip

github_poster github_poster gpx --gpx_dir ~/blog/GPX_OUT/ --year 2013-2021

```

### Strava

Make your Strava GitHub poster

1. Sign in/Sign up [Strava](https://www.strava.com/) account

2. Open after successful Signin [Strava Developers](http://developers.strava.com) -> [Create & Manage Your App](https://strava.com/settings/api)

3. Create `My API Application`: Enter the following information




![My API Application](https://raw.githubusercontent.com/shaonianche/gallery/master/running_page/strava_settings_api.png)

Created successfully：




![](https://raw.githubusercontent.com/shaonianche/gallery/master/running_page/created_successfully_1.png)

4. Use the link below to request all permissions: Replace `${your_id}` in the link with `My API Application` `Client ID`

```

https://www.strava.com/oauth/authorize?client_id=${your_id}&response_type=code&redirect_uri=http://localhost/exchange_token&approval_prompt=force&scope=read_all,profile:read_all,activity:read_all,profile:write,activity:write

```

![get_all_permissions](https://raw.githubusercontent.com/shaonianche/gallery/master/running_page/get_all_permissions.png)

5. Get the `code` value in the link




example：

```

http://localhost/exchange_token?state=&code=1dab37edd9970971fb502c9efdd087f4f3471e6e&scope=read,activity:write,activity:read_all,profile:write,profile:read_all,read_all

```

`code` value：

```

1dab37edd9970971fb502c9efdd087f4f3471e6

```

![get_code](https://raw.githubusercontent.com/shaonianche/gallery/master/running_page/get_code.png)

6. Use `Client_id`、`Client_secret`、`Code` get `refresch_token`: Execute in `Terminal/iTerm`

```

curl -X POST https://www.strava.com/oauth/token \

-F client_id=${Your Client ID} \

-F client_secret=${Your Client Secret} \

-F code=${Your Code} \

-F grant_type=authorization_code

```

example：

```

curl -X POST https://www.strava.com/oauth/token \

-F client_id=12345 \

-F client_secret=b21******d0bfb377998ed1ac3b0 \

-F code=d09******b58abface48003 \

-F grant_type=authorization_code

```

![get_refresch_token](https://raw.githubusercontent.com/shaonianche/gallery/master/running_page/get_refresch_token.png)

```

python3 -m github_poster --strava_client_id  ${client_id} --strava_client_secret ${client_secret} --strava_refresh_token ${refresh_token} --year 2012-2021

or pip

github_poster --strava_client_id  ${client_id} --strava_client_secret ${client_secret} --strava_refresh_token ${refresh_token} --year 2012-2021

```

### NS

Make your Nintendo Switch GitHub poster




From APP`(Nintendo Switch Parent Controls)` using `mitmproxy` to get the `session_token` and `devide _id`

```

python3 -m github_poster ns --ns_session_token ${session_token} --ns_device_id ${device_id} --year 2020-2021

or pip

github_poster ns --ns_session_token ${session_token} --ns_device_id ${device_id} --year 2020-2021

```

### Duolingo

Make your Duolingo GitHub poster




1. login duolingo in broswer

2. console `document.cookie.match(new RegExp('(^| )jwt_token=([^;]+)'))[0].slice(11)` get duolingo_jwt

Find your `duolingo id`, F12 from `XHR`

![image](https://user-images.githubusercontent.com/15976103/116336188-baad7000-a80a-11eb-80d7-033d4bf0f260.png)

```

python3 -m github_poster duolingo --duolingo_user_name ${duolingo_user_name}  --duolingo_jwt ${duolingo_jwt}  --year 2015-2021

or

github_poster duolingo --duolingo_user_name ${duolingo_user_name} --duolingo_jwt ${duolingo_jwt} --year 2015-2021

```

### Issue

Make your Issue GitHub poster




Like my [issue](https://github.com/yihong0618/2021/issues/5)

```

	python3 -m github_poster issue --issue_number ${issue_number} --repo_name ${repo_name} --token ${github_token}

or

github_poster issue --issue_number ${issue_number} --repo_name ${repo_name} --token ${github_token}

```

### LeetCode

Make your LeetCode GitHub poster




Find your `LeetCode Cookie`

```

python3 -m github_poster leetcode --leetcode_cookie ${leetcode_cookie} --year 2019-2021

or

github_poster leetcode --leetcode_cookie ${leetcode_cookie} --year 2019-2021

```

### Youtube

Make your YouTube GitHub poster




Use Google [History Takeout](https://takeout.google.com/settings/takeout) to download `YouTube` history data，choose `json` format，mv `watch-history.json` to `IN-FOLDER` then run the code

```

python3 -m github_poster youtube --year 2015-2021

or

github_poster youtube --year 2015-2021

```

### Bilibili

Make your Bilibili GitHub poster




Find your `Bilibili (XHR) cookie`

```

python3 -m github_poster bilibili --cookie "${bilibili-cookie}"

or

github_poster bilibili --cookie "${bilibili-cookie}"

```

### GitHub

Make your GitHub GitHub poster




Get your `GitHub Name` (in the url)

```

python3 -m github_poster github --github_user_name "${github_user_name}" --with-skyline

or

github_poster github --github_user_name "${github_user_name}" --with-skyline

```

### GitLab

Make your GitLab GitLab poster




Get your `GitLab Name` (in the url)

```

python3 -m github_poster gitlab --gitlab_user_name "${gitlab_user_name}"

or

github_poster gitlab --gialab_user_name "${gitlab_user_name}"

```

For self-managed `GitLab`, specify the base url of your instance. You should use `_gitlab_session` from Cookies if sign in required.

s

```

python3 -m github_poster gitlab --gitlab_user_name "${gitlab_user_name}" --base_url "https://your-gitlab.com" --session "${gitlab_session}"

or

github_poster gitlab --gitlab_user_name "${gitlab_user_name}" --base_url "https://your-gitlab.com" --session "${gitlab_session}"

```

### Kindle

Make your Kindle GitHub poster




Find your [Amazon](https://www.amazon.com/) Cookie

```

python3 -m github_poster kindle --kindle_cookie ${kindle_cookie} --cn --year 2018-2021

or

github_poster kindle --kindle_cookie ${kindle_cookie} --cn --year 2018-2021

```

### WakaTime

Make your WakaTime poster




Find your own `WakaTime API Key` at: [WakaTime API Key](https://wakatime.com/settings/api-key)

```

python -m github_poster wakatime --wakatime_key="your_wakatime_api_key" --year 2019-2021

or

github_poster wakatime --wakatime_key="your_wakatime_api_key" --year 2019-2021

```

### Dota2

Make your Dota2 poster




Find your `dota2_id`, eg：Dendi's ID `70388657`

Check your dota2_id(steamid32): https://steamid.xyz/.

Check your game data: https://api.opendota.com/api/players/{dota2_id}/matches.

more info: https://docs.opendota.com/#section/Introduction

```

python -m github_poster dota2 --dota2_id="your dota2 id" --year 2017-2018

or

github_poster dota2 --dota2_id="your dota2 id" --year 2017-2018

```

### Nike

Make your  Nike  poster>

**ALL need to do outside GFW**

![example img](https://user-images.githubusercontent.com/67903793/282300381-4e7437d0-65a9-4eed-93d1-2b70e360215f.png)

1. Login from this [website](https://unite.nike.com/s3/unite/mobile.html?androidSDKVersion=3.1.0&corsoverride=https%3A%2F%2Funite.nike.com&uxid=com.nike.sport.running.droid.3.8&backendEnvironment=identity&view=login&clientId=VhAeafEGJ6G8e9DxRUz8iE50CZ9MiJMG), open F12 -> XHR -> get the `refresh_token` from login api.

2. copy this `refresh_token` and use it in GitHub Secrets or in command line

```

python3 -m github_poster nike --nike_refresh_token="your nike_refresh_token" --year 2012-2021

or

github_poster nike --nike_refresh_token="your nike_refresh_token" --year 2012-2021

```

### Notion

Make your  Notion  poster

Get Notion `Internal Integration Token`(notion_token), see [here](https://developers.notion.com/docs/authorization#authorizing-internal-integrations) for more details.

1. Sign in [Notion](https://www.notion.so/my-integrations) developers site

2. Click 'New integration' to create a new token

3. You can see `Internal Integration Token` below `Secrets` after submit

Get Notion Database ID(database_id), see [here](https://developers.notion.com/docs/working-with-databases#adding-pages-to-a-database) for more details.

1. Open the database as a full page in Notion

2. Use the `Share` menu to `Copy link`, and you'll get a URL looks like `https://www.notion.so/{workspace_name}/{database_id}?v={view_id}`

3. The part that corresponds to `{database_id}` is the ID of your Notion Database

Note：The database need a property which type is `Date`, the value of it will be used to generate the poster.

The name of the date property should be set as option `prop_name`'s value，default value is `Datetime`

```

python3 -m github_poster notion --notion_token="your notion_token" --database_id="your database_id" --prop_name="your prop_name"

or

github_poster notion --notion_token="your notion_token" --database_id="your database_id" --prop_name="your prop_name"

```

### Garmin

Make your  Garmin  poster

需要填写 Garmin 的账号和密码

```

python3 -m github_poster garmin --garmin_user_name ${user_name} --garmin_password ${pass_word} --year 2016-2021 --special-color1 blue --special-color2 pink --me yihong0618 --cn

or

github_poster garmin --garmin_user_name ${user_name} --garmin_password ${pass_word} --year 2016-2021 --special-color1 blue --special-color2 pink --me yihong0618 --cn

```

### Forest

Make your  Forest  GitHub poster




Need to add your Forest email and password

```

python3 -m github_poster forest --forest_email ${user_name} --forest_password ${pass_word} --year 2016-2021 --special-color1 blue --me yihong0618

or

github_poster forest --forest_email ${user_name} --forest_password ${pass_word} --year 2016-2021 --special-color1 blue --me yihong0618

```

### Json

Make your Json(source data) types poster




make sure your json file format is like `data.json` in examples

```

python3 -m github_poster json --json_file "your json data file" --year 2019-2021 --me PythonHunter

or

github_poster json --json_file "your json data file" --year 2019-2021 --me PythonHunter

```

### Multiple

Make your Multiple types poster




support multiple types

```

python3 -m github_poster multiple  --types "github, strava"  --github_user_name "github user name" --strava_client_id  "your strava client id"  --strava_client_secret "your strava client secret"  --strava_refresh_token "your strava refresh token"  --year 2020-2021

or

github_poster multiple  --types "github, strava" --github_user_name "github user name" --strava_client_id  "your strava client id"  --strava_client_secret "your strava client secret"  --strava_refresh_token "your strava refresh token"  --year 2020-2021

```

### Summary

Make your Summary types poster




support summary types

```

python3 -m github_poster summary  --types "github, strava"  --github_user_name "github user name" --strava_client_id  "your strava client id"  --strava_client_secret "your strava client secret"  --strava_refresh_token "your strava refresh token"  --year 2021

or

github_poster summary  --types "github, strava"  --github_user_name "github user name" --strava_client_id  "your strava client id"  --strava_client_secret "your strava client secret"  --strava_refresh_token "your strava refresh token"  --year 2021

```

### Jike

Make your Jike(source data) types poster




need to find your Jike cookie from `Jike (XHR)` and `jike_user_id`, `jike_user_id` can be found in your personal page link

eg. in the link `https://web.okjike.com/u/82D23B32-CF36-4C59-AD6F-D05E3552CBF3`, `82D23B32-CF36-4C59-AD6F-D05E3552CBF3` is the user_id

ps. only get the data for the last year

```

python3 -m github_poster jike --jike_cookie "your jike cookie" --jike_user_id 'your jike user id' --year 2021 --me "your name" --with-animation --animation-time 14 --count_type 'like'

or

github_poster jike --jike_cookie "your jike cookie" --jike_user_id "your jike user id" --year 2021 --me "your name" --with-animation --animation-time 14 --count_type 'like'

```

Option argument `count_type`, you can specify statistics type:

- `record`: post num (default)

- `like`: post be liked num

- `share`: post be share num

- `comment`: post be comment num

- `repost`: post be repost num

### Todoist

Make  Todoist Task Completion  GitHub poster

Because of Todoist policies, only users with Pro Plan(or above) can retrieve full historical activity from APIs.

Get your token please find on [Todoist Developer Docs](https://developer.todoist.com/guides/#developing-with-todoist)




```

python3 -m github_poster todoist --year 2021-2022 --todoist_token "your todoist dev token" --me "your name"

or

github_poster todoist --year 2021-2022 --todoist_token "your todoist dev token" --me "your name"

```

### OpenLanguage

Make  OpenLanguage  GitHub poster

For some reason, make sure your password only has letters and numbers, otherwise you will get an error.




```

python3 -m github_poster openlanguage --year 2021-2022 --openlanguage_user_name "you account" --openlanguage_password "you password" --me "your name"

or

github_poster openlanguage --year 2021-2022 --openlanguage_user_name "you account" --openlanguage_password "you password" --me "your name"

```

### AppleHealth

Make  Apple Health  GitHub poster

Apple Health has plenty of data that can be visualized. 

At this moment this loader only supports Move, Exercise, and Stand data from Apple Watch Activity but any record Apple Health has can be supported in the same way.

Loader has two modes: 

increment mode (default）is good for daily update. iOS Shortcut can be used to trigger a workflow running loader on this mode.

Read [this repo](https://github.com/yihong0618/iBeats) for more details.




```

python3 -m github_poster apple_health --date  --value  --apple_health_record_type  --me "your name"

or

github_poster apple_health --appple_health_date  --apple_health_value  --apple_health_record_type  --me "your name"

```

backfill mode is good for dumping all data at once.

Open the Health App, click on the avatar on the top right corner, select "Export All Health Data" on the bottom, copy the zip file to `IN-FOLDER` and unzip. You will get a `apple_health_export` folder. Then run:




```

python3 -m github_poster apple_health --apple_health_mode backfill --year 2015-2021 --apple_health_record_type  --me "your name"

or

github_poster apple_health --apple_health_mode backfill --year 2015-2021 --apple_health_record_type  --me "your name"

```

### ChatGPT

Make your  ChatGPT  GitHub poster




Copy the conversations.json from ChatGPT's official export history to `IN-FOLDER`, then run (renamed to chatgpt-history.json)

```

python3 -m github_poster chatgpt 

or

github_poster chatgpt --me yihong0618

```

### NeoDB

Make your NeoDB GitHub poster




Using the API provided by NeoDB, we can easily make GitHub Poster with marks as data.

An access token is needed, which can be obtained from [NeoDB's developer page](https://neodb.social/developer).

There are to parameters for neodb module. `neodb_token`` is the token you get from [NeoDB's developer page](https://neodb.social/developer), `mark_type`` is the type of marks you want to import, which can be one of `complete`, `wishlist` and `progress`.

```

python3 -m github_poster neodb --neodb_token  --mark_type  --me "your name"

```

Moreover, you can choose `all` as `mark_type` to import all marks.

### AutoSleep

Make your AutoSleep Github poster




Export your `AutoSleep` data from app（eg. autosleep.csv）, then run

```

python3 -m github_poster autosleep --autosleep_file "your csv file" --me "your name"

or

github_poster autosleep --autosleep_file "your csv file" --me "your name"

```

# Contribution

- Any Issues PR welcome.

- Any new loader welcome

- how to write new loader by `ruter`(Chinese) [如何为 GithubPoster 添加 loader](https://umm.js.org/p/c88bf4c7/)

Before submitting PR:

- Format Python code with `black` (`black .`)

- Format Python code with `isort` (`isort --profile black  **/**/*.py`)

# TODO

- [x] twitter

- [x] GitLab

- [x] GitHub

- [x] LeetCode

- [x] GitHub from issues

- [x] YouTube

- [x] Bilibili

- [x] GitHub Actions

- [x] Change all default color

- [x] Skyline

- [x] Dota2

- [x] pypi

- [x] test

- [x] English README

- [x] Loader doc

- [ ] Refactor some code

# GitHub Actions

1. fork or clone this repo

2. Change the secrets

3. Change the `type` in `yml` file

![image](https://user-images.githubusercontent.com/15976103/116517569-be6fee00-a901-11eb-9178-55df0c3301e3.png)

![image](https://user-images.githubusercontent.com/15976103/116517636-d21b5480-a901-11eb-90e7-8314404f5f59.png)

# Special thanks

- @[flopp](https://github.com/flopp) great repo [GpxTrackPoster](https://github.com/flopp/GpxTrackPoster)

- @[JasonkayZK](https://github.com/JasonkayZK) Wakatime loader

- @[shaonianche](https://github.com/shaonianche) Dota2 loader

- @[umm233](https://github.com/umm233) Jike loader

- @[ruter](https://github.com/ruter) Notion loader

- @[frostming](https://github.com/frostming) `CI` refator and some Actions code

- @[j178](https://github.com/j178) refator the import logic

- @[iamshaynez](https://github.com/iamshaynez) todolist loader

- @[guaguaguaxia](https://github.com/guaguaguaxia) OpenLanguage loader

- @[rip-tyang](https://github.com/rip-tyang) AppleHealth loader

# Support

Thanks is enough.