zerodha-summary 0.2.0

Screenshot Zerodha portfolio pages, compile to PDF, and email it

Zerodha Portfolio Summary Mailer

Logs into Zerodha, screenshots your portfolio pages, compiles them into a PDF, and emails it to you.

Setup

1. Install

pip install .
playwright install chromium

2. Configure

cp config.ini.template config.ini

Edit config.ini with your email addresses and Gmail App Password. See the template for all options.

config.ini is gitignored — never commit it.

3. Run

zerodha-summary

The browser opens for you to log in. Once you press Enter, it takes screenshots, compiles the PDF, and asks for confirmation before sending the email.

---

Gmail App Password

Gmail requires an App Password (not your regular password):

1. Go to Google Account → Security → 2-Step Verification → App passwords
2. Create one (e.g. "Zerodha Mailer") and paste it into config.ini under password

If password is omitted from config.ini, the program will prompt for it securely at runtime.

---

Advanced

CLI overrides

Any config.ini setting can be passed as a CLI argument:

zerodha-summary --receiver-email [e-mail] --subject "March Summary" --output-pdf march.pdf
zerodha-summary --config my_other_config.ini

Pages

• Add one URL per line under pages = in config.ini
• The Tradebook page (/reports/tradebook) is handled specially — the program automatically iterates all segments (Equity, F&O, Currency, etc.) over the last 3 months and captures every pagination page
• All other pages are screenshotted as-is

---

Troubleshooting

Problem	Fix
Missing dependency error	Run pip install . and playwright install chromium
Gmail login fails	Use an App Password, not your regular Gmail password
PDF not opening	Install a PDF viewer (sudo apt install evince on Ubuntu)