{"id":22226166,"url":"https://github.com/guru-1205/autodocmailer","last_synced_at":"2026-04-27T21:32:18.885Z","repository":{"id":218185478,"uuid":"733831858","full_name":"Guru-1205/AutoDocMailer","owner":"Guru-1205","description":"AutoDocMailer: Automatically generates and emails customized documents using templates and user inputs.","archived":false,"fork":false,"pushed_at":"2024-06-15T19:26:24.000Z","size":325,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T08:35:37.701Z","etag":null,"topics":["document-generation","email-automation","flask","productivity-tool","python","template-management"],"latest_commit_sha":null,"homepage":"","language":"HTML","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/Guru-1205.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}},"created_at":"2023-12-20T08:23:49.000Z","updated_at":"2024-06-17T06:00:11.000Z","dependencies_parsed_at":"2024-06-15T20:23:22.897Z","dependency_job_id":"3a6668e7-7a99-4225-a02e-44b9449a6ebe","html_url":"https://github.com/Guru-1205/AutoDocMailer","commit_stats":null,"previous_names":["guru-1205/letter","guru-1205/templatemailer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Guru-1205/AutoDocMailer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Guru-1205%2FAutoDocMailer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Guru-1205%2FAutoDocMailer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Guru-1205%2FAutoDocMailer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Guru-1205%2FAutoDocMailer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Guru-1205","download_url":"https://codeload.github.com/Guru-1205/AutoDocMailer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Guru-1205%2FAutoDocMailer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32356598,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-27T20:07:02.737Z","status":"ssl_error","status_checked_at":"2026-04-27T20:07:00.910Z","response_time":128,"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":["document-generation","email-automation","flask","productivity-tool","python","template-management"],"created_at":"2024-12-03T00:23:46.448Z","updated_at":"2026-04-27T21:32:18.870Z","avatar_url":"https://github.com/Guru-1205.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"### Exciting Update! 🌟\n\nHey there, everyone! It’s me, **Gc**.\n\nI’m excited to share that I’ve created **AutoDocMailer**, a super-efficient web app using the Flask framework. It automates the creation and emailing of personalized letters by simply using a template and the details you provide. \n\nYou no longer need to manually edit and send out templates each time you have a new letter to send. Just fill out a form with the necessary details and edit the template.docx with your required docx, and **AutoDocMailer** will handle the rest!\n\nHere’s the best part: If you ever run into any bugs or issues, don’t hesitate to reach out. I’m here to help you resolve them. Go ahead and enjoy the convenience of automated document handling!\n\n---\n\n### How It Works\n\n#### 1. **User Visits the Website 🖥️**\n\n- **Home Page**: Users land on the home page of the app.\n- **Form**: They see a simple form to fill in details like name, dates, place, etc.\n\n#### 2. **User Fills Out the Form 📝**\n\n- **Input Fields**: Users provide the required information, such as:\n  - **Activity Name** (e.g., \"Annual Meeting\")\n  - **From Date** (e.g., \"2024-06-15\")\n  - **Year** (e.g., \"2024\")\n  - **Date** (e.g., \"2024-06-16\")\n  - **Place** (e.g., \"Conference Room\")\n  - **Duration** (e.g., \"2 hours\")\n  - **Day** (e.g., \"Monday\")\n  - **Receiver's Email** (e.g., \"example@domain.com\")\n\n#### 3. **Processing the Information 🛠️**\n\n- **Submit**: User submits the form by clicking the submit button.\n- **Data Handling**: The app collects the information and formats the dates.\n\n#### 4. **Generating the Document 📄**\n\n- **Template Loading**: The app loads a pre-defined Word document template.\n- **Placeholder Replacement**: It replaces placeholders like `{{activityName}}` with the actual user-provided values.\n- **Customization**: The app adjusts font sizes and other formatting aspects.\n\n#### 5. **Emailing the Document 📧**\n\n- **In-Memory Stream**: The customized document is saved in memory (no need to download it manually).\n- **Email Setup**: The app sets up an email with the document as an attachment.\n- **Send Email**: The app sends the email to the recipient's address.\n\n#### 6. **User Gets Confirmation ✅**\n\n- **Success Message**: The user sees a message indicating that the email has been sent successfully.\n\n---\n\n### Setting Up Your App Password from Google 🔒\n\nFor **AutoDocMailer** to send emails on your behalf using your Google account, you need to generate an app password. Here’s how:\n\n1. **Go to Google Account**:\n   - Visit [Google Account](https://myaccount.google.com/).\n\n2. **Sign In**:\n   - Sign in with your Google credentials if you're not already logged in.\n\n3. **Navigate to Security Settings**:\n   - In the left sidebar, click on **Security**.\n\n4. **Turn On 2-Step Verification** (if not already enabled):\n   - Under the **\"Signing in to Google\"** section, click **2-Step Verification** and follow the prompts to enable it.\n\n5. **Generate App Password**:\n   - Return to the **Security** page.\n   - Scroll down to **\"App passwords\"** and click it.\n   - Sign in again if prompted.\n   - In the **Select app** dropdown, choose **Mail**.\n   - In the **Select device** dropdown, choose **Other (Custom name)**.\n   - Enter a name (e.g., \"AutoDocMailer\") and click **Generate**.\n\n6. **Copy the App Password**:\n   - A 16-character password will be shown. Copy it.\n\n7. **Use the App Password**:\n   - In your `.env` file for **AutoDocMailer**, set the `SENDER_MAIL_APP_PASSWORD` to this app password.\n  \nRefer this video for furthur doubts - https://youtu.be/nOkpTwPvDTg?si=lNL0noZNaSgI7CHG\n\n\n---\n\n\n### Key Features\n\n- **Automation**: Eliminates the need to manually edit and email the template every time.\n- **Personalization**: Ensures each document is tailored to the specific details provided by the user.\n- **Ease of Use**: Simple form submission and automatic processing make it user-friendly.\n\n---\n\n### Step-by-Step Process\n\n1. **Go to AutoDocMailer**: Visit the app’s website.\n2. **Fill Out the Form**: Enter the details you want in the letter.\n3. **Submit**: Click the submit button to process your information.\n4. **Receive Confirmation**: The app customizes the template and emails it to the recipient.\n5. **Done!** 🎉: You’ve successfully sent a personalized letter!\n\n---\n\n### Technical Overview for Curious Minds 👨‍💻👩‍💻\n\n- **Built with Flask**: A lightweight web framework for handling the server-side logic.\n- **Uses Flask-Mail**: For sending emails via an SMTP server.\n- **Template Management**: Uses a Word document template that’s loaded and customized on the fly.\n- **Date Formatting**: Automatically formats dates to ensure consistency.\n- **Security**: Uses environment variables to handle email credentials securely.\n\n---\n\n\nEnjoy the ease and efficiency of **AutoDocMailer**! 🚀📬\n\nHappy coding and have a blast! 🎉\n\nCheers, **Gc**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguru-1205%2Fautodocmailer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fguru-1205%2Fautodocmailer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fguru-1205%2Fautodocmailer/lists"}