https://github.com/niklasf/web-boardimage
An HTTP service that renders chess board images
https://github.com/niklasf/web-boardimage
chess lichess png svg webservice
Last synced: 3 months ago
JSON representation
An HTTP service that renders chess board images
- Host: GitHub
- URL: https://github.com/niklasf/web-boardimage
- Owner: niklasf
- License: agpl-3.0
- Created: 2016-11-02T13:30:46.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-12-23T23:02:13.000Z (7 months ago)
- Last Synced: 2025-03-31T17:18:11.803Z (3 months ago)
- Topics: chess, lichess, png, svg, webservice
- Language: Python
- Homepage:
- Size: 201 KB
- Stars: 76
- Watchers: 7
- Forks: 19
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
Awesome Lists containing this project
README
web-boardimage
==============An HTTP service that renders chess board images.
Installation
------------Requires Python and poetry:
```
sudo apt-get install python3-dev libffi-dev libxml2-dev libxslt1-dev libcairo2
poetry install
```Usage
-----```
poetry run python server.py [--port 8080] [--bind 127.0.0.1]
```HTTP API
--------### `GET /board.svg` render an SVG
name | type | default | description
--- | --- | --- | ---
**fen** | string | required | FEN of the position with at least the board part
**orientation** | string | white | `white` or `black`
**size** | int | 360 | The width and height of the image
**lastMove** | string | *(none)* | The last move to highlight, e.g., `f4g6`
**check** | string | *(none)* | A square to highlight for check, e.g., `h8`
**arrows** | string | *(none)* | Draw arrows and circles, e.g., `Ge6g8,Bh7`, possible color prefixes: `G`, `B`, `R`, `Y`
**squares** | string | *(none)* | Marked squares, e.g., `a3,c3`
**coordinates** | bool | *false* | Show a coordinate margin
**colors** | string | lichess-brown | Theme: `wikipedia`, `lichess-brown`, `lichess-blue````
https://backscattering.de/web-boardimage/board.svg?fen=5r1k/1b4pp/3pB1N1/p2Pq2Q/PpP5/6PK/8/8&lastMove=f4g6&check=h8&arrows=Ge6g8,Bh7&squares=a3,c3
```
### `GET /board.png` render a PNG
License
-------web-boardimage is licensed under the AGPLv3+. See LICENSE.txt for the full
license text.