MAHMOUD ABDELNABY
Automation · CLI SCRIPT · 2

Bilingual Email Subject Line & Inbox Snippet Radar

Preview mobile inbox truncation, test preheader alignment, and catch Arabic spam trigger words before sending your newsletter.

Problem it addresses

Create an open-source bilingual subject line and preheader inspection tool: 1) Python CLI (subject_linter.py) auditing character length (desktop vs mobile truncation limits), preheader padding characters (‌ ), and bidirectional Unicode mark isolation, 2) Curated list of 150+ Arabic spam trigger words, 3) Interactive HTML mobile inbox preview card.

Who it is for

BOTH operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

What is inside

Key files listed in the README repository architecture:

  • data/arabic_spam_triggers.json
  • data/spam_triggers_ar_en.json
  • examples/sample_subject_lines.csv
  • examples/sample_subject_tests.json
  • LICENSE
  • README.md
  • reports/inbox_preview_simulator.html
  • src/subject_line_analyzer.py
  • src/subject_linter.py
  • tests/test_analyzer.py
  • tests/test_linter.py
  • tests/test_subject.py

How to evaluate and use it

  1. Read the README first and confirm that the documented problem matches your use case.
  2. Inspect the listed files to find the data, tools, templates, and tests relevant to your task.
  3. Follow the repository’s Quick Start and check prerequisites before running commands.
  4. Compare outputs with documented examples and review limitations before using them in a decision or client workflow.

Quick Start from the README: python -m unittest discover -s tests · python src/subject_line_analyzer.py --help

Scope and limitations

  • MIME Encoded-Word Headers: Ensures Arabic subject lines are properly encoded in UTF-8 base64 ('=?UTF-8?B?...?=' per RFC 2047) to avoid character garbling.
  • Mobile Inbox Cutoff Limits: Previews how subject lines and preheaders appear across mobile screens, capping visible characters at 35 to 45 units.
  • Directional Neutrality: Enforces Unicode directional marks to prevent bracket displacement when English brand names appear in Arabic subject lines.

This page summarizes the available documentation; it does not establish performance or business results. Verify data and prerequisites before use.

Related repositories