pywisher is a python scripts, which uses gmail to read records and send birthday wishes to all your friends, it's scheduled to run every day at 00:01 IST using github actions.

code Python Gmail Github Action

For using this script, you require:

• Github Account.
• Gmail Account.
• Birthday record (in csv, as given in below image).

one

If you have the requirements completed, follow the steps below:

• Gmail setup

  • Go to this link.

  • On the left hand side, click on security.

    two

  • Under Signing in to Google click App passwords.(It will be visible only, if you have 2FA on)

    three

  • In the next screen, under Select app option select Other, and type your app name as pywisher.

    three three

  • Click done, and in the next screen, you will get your pass code.

• Birthday record setup

  • Using your gmail account, send yourself an email keeping birthday record as attchment, and keep a unique subject. (This unique subject will be used by the code to read the email from the inbox.)

• Github project setup

  • Fork this project.

  • Go to setting of your pywisher repository.

  • On the left hand panel, go to secrets under security section, and click actions.

  • Now, create new secrets by clicking New repository secret. You have to create 4 secrets having same name as given in the actions.yml file.

    EMAIL - your-github-email@email.com
    KEY_ID - your-gmail-for-reading-and-writing@gmail.com
    KEY_SECRET - app password you create in the Gmail ***setup section***.
    SEARCH_KEY - unique subject for the email you sent in ***Birthday record setup***