This project allows you to generate certificates using a PowerPoint (.pptx
) template. By leveraging Python, it automates the creation of personalized certificates based on a provided template and configuration.
- Generate certificates from a
.pptx
template. - Customize certificate content through configuration files.
- Batch processing for multiple certificates.
- Python 3.x
- Required Python packages (listed in
requirements.txt
)
-
Clone the Repository:
git clone https://github.com/francisco-polaco/certificate-generator.git cd certificate-generator
-
Install Dependencies:
It's recommended to use a virtual environment:
python3 -m venv venv source venv/bin/activate # On Windows, use venv\Scripts\activate
Then, install the required packages:
pip install -r requirements.txt
-
Prepare Your Template:
- Create a PowerPoint (
.pptx
) file that serves as your certificate template. - Use placeholders (e.g.,
{name}
,{date}
) in the template where dynamic content should appear.
- Create a PowerPoint (
-
Configure the Application:
- Edit the
config.yml
file to specify the template path, output directory, and any other configurations. - Ensure that your data source (e.g., a XLSX file with participant names) is correctly referenced in the configuration.
- Edit the
-
Generate Certificates:
Run the main script:
python main.py
The generated certificates will be saved in the specified output directory.
Contributions are welcome! Feel free to open issues or submit pull requests to enhance the functionality or fix bugs.
This project is licensed under the MIT License. See the LICENSE
file for more details.
Note: This README provides a general overview. For detailed instructions and advanced configurations, please refer to the project's documentation or source code comments.*