GitHub Profile Languages

API that generates GitHub-themed SVGs that show the percentage of a language in public repositories

Inspired by GitHub Readme Stats and Shields.io

Preview

My GitHub profile README

Dark Themes

Language Bar:

Language Button (default, high contrast, dimmed):

Light Themes

Language Bar:

Language Button (default, high contrast):

Deployment

1. Fork this repository

2. Generate a GitHub personal access token with public_repo permission

3. Go to Vercel and Continue with GitHub

4. Click Add New... > Project

5. Find your repository and click Import

6. Click Environment Variables and add GPL_TOKEN and GPL_USERNAME

7. (Optional) Add languages that you want to ignore as comma-separated values (no spaces)

Supported languages

8. Click Deploy

9. Click Continue to Dashboard

10. Check your domains under DOMAINS

Usage

Language Bar

Copy and paste the following Markdown and change DOMAIN, WIDTH, and THEME

Supported themes

![GitHub Profile Languages - Bar](DOMAIN/api/bar?width=WIDTH&theme=THEME)

Example:

• DOMAIN → https://github-profile-languages.vercel.app
• WIDTH → 830
• THEME → dark

![GitHub Profile Languages - Bar](https://github-profile-languages.vercel.app/api/bar?width=830&theme=dark)

Result:

Language Button

Copy and paste the following Markdown and change DOMAIN, LANGUAGE, and THEME

Supported languages

Supported themes

![GitHub Profile Languages - Button](DOMAIN/api/button?language=LANGUAGE&theme=THEME)

Example:

• DOMAIN → https://github-profile-languages.vercel.app
• LANGUAGE → C%2b%2b (Percent-encoded "C++")
• THEME → dark

![GitHub Profile Languages - Button](https://github-profile-languages.vercel.app/api/button?language=C%2b%2b&theme=dark)

Result:

Language Stats

Visit DOMAIN/api/stats for raw language statistics

Example:

• DOMAIN → https://github-profile-languages.vercel.app

https://github-profile-languages.vercel.app/api/stats

Result:

README Generator

Visit DOMAIN/api/readme to generate a README file

Example:

• DOMAIN → https://github-profile-languages.vercel.app

https://github-profile-languages.vercel.app/api/readme

Result:

Percent-encoding

ASCII	2x	ASCII	3x	ASCII	4x	ASCII	5x	ASCII	6x	ASCII	7x
space	%20	:	%3a	@	%40	[	%5b	`	%60	{	%7b
!	%21	;	%3b			\	%5c			|	%7c
"	%22	<	%3c			]	%5d			}	%7d
#	%23	=	%3d			^	%5e			~	%7e
$	%24	>	%3e			_	%5f
%	%25	?	%3f
&	%26
'	%27
(	%28
)	%29
*	%2a
+	%2b
,	%2c
-	%2d
.	%2e
/	%2f