{"id":20156529,"url":"https://github.com/luccifer/santa","last_synced_at":"2026-05-08T12:42:17.846Z","repository":{"id":75897955,"uuid":"227693635","full_name":"Luccifer/Santa","owner":"Luccifer","description":"Secret Santa","archived":false,"fork":false,"pushed_at":"2019-12-21T16:01:27.000Z","size":199,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-13T12:49:01.515Z","etag":null,"topics":["game","google","mail","python","santa","secret","smtp","yml"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Luccifer.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":"2019-12-12T20:47:52.000Z","updated_at":"2019-12-21T16:01:29.000Z","dependencies_parsed_at":null,"dependency_job_id":"7e2fc995-31a8-49a4-9d41-d155a0604689","html_url":"https://github.com/Luccifer/Santa","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Luccifer%2FSanta","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Luccifer%2FSanta/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Luccifer%2FSanta/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Luccifer%2FSanta/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Luccifer","download_url":"https://codeload.github.com/Luccifer/Santa/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241596276,"owners_count":19988044,"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":["game","google","mail","python","santa","secret","smtp","yml"],"created_at":"2024-11-13T23:39:05.853Z","updated_at":"2026-05-08T12:42:12.815Z","avatar_url":"https://github.com/Luccifer.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Intro\n=====\n\nUSING PYTHON@2!!!!\n\n\n**secret-santa** can help you manage a list of secret santa participants by\nrandomly assigning pairings and sending emails. It can avoid pairing \ncouples to their significant other, and allows custom email messages to be \nspecified.\n\nPre-Install \n------------\n\n1. Install Brew (MacOS ONLY!!):\n\n```\n/usr/bin/ruby -e \"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)\"\n```\n   \n2. Install Python:\n```\nbrew install python2\n``` \n3. Install pip:\n```    \nbrew install pip\n```\n3. Copy this files:\n```    \ngit clone https://github.com/Luccifer/Santa.git\n```\nDependencies\n------------\n\npytz, pyyaml\n\n    pip install pytz\n\n    pip install pyyaml\n\nUsage\n-----\n\nCopy config.yml.template to config.yml and enter in the connection details \nfor your outgoing mail server. Modify the participants and couples lists and \nthe email message if you wish.\n\n    cd Santa-master/\n    cp config.yml.template config.yml\n\nHere is the example configuration unchanged:\n\n    # Required to connect to your outgoing mail server. Example for using gmail:\n    # gmail\n    SMTP_SERVER: smtp.gmail.com\n    SMTP_PORT: 587\n    USERNAME: you@gmail.com\n    PASSWORD: \"you're-password\"\n\n    TIMEZONE: 'US/Pacific'\n\n    PARTICIPANTS:\n      - Chad \u003cchad@somewhere.net\u003e\n      - Jen \u003cjen@gmail.net\u003e\n      - Bill \u003cBill@somedomain.net\u003e\n      - Sharon \u003cSharon@hi.org\u003e\n\n    # Warning -- if you mess this up you could get an infinite loop\n    DONT-PAIR:\n      - Chad, Jen    # Chad and Jen are married\n      - Chad, Bill   # Chad and Bill are best friends\n      - Bill, Sharon\n\n    # From address should be the organizer in case participants have any questions\n    FROM: You \u003cyou@gmail.net\u003e\n\n    # Both SUBJECT and MESSAGE can include variable substitution for the \n    # \"santa\" and \"santee\"\n    SUBJECT: Your secret santa recipient is {santee}\n    MESSAGE: \n      Dear {santa},\n\n      This year you are {santee}'s Secret Santa!. Ho Ho Ho!\n\n      The maximum spending limit is 50.00\n\n\n      This message was automagically generated from a computer. \n\n      Nothing could possibly go wrong...\n\n      http://github.com/underbluewaters/secret-santa\n\nOnce configured, call secret-santa:\n\n    python secret_santa.py\n\nCalling secret-santa without arguments will output a test pairing of \nparticipants.\n\n        Test pairings:\n\n        Chad ---\u003e Bill\n        Jen ---\u003e Sharon\n        Bill ---\u003e Chad\n        Sharon ---\u003e Jen\n\n        To send out emails with new pairings,\n        call with the --send argument:\n\n            $ python secret_santa.py --send\n\nIf ya wanna send emails through Gmail you should make ONE MORE STEP!!! -\u003e https://github.com/Luccifer/Santa/blob/master/Screenshot%202019-12-21%20at%2018.59.05.png\n\nTo send the emails, call using the `--send` argument\n      \n    python secret_santa.py --send\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluccifer%2Fsanta","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fluccifer%2Fsanta","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fluccifer%2Fsanta/lists"}