Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/maximealgosup/fresco-maker
A picture converter to rubiks cube instructions.
https://github.com/maximealgosup/fresco-maker
python rubiks-cube-solver
Last synced: about 2 months ago
JSON representation
A picture converter to rubiks cube instructions.
- Host: GitHub
- URL: https://github.com/maximealgosup/fresco-maker
- Owner: MaximeAlgosup
- License: mit
- Created: 2023-09-27T18:27:53.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-02-05T18:39:41.000Z (11 months ago)
- Last Synced: 2024-11-05T10:45:01.476Z (about 2 months ago)
- Topics: python, rubiks-cube-solver
- Language: Python
- Homepage:
- Size: 771 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Fresco Maker
Fresco Maker is a little software who is made and used by the team 6 of ALGOSUP students to split their fresco and give instruction manual to each others teams
We created this program with [Python 3.11.6](docs.python.org/3.11/)
## Installation
Do a gitclone and start the Initialization
#### Libraries Required :
- [tkinter](https://tkdocs.com/tutorial/index.html)
- [reportlab](https://docs.reportlab.com/reportlab/userguide/ch5_platypus/)
- [Pillow](https://pypi.org/project/Pillow/)
- [itertools](https://docs.python.org/3/library/itertools.html)
- [matplotlib](https://matplotlib.org/stable/index.html)
- [mpl_toolkits](https://matplotlib.org/1.3.0/mpl_toolkits/index.html)
## Initilization
If you want to use it you need to build the app to do that open your terminal and execute:
```bash
python setup.py build
```
[cx_freeze](https://cx-freeze.readthedocs.io/en/stable/) will build your executable app to run
## Usage
- To use it you just need to run the executable file, when the GUI appears you need to put the path of your fresco image with valid proportion.
- Choose the number of teams to split the fresco in equal parts for each team
- Accept the documentation generation
- And let's run !
## How does it work ?
This will be done in the following 5 steps:
1. Fresco Picture splitting in equal part among the teams
2. Split the team cut image in images of 3x3 pixels
3. Get each 3x3 image and get colors for each pixel
4. Generate the list of all movements to solve the cube
5. Generate a pdf for each team with a detailed manual to create all rubiks face
Now Follow the documentation and realize your fresco !
## License
[MIT](./LICENSE)
