{"id":37064466,"url":"https://github.com/soar/imapmon","last_synced_at":"2026-01-14T07:32:00.829Z","repository":{"id":39580321,"uuid":"264319002","full_name":"soar/imapmon","owner":"soar","description":"Read your emails in Telegram","archived":false,"fork":false,"pushed_at":"2023-01-31T07:06:12.000Z","size":247,"stargazers_count":1,"open_issues_count":5,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-09-28T06:04:04.704Z","etag":null,"topics":["automation","email","imap","imap-client","telegram","telegram-bot"],"latest_commit_sha":null,"homepage":"https://soar.name","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/soar.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}},"created_at":"2020-05-15T23:18:29.000Z","updated_at":"2023-04-10T04:09:07.000Z","dependencies_parsed_at":"2023-02-16T17:00:49.853Z","dependency_job_id":null,"html_url":"https://github.com/soar/imapmon","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/soar/imapmon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soar%2Fimapmon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soar%2Fimapmon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soar%2Fimapmon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soar%2Fimapmon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/soar","download_url":"https://codeload.github.com/soar/imapmon/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soar%2Fimapmon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28413381,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T05:26:33.345Z","status":"ssl_error","status_checked_at":"2026-01-14T05:21:57.251Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["automation","email","imap","imap-client","telegram","telegram-bot"],"created_at":"2026-01-14T07:32:00.320Z","updated_at":"2026-01-14T07:32:00.803Z","avatar_url":"https://github.com/soar.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IMAP Mon\n\n![PyPI - License](https://img.shields.io/pypi/l/imapmon)\n![🐍 CI](https://github.com/soar/imapmon/workflows/%F0%9F%90%8D%20CI/badge.svg?branch=master)\n![PyPI - Implementation](https://img.shields.io/pypi/implementation/imapmon)\n![PyPI - Python Version](https://img.shields.io/pypi/pyversions/imapmon)\n![PyPI - Wheel](https://img.shields.io/pypi/wheel/imapmon)\n![GitHub last commit](https://img.shields.io/github/last-commit/soar/imapmon)\n\nTool for monitoring IMAP mailboxes and retransmitting received emails via alternative channels\n\n## Quick start\n\n1. Create a file `docker-compose.override.yml` or update `docker-compose.yml` with environment variables defined below.\n2. Start the app with:\n    ```shell\n    docker-compose up\n    ```\n\n## Settings\n\nSome options can be set via an environment variable (real or [dotenv](https://github.com/theskumar/python-dotenv)) or a command line flag.\n\n| Environment variable name | Command line flag | Required | Description |\n| --- | --- | --- | --- |\n| `IMAP_HOSTNAME` | `--hostname`/`-h` | ☑️ | IMAP server hostname |\n| `IMAP_USERNAME` | `--username`/`-u` | ☑️ | IMAP username |\n| `IMAP_PASSWORD` | `--password`/`-p` | ☑️ | IMAP password/key/token |\n| `CHANNELS` | `--channel`/`-c` | ☑️ | Channel to retransmit messages |\n| `TELEGRAM_BOT_TOKEN` | `--telegram-bot-token` | ☑️/✖️ | Telegram Bot Token |\n| `TELEGRAM_CHAT_ID` | `--telegram-chat-id` | ☑️/✖️ | Telegram Chat ID (channel ID, group ID or @username) |\n| `SENTRY_DSN` | `--sentry-dsn` | ✖️ | Sentry DSN |\n| `LOG_LEVEL` | `--log-level`/`-l` | ✖️ | Log level for console messages |\n\n## Examples\n\n0. Get help:\n    ```bash\n    imapmon --help\n    ```\n1. Passing parameters via a command-line:\n    ```bash\n    imapmon --hostname imap.example.com -u user@example.com -p qwerty123 -c telegram --telegram-bot-token \"1234567890:EtneWwZtnEibpH6WZVsnZimbPXZLRurw\" --telegram-chat-id \"12345678\"\n    ```\n2. Passing parameters via environment variables:\n    ```bash\n    export IMAP_HOSTNAME=imap.example.com\n    export IMAP_USERNAME=user@example.com\n    export IMAP_PASSWORD=qwerty123\n    CHANNELS=telegram TELEGRAM_BOT_TOKEN=xxx TELEGRAM_CHAT_ID=123 imapmon\n    ```\n3. Run using a pre-built Docker image:\n    ```bash\n    docker run --rm -it \\\n        docker.pkg.github.com/soar/imapmon/imapmon:latest \\\n        --hostname imap.example.com \\\n        -u user@example.com \\\n        -p qwerty123 \\\n        ...\n    ```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoar%2Fimapmon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoar%2Fimapmon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoar%2Fimapmon/lists"}