1. Where plugins live

      • Open your Px Mailer data folder
      • Go to the pxmailer folder
      • Open (or create) the plugins folder
      • Full path looks like: Px Mailer/pxmailer/plugins/
      • Put your plugin file here as a .py module (example: sender_name.py)

2. Enable a plugin

      • GUI way: open Settings → Plugins & Variables
      • Add one line per plugin, for example: [USE sender_name]
      • You can also type just sender_name — the GUI can wrap it as [USE ...]
      • Click Save — Px Mailer reloads plugins
      • Manual way: edit pxmailer/config.ini and add [USE ModuleName] on its own line

3. Built-in example plugins

      • sender_name — generate sender-style names for templates
      • TemplatePack / TemplateGenerator — rotate subjects and HTML content packs
      • email_loader — cycle emails from a side file
      • VPNPlugin — VPN rotation helper
      • officePlugin / custom_leads / o365_leads — lead and Microsoft-related helpers

4. Use a plugin inside your message

      • Enable the plugin first with [USE sender_name]
      • In message.txt or sender fields, call it with a sudo expression
      • Example style: NewModule['sender_name'].generate_security_name() inside the sudo braces used by Px Mailer
      • Save message.txt and start a campaign to see the result per lead

5. Mode 7 — Private API (Send_API)

      • Create pxmailer/plugins/Send_API.py
      • Enable it with [USE Send_API]
      • Choose send mode 7 (Private API) in Send Campaign, or set SEND_OPTION to 7
      • Your plugin must be callable and provide a send() method used by the campaign engine
      • Mode 7 usually needs a license above Standard

6. Custom variables with plugins

      • In Plugins & Variables you can also add [VAR name = expression] lines
      • Variables can call plugin helpers once modules are loaded
      • Save settings before testing in a campaign

7. Troubleshooting

      • File name must match the USE name (sender_name.py → [USE sender_name])
      • If load fails, check the activity log / console for Plugin load failed
      • After editing a plugin file, save Settings or restart the campaign so it reloads
      • Mode 7 without Send_API shows a configure [USE Send_API] message

8. Quick checklist

      • Copy plugin .py into pxmailer/plugins/
      • Add [USE ModuleName] in Settings
      • Save Settings
      • Use it in templates and/or choose Mode 7 for Send_API
      • Start a small test campaign first

Get Px Mailer: https://pxtoolx.com