Skip to content

Michaelgeo1004/Job-Mail-Campaign

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

18 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Job Mail Campaign Platinum πŸš€

A premium, bulk email campaign tool for job hunters. Send your resume, customize every message, and manage your SMTP connections all from a beautiful, glassmorphic dashboard.

✨ Features

  • πŸ’Ž Platinum UI: A modern, glassmorphic dark-theme dashboard.
  • πŸ› οΈ Flexible Authentication: Switch between your .env defaults or custom SMTP credentials on-the-fly.
  • 🧩 Custom Variables: Define your own placeholders ({{GREETING}}, {{LINKEDIN}}, etc.) and populate them across all emails.
  • πŸ“… Smart Scheduler: Schedule your campaigns to launch at the perfect time.
  • πŸ”Ž Dynamic Preview: Live preview how your email looks for different recipients before pushing the button.
  • πŸ“‚ Structural Alignment: Clean, organized folder structure for better maintainability.
  • πŸ“· OCR Support: Upload images of address lists, and they'll be automatically parsed using Tesseract.js.
  • πŸ“„ Live PDF Preview: Instantly view your uploaded resume in the dashboard for visual verification.
  • πŸ—‚οΈ Tabbed Workflow: Separate "Campaign Setup" and "Message Content" tabs for a more focused, scalable experience.
  • πŸ“Ž Optional Attachments: Send emails with or without a resume attachment.
  • πŸ”” Platinum Toasts: Modern, glassmorphic notifications for success, error, and info updates.

πŸ“ Project Structure

/
  src/
    core/             # Shared utilities (CSV, templates, sleep)
    services/         # Business logic (Mailer & Scheduler)
    controllers/      # Express request handlers
    routes/           # API routing
    middleware/       # Multer & Upload handling
    app.js            # Express initialization
    server.js         # Web server entry
    cli.js            # Command-line entry
  public/             # Frontend assets (Glassmorphic UI)
  data/
    defaults/         # Templates & default recipient lists
    scheduled-jobs/   # Persistent job storage
  uploads/            # Temporary storage for uploads
  attachments/        # Default resume location
  .env                # Your configuration

πŸš€ Getting Started

1. Installation

npm install

2. Configuration (.env)

Fill your credentials and default paths in .env:

  • SMTP_USER & SMTP_PASS (Use Gmail App Password)
  • FROM_EMAIL (Your email)
  • EMAIL_SUBJECT (Default subject)

3. Launching the Dashboard

Start the premium web interface:

npm run web

Visit: http://localhost:3000

4. CLI Mode

Still want to use the terminal? We've got you covered:

# Test run (no emails sent)
npm run send:test

# Live campaign
npm run send

πŸ“ Customization Tips

  • Placeholders: Standard ones are {{HR_NAME}} and {{COMPANY}}. Use the UI to add as many as you want!
  • Throttling: The default delay is 2500ms. Adjust THROTTLE_MS in .env to stay safe with your provider.
  • OCR: If you have a screenshot of recruiters' emails, just drag and drop the image into the recipients box.

Stay persistent, stay professional. Good luck with your job hunt!

About

πŸš€ JobMail Platinum – A high-performance, automated bulk email tool for Job Applications. Personalize entire campaigns with a single click using Image-to-Email OCR, dynamic variable injection, and live PDF preview.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors