{"id":15055793,"url":"https://github.com/santulator/santulator","last_synced_at":"2025-04-05T06:07:23.852Z","repository":{"id":49189949,"uuid":"122751554","full_name":"Santulator/Santulator","owner":"Santulator","description":"🎁 A Secret Santa draw generator that creates beautiful PDFs for each participant","archived":false,"fork":false,"pushed_at":"2024-11-25T21:11:13.000Z","size":8762,"stargazers_count":146,"open_issues_count":6,"forks_count":28,"subscribers_count":6,"default_branch":"master","last_synced_at":"2025-04-05T06:07:14.724Z","etag":null,"topics":["christmas","javafx","javafx-application","javafx-desktop-apps","testfx"],"latest_commit_sha":null,"homepage":"https://santulator.github.io/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Santulator.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-02-24T15:17:17.000Z","updated_at":"2025-03-26T16:14:18.000Z","dependencies_parsed_at":"2024-07-28T16:33:59.822Z","dependency_job_id":"12db937f-9422-4ccf-8589-95a407d2d054","html_url":"https://github.com/Santulator/Santulator","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Santulator%2FSantulator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Santulator%2FSantulator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Santulator%2FSantulator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Santulator%2FSantulator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Santulator","download_url":"https://codeload.github.com/Santulator/Santulator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247294538,"owners_count":20915340,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["christmas","javafx","javafx-application","javafx-desktop-apps","testfx"],"created_at":"2024-09-24T21:46:24.298Z","updated_at":"2025-04-05T06:07:23.826Z","avatar_url":"https://github.com/Santulator.png","language":"Java","readme":"# 🎁 Santulator\n\n[![Build Status](https://img.shields.io/travis/Santulator/Santulator/master.svg)](https://travis-ci.org/Santulator/Santulator)\n[![Code Coverage](https://img.shields.io/codecov/c/github/Santulator/Santulator.svg)](https://codecov.io/gh/Santulator/Santulator)\n[![SonarCloud](/assets/SonarCloud.svg)](https://sonarcloud.io/dashboard?id=io.github.santulator%3Asantulator)\n[![Latest Release](https://img.shields.io/github/release/Santulator/Santulator.svg)](https://github.com/Santulator/Santulator/releases/latest)\n[![Twitter Follow](https://img.shields.io/twitter/follow/vocabhunterapp.svg?style=social\u0026label=Follow)](https://twitter.com/vocabhunterapp)\n\nSantulator helps you run your Secret Santa draw simply and flexibly.  You can enter the names of the people participating in the draw and the system will randomly choose who will give presents to whom.  If you want to avoid certainly parings, for example to ensure that people don't get their own partners in the draw, you can add exclusions.  When the draw is run, a PDF will be generated for each person telling them who to buy a present for.  If you want to avoid accidentally seeing all of the results, you can add a secret password to the generated PDF files.\n[![Santulator draw selection](/assets/Santulator-Draw-Selection-Cards-1.png)](https://santulator.github.io/)\n[![Santulator in action](/assets/Santulator-Draw-Wizard-2.gif)](https://santulator.github.io/)\n\n# How To Use Santulator\n\nSantulator is available for free from the [download page](https://santulator.github.io/download/) of the project website.  You can find a complete tutorial explaining how to use the system on the [help page](https://santulator.github.io/help/).\n\n# Running The Development Version of Santulator\n\nYou will need JDK 17.  The version used for building Santulator releases is OpenJDK 17 with Hotspot, from [Adoptium](https://adoptium.net).\n\nWith your JDK installed you can then clone this repository and run the following to start Santulator:\n~~~\n./gradlew :gui:run\n~~~\n\n# How To Build Santulator\n\nYou can build the entire system with the following command:\n~~~\n./gradlew clean build\n~~~\n\n# How To Run The GUI Test\n\nBy default the GUI test runs as part of the standard Gradle build, in headless mode.  If you'd like to run the GUI test in a non-headless mode so that you can see what is happening, use the following command:\n~~~\n./gradlew :gui:test --tests io.github.santulator.gui.main.GuiTest --rerun-tasks -PnoHeadless\n~~~\n\n# How to Build The Installable Bundle\n\n[![Installable Java Apps with jpackage](/assets/jpackage-installable-java-apps.png)][Installable Java Apps with jpackage]\n\nIn the article [Installable Java Apps with jpackage] you can read about how installable bundles for Mac, Windows and Linux are created and how you can do this in your own project.  These self-contained installers allow users to setup Santulator on their computer without the need to first install Java.\n\nYou can also find full, step-by-step instructions for creating the Santulator installable bundle in [PACKAGING.md](package/PACKAGING.md).\n\n# Open Source \u0026 Secret Santa with Santulator\n\n[![Open Source \u0026 Secret Santa with Santulator](/assets/Open-Source-And-Secret-Santa-With-Santulator.png)][Open Source \u0026 Secret Santa with Santulator]\n\nOver on the King Tech Blog you can read more about the project in [Open Source \u0026 Secret Santa with Santulator]. The article includes information about how JavaFX CSS is used to give Santulator a festive colour scheme.\n\n[![Before and after colours](/assets/Before-And-After-Colours.png)][Open Source \u0026 Secret Santa with Santulator]\n\n[Installable Java Apps with jpackage]:https://vocabhunter.github.io/2021/07/10/installable-java-apps-with-jpackage.html\n[Open Source \u0026 Secret Santa with Santulator]:https://medium.com/techking/open-source-secret-santa-with-santulator-9101972359fc\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsantulator%2Fsantulator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsantulator%2Fsantulator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsantulator%2Fsantulator/lists"}