https://github.com/kenwuqianghao/chess.com-readme
Readme badge dispalying your chess.com rating
https://github.com/kenwuqianghao/chess.com-readme
chess chessdotcom flask python readme
Last synced: 3 months ago
JSON representation
Readme badge dispalying your chess.com rating
- Host: GitHub
- URL: https://github.com/kenwuqianghao/chess.com-readme
- Owner: KenWuqianghao
- License: mit
- Created: 2023-05-29T15:40:44.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2026-02-27T11:13:30.000Z (5 months ago)
- Last Synced: 2026-02-27T16:29:52.388Z (5 months ago)
- Topics: chess, chessdotcom, flask, python, readme
- Language: Python
- Homepage: https://chess-com-read-me.vercel.app
- Size: 53.7 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Chess.com-ReadME
Chess.com-Readme
📍 Share your Chess.com Elo on your GitHub Readme page
🚀 Developed with the software and tools below.
---
## 📚 Table of Contents
- [📚 Table of Contents](#-table-of-contents)
- [📍Overview](#-introdcution)
- [⚙️ Project Structure](#project-structure)
- [🧩 Modules](#modules)
- [🏎💨 Getting Started](#-getting-started)
- [🤝 Contributing](#-contributing)
- [🪪 License](#-license)
---
## 📍Overview
The Chess.com-Readme project creates a badge for your github readme with your chess.com elo rating on it.
---
## ⚙️ Project Structure
```bash
repo
├── app.py
├── LICENSE
├── README.md
├── requirements.txt
├── templates
│ └── card.html.j2
└── vercel.json
2 directories, 6 files
```
---
## 💻 Modules
Root
| File | Summary | Module |
|:----------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:----------|
| app.py | This code creates a web application using Flask that generates a card displaying a user 's rating on Chess.com for a specified time control . It uses the chessdotcom library to access the user 's stats and the dotenv library to access environment | app.py |
Templates
| File | Summary | Module |
|:-------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-----------------------|
| card.html.j2 | This code creates an SVG graphic with two rectangles , one in # 555 and one in # 007ec6 , and two text elements displaying the values of the variables " time_control " and " elo " . The graphic is 139x20 | templates/card.html.j2 |
## 🚀 Getting Started
### ✅ Prerequisites
Before you begin, ensure that you have the following prerequisites installed:
> `Register for a vercel account`
### 💻 Installation
1. Fork this repo
2. Go to vercel and create a new project using the forked repo
3. Specify the environment variables username and time_control, time_control has options chess_bullet, chess_blitz and chess_rapid, if not specified, the highest rating in any time control will be used.
### 🤖 Using Chess.com-Readme
```sh
```
---
## 🤝 Contributing
Contributions are always welcome! Please follow these steps:
1. Fork the project repository. This creates a copy of the project on your account that you can modify without affecting the original project.
2. Clone the forked repository to your local machine using a Git client like Git or GitHub Desktop.
3. Create a new branch with a descriptive name (e.g., `new-feature-branch` or `bugfix-issue-123`).
```sh
git checkout -b new-feature-branch
```
4. Make changes to the project's codebase.
5. Commit your changes to your local branch with a clear commit message that explains the changes you've made.
```sh
git commit -m 'Implemented new feature.'
```
6. Push your changes to your forked repository on GitHub using the following command
```sh
git push origin new-feature-branch
```
7. Create a pull request to the original repository.
Open a new pull request to the original project repository. In the pull request, describe the changes you've made and why they're necessary.
The project maintainers will review your changes and provide feedback or merge them into the main branch.
---
## 🪪 License
This project is licensed under the `MIT` License. See the [LICENSE](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/adding-a-license-to-a-repository) file for additional info.
---