Skip to content

DeutscheModelUnitedNations/badgeGenerator

Repository files navigation

Badge and Placard Generator

This repository contains a tool designed to generate Name Badges and Placards for Model United Nations (MUN) Conferences. The project is structured to make it easy to customize and generate tags for various events or purposes just using a tabular data source (csv, xlsx, google sheets link).

Features

  • templates
    • horizontal badge - 85mm x 55mm for pinning
    • vertical badge - 55mm x 85mm for lanyard
    • placard - A4 for table display
  • Simple integration
    • csv - Comma Separated Values
    • xlsx - Excel Spreadsheet
    • google sheets - Google Sheets Link
  • Custom Image Support: Add a custom image to the badge or use built in flag library
  • Easy-to-use interface for generating printable tags

FAQ

Why does the project not supply an arm64 image?

Sqlite3 needs to be installed from source on arm64 systems. Since we don't deploy on arm64 systems yet, we took the easy way out and built the image for amd64 systems only. Please feel free to open an issue if you need an arm64 image.

Usage

Important

The project is custom tailored for Conferences of Deutsche Model United Nations and contains logos and corporate identity elements of the organization. To customize the project for your own use, you will need to replace the logos and other elements with your own and adjust the templates as needed.

  1. Clone the repository.
  2. Customize the configuration or templates as needed.
  3. Build the docker image.

Getting Started

Ensure you have the necessary prerequisites installed. Follow the instructions in the documentation for setup and execution.

Contributing

Contributions are welcome. Please open an issue or submit a pull request with improvements. Feel free to reach out to the maintainers for any questions or concerns.

License

This project is licensed under the MIT License.