{"id":50546287,"url":"https://github.com/jackwayne234/gmail-email-report-notifier-linux","last_synced_at":"2026-06-03T23:03:18.176Z","repository":{"id":360601528,"uuid":"1250895658","full_name":"jackwayne234/gmail-email-report-notifier-linux","owner":"jackwayne234","description":"Read-only Gmail inbox report and desktop notification helper for Linux users with Himalaya configured.","archived":false,"fork":false,"pushed_at":"2026-05-27T04:09:39.000Z","size":9,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-27T06:12:07.570Z","etag":null,"topics":["desktop-notifications","email","gmail","himalaya","imap","linux","python"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jackwayne234.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-27T04:09:30.000Z","updated_at":"2026-05-27T04:09:42.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jackwayne234/gmail-email-report-notifier-linux","commit_stats":null,"previous_names":["jackwayne234/gmail-email-report-notifier-linux"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jackwayne234/gmail-email-report-notifier-linux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackwayne234%2Fgmail-email-report-notifier-linux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackwayne234%2Fgmail-email-report-notifier-linux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackwayne234%2Fgmail-email-report-notifier-linux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackwayne234%2Fgmail-email-report-notifier-linux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jackwayne234","download_url":"https://codeload.github.com/jackwayne234/gmail-email-report-notifier-linux/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackwayne234%2Fgmail-email-report-notifier-linux/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33883117,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-03T02:00:06.370Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["desktop-notifications","email","gmail","himalaya","imap","linux","python"],"created_at":"2026-06-03T23:03:18.100Z","updated_at":"2026-06-03T23:03:18.171Z","avatar_url":"https://github.com/jackwayne234.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gmail Email Report / Notifier for Linux\n\nRead-only Gmail inbox report and desktop notification helper for Linux users who already use the Himalaya email CLI.\n\n## Public-readiness note\n\nThis public version is sanitized: it does **not** include a personal Gmail address, password, OAuth token, or private email data.\n\n## What it does\n\n- Uses the local `himalaya` email CLI to read Gmail/IMAP message headers\n- Creates a human-readable inbox report\n- Highlights likely important messages using local keyword rules\n- Can run a simple desktop notifier for new inbox messages\n- Does not open, move, delete, or mark emails read\n\n## What it does not do\n\n- Does not include Gmail credentials\n- Does not configure OAuth for you\n- Does not upload email data anywhere\n- Does not send email\n- Does not read full message bodies; it uses message headers from Himalaya output\n\n## Requirements\n\n- Linux desktop with `notify-send`\n- Python 3\n- Himalaya CLI installed and configured for your Gmail/IMAP account\n\n## Configure\n\nSet these environment variables or edit the script constants:\n\n```bash\nexport GMAIL_REPORT_ACCOUNT=\"gmail\"\nexport GMAIL_REPORT_EMAIL=\"you@example.com\"\nexport GMAIL_REPORT_FOLDER=\"INBOX\"\n```\n\nThe scripts default to:\n\n- account: `gmail`\n- email label: `(configured Gmail account)`\n- folder: `INBOX`\n\n## Run report\n\n```bash\npython3 gmail-email-report.py\n```\n\nDefault output:\n\n```text\n~/Desktop/Gmail_Email_Report.txt\n```\n\n## Run notifier once\n\n```bash\npython3 gmail-desktop-notifier.py --check-now\n```\n\n## Run notifier as daemon\n\n```bash\npython3 gmail-desktop-notifier.py --daemon\n```\n\n## Privacy / safety\n\nThis is a local read-only helper. It depends on your existing Himalaya configuration. Do not commit your Himalaya config, OAuth tokens, app passwords, or generated email reports.\n\n## First-time prerequisite setup\n\nRun:\n\n```bash\n./Setup_Prerequisites.sh\n```\n\nThe setup script checks for Python, desktop notifications, and whether Himalaya appears to be installed. It can try to install common system packages, but it does not configure Gmail credentials for you.\n\nYou must install/configure Himalaya for your own Gmail/IMAP account before this tool can read inbox headers.\n\n## Support development\n\nThese apps are free/pay-what-you-want so people can actually use them.\n\nIf this app helped you, a small tip helps me keep building and improving them.\n\n- Cash App: $jaydubgtfo\n\n## License\n\nNo open-source license has been selected yet. Unless a license is added later, all rights are reserved by the author.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjackwayne234%2Fgmail-email-report-notifier-linux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjackwayne234%2Fgmail-email-report-notifier-linux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjackwayne234%2Fgmail-email-report-notifier-linux/lists"}