Main Features

Domains

Organize your tags into separate domains. Set up export rules, format and save folder

Tags

Store emails inside custom tags within each domain

Imports

Import emails to each tag individually or use bulk import. View detailed import history to always know which emails you imported

Exports

Create customizable exports by choosing exactly how many emails from any tag you want. View detailed exports history to always know when, how many, and which emails you used

Quick Start

0

Download and Launch the App

Download the app from here or compile it yourself from the source code. Once downloaded, extract the .zip file.

First-Time Setup: To launch the app for the first time, please follow these steps (you won't need to do this for future launches):

  • Right-click (or two-finger tap) the app icon and select Show Package Contents.
  • Navigate to Contents > MacOS. You will see a file named Emails-Helper.
  • Open the Terminal (Press Command + Space and type "Terminal").
  • In the Terminal, type chmod +x (make sure to include a space at the end). Do NOT press enter yet.
  • Drag the Emails-Helper file from the Finder window into the Terminal. This will automatically paste the file path.
  • The final command in your Terminal should look similar to this:
    chmod +x /Users/USERNAME/Downloads/Emails-Helper.app/Contents/MacOS/Emails-Helper
    Press Enter. No text should appear in response; this indicates the command was successful.

Bypassing macOS Security:

  • Go back to the main app icon and try to launch it normally.
  • A warning will appear stating the app "cannot be opened because the developer cannot be verified." Click Cancel.
  • Open System Settings and navigate to Privacy & Security.
  • Scroll to the bottom. Under the "Security" section, you will see a message regarding "Emails Helper." Click Open Anyway.
  • Enter your Mac password or use Touch ID to confirm.

The app will now launch and function normally for all future use!

1

Create Domain

Start by creating a domain to manage your tags.

Click the plus button in the top left corner. Give it a name (such as your broadcast name) and abbreviation.

Choose the export type and folder where exported files will be saved.

Set up limits for email overuse if needed.

See Domain Settings guide for detailed explanations of each setting.

2

Create Tags

Inside your domain, press the button with two people in the top right and choose 'Add new tag'.

Give your new tag a name. You can create as many tags as you want.

3

Import Emails

You can import emails two ways:

Option 1: Press the tag icon on any tag and choose 'Import'.

  • Give your import a name
  • Import emails from files or from text (don't forget to add the Email column at the top of the text field)
  • Check if the email count shows the expected number
  • Press Finish Import and wait

Option 2: Press the button with two people and choose Bulk Import.

  • Upload emails from files to different tags at once
4

Create Export

Press the Create Export button in the top right corner.

Step-by-step:

  • Give your export file a name
  • Use merge tags in file and folder names by pressing the merge tags button and choosing the tags you want
  • Paste it into the file name field and see a preview below (save path preview)
  • Choose if you want all tags combined in one file or each tag in separate files
  • Type the amount of each tag you want in your export (leave tags you don't need empty)
  • Check if the total email amount is as expected
  • Press Finish Export and wait

Your export is finished! The file will be in the path you specified while creating the domain.

You can see this export in the Exports History tab near the Create Export button.

Congratulations, you just created your first export!

Other Features

1. Limit Emails Overuse

Prevent email overuse by limiting how often emails are exported. Set limits within a domain or globally across all domains.

  • Domain-level limits: "Don't use emails that were exported in the last X days within this domain"
  • Global limits: "Don't use emails that were exported in the last X days across any domain"

2. Export in Needed Format

Export your email lists in multiple formats to match your esp:

  • Regular - Standard CSV file with Email header
  • Exact Target - CSV File with Email Address and Subscriber Key headers. Ready to be imported into target
  • Blueshift - CSV File with email customer_id and domain headers. Ready to be imported into blueshift

3. Download and Exclude Emails Easily

Download emails, validate them using third-party services, and easily exclude all invalid emails.

Manage downloading and exclusions at different levels:

  • Global exclusions: Exclude emails across all tags inside domain
  • Tag-level exclusions: Exclude emails within specific tag individually

4. Merge Tags in Export Names

Use merge tags for automatic file name generation. Makes organizing exports faster and more consistent.

Example: %d-abrr% - %day%%month% - %t-all% automatically becomes
IMH - 0309 - yahoo_5k__other_20k__comcast_600 without ever changing the name each day or upon changing tag amounts.

Detailed Interface Guide

Dashboard & Domains List

1
Domain List Choose your working domain here. The search bar at the top supports searching by full name or abbreviation.
2
Create New Domain Button Creates a new domain. After creation, automatically opens the domain settings tab for further configuration.
3
Current Tab Name Shows the name of the current tab for easier navigation.
4
Tag Menu Opens a tag menu with available actions for the tag.
5
Refresh Emails Count Button to manually trigger an email count refresh. The available email count tries to be as up-to-date as possible, but if you need the freshest results, you can press this button.
6
Create Export Button Opens the export tab.
7
Exports History Button Opens the exports history tab.
8
Domain Settings Button Opens the domain settings tab.
9
Bulk Actions & Tag Creation Menu Shows available bulk options for emails. The button to create a new tag is also located here.

Domain Settings

1
Delete Domain Button Removes the domain and all its data. You will be asked to confirm this action before deletion.
2
Domain Name The name of the domain. Important: Use the real domain name (same as in broadcast), because this value is used in the Blueshift export type for the domain column.
3
Domain Abbreviation Short abbreviation for this domain. Also used in Blueshift and Exact Target export types.
4
Export Format Choose which format to export emails in:
  • Regular - Standard CSV file with Email header
  • Exact Target - CSV file with Email Address and Subscriber Key headers, ready to be imported into Salesforce Marketing Cloud
  • Blueshift - CSV file with email, customer_id, and domain headers, ready to be imported into Blueshift
5
Export Folder All exports and downloads files from this domain will be saved to this location.
6
Domain-Level Usage Limit Filter that regulates how often an email can be used within this domain. For example, if set to 20 days: if an email was used in this domain today, it won't be counted as active for the next 20 days.
7
Global Usage Limit Filter that regulates how often an email can be used across all domains. For example, with a value of 5 days: if an email was used in any domain today, it won't be counted as active for this domain for the next 5 days.
8
Save Changes Button Saves all changes that were made to domain settings. Make sure to click this after modifying any settings.
9
Back Button Returns you to the main tab without saving changes (unless you already clicked Save).

Tag Block

1
Tag Name
2
Available Emails Count This number shows the available email count in this tag. It depends on how many emails were imported and also includes the "Limit Emails Overuse" setting for this domain. For color indication to work, specify the ideal amount for this tag in domain edit mode. Color indication is as follows: Red - less than 20% of the ideal amount; Orange - from 20 to 40%; Blue - from 40% to 100% of the ideal amount; Green - more than 100%.
3
Open tag menu
4
Tag Import Tab Opens the tag import tab.
5
Tag Import History Opens the tag history tab.
6
Tag Exclude Tab Opens the tag exclude tab.
7
Tag Download Tab Opens the tag download tab.
8
Change Domain Mode to Edit Changes the domain block mode to edit. Use this button if you want to change the tag name or its ideal amount.
9
Delete Tag Button Marks the tag as deleted. You won't be able to export or download emails from this tag, but the email and export history for this tag won't be deleted. Thus, the "Limit Emails Overuse" feature will still take into account emails used even in deleted tags. You will be asked to confirm tag deletion.
10
Edit Tag Name Text field for editing the tag name.
11
Edit Ideal Amount Enter the ideal email amount for this tag. This number is used solely for color visualization purposes.
12
Save Button Save button to commit changes and switch back to visualization mode.

Bulk Actions Menu

1
Open Bulk Menu Expands the Bulk Actions and Tag Creation menu.
2
Open Bulk Import Tab Opens the Bulk Import tab to import emails to multiple tags at once.
3
Bulk Exclude Tab Opens the Exclude tab with all tags pre-selected.
4
Bulk Download Tab Opens the Download tab with all tags pre-selected.
5
Add Tag Button Creates a new tag in the current domain and puts it into edit mode.

Standard Emails Importer

1
Select Files Button Click this button to open a file picker and choose email CSV files. Only emails from columns whose names contain "Email" (case-insensitive) will be processed.
2
Remove File Button Removes a specific file from the chosen list.
3
Text Emails Input Field A text field where you can paste emails directly. It should contain a column name with "email" (case-insensitive) at the top.
4
Files Emails Count Shows the number of successfully processed emails from uploaded files. It automatically removes duplicates and reads emails only from columns containing "email". If it says "loading", processing is still underway.
5
Text Emails Count Shows the number of successfully processed emails from provided text. It automatically removes duplicates and reads emails only from columns containing "email". If it says "loading", processing is still underway.
6
Total Emails Count Shows the total number of successfully processed emails, with duplicates removed. If it says "loading", processing is not yet complete for either the text or file inputs.

Import Tab

1
Import Name Text Field Enter the Import Name here. This name will be shown in the import history, so use descriptive and useful names.
2
Tag Selection Menu Choose the tag to which you want to import emails. Opening this from a specific tag's action menu will automatically pre-select that tag.
4
Finish Button Click this to finalize the import. An import can't be finished if no name is provided or if the app is still processing emails from files/text input. Once the import is finished, the emails will be added to the chosen tag with an 'Active' status.
5
Go Back Button Returns you to the previous view without saving the current import.

Bulk Import Tab

1
Shared Import Name Enter the Import Name here. This name will be shown in the import history for each tag, so use a descriptive and useful name.
2
Select Files Button Click this button to open a file picker and choose email CSV files. Only emails from columns whose names contain "Email" (case-insensitive) will be processed.
3
File Name Displays the name of the file currently selected for configuration.
4
Emails Count Shows how many emails were found in the file. It automatically removes duplicates and reads emails only from columns containing "email".
5
Tag Selection Menu Select the tag to which you want to add the emails from this file.
6
Remove File Button Removes a specific file from the chosen list.
7
Finish Button Click this to finalize the import. An import can't be finished if no name is provided or if the app is still processing emails from files. Once the import is finished, the emails from the files will be added to the accordingly chosen tags with an 'Active' status.
8
Go Back Button Returns you to the previous view without saving the current import.

Import History

1
Tag Selector Choose the tag whose history you want to view.
2
Import Name Displays the name of the import.
3
Emails Amount Shows how many emails were actually imported.
4
Date Shows the date and time when the import occurred.
5
Load More Button Loads 10 more records.
6
Record Statistics Shows how many records are currently displayed versus the total number available.
7
Go Back Button Returns you to the previous view.

Export Tab

1
File Name Text Field A text field for naming your exported file or folder. Supports merge tags for automatic name generation.
2
Merge Tags Menu Displays available merge tags with the ability to copy them. Supported tags:
%d-name% (Domain name),
%d-abrr% (Domain abbreviation),
%day% (Current day),
%month% (Current month),
%t-all% (Info about all tags in export),
%t-name% (Current tag name - separate files mode only),
%t-amount% (Requested emails amount - separate files mode only).
3
Save Mode Switch Controls how emails from each tag are saved. If unchecked (default), all requested emails from specified tags are mixed into one file. If checked, emails from each tag are saved in separate files.
4
Save Path Preview Shows the path where exported files will be saved, including processed merge tags.
5
Tag Name The name of the tag whose email count you are specifying.
6
Amount Field Specify how many emails from this tag you want to include in your export. You can enter any amount regardless of total availability. Leave empty if you don't need emails from this tag.
7
Available Emails Count Shows the number of available emails ready for export. This depends on imported counts and "Limit Emails Overuse" settings.
8
Repeat Export Amount Fields Allows you to specify how many times you want this export to run, so you don't need to manually press "Finish Export" button over and over.
9
Finish Export Button After pressing, the requested amount of emails from specified tags will be marked as 'Inactive' and added to the export file. Their 'last used' field will be updated to the current time.
10
Clear Request Button Button that clears all specified amounts for all tags.
11
Go Back Button Returns you to the previous view.

Exports History Tab

1
Export Name The name with which the file (or folder and file) was exported. Click the name to open a detailed view of the export.
2
Total Emails Amount Total number of emails that were actually exported.
3
Export Date Shows the date and time when the export was completed.
4
Requested Emails Amount The amount of emails requested for this tag.
5
Exported Amount The number of emails that were actually exported. Displayed in green if it matches the requested amount, and red if it is less.
6
Load More Button Loads 10 more records.
7
Record Statistics Shows how many records are currently displayed versus the total number available.
8
Tag Name Displays the name of the tag associated with this export record.
9
Go Back Button Returns you to the previous view.

Download Tab

1
File Name Text Field Specify the name for the file containing your downloaded emails.
2
Save Path Preview Shows the directory where your file will be saved.
3
Scope Selector Choose the scope for your download. You can either select a specific tag or "All Tags" to download from the entire set.
4
Email Activity Status Select whether to download "Active" or "Inactive" emails. Active emails haven't been exported yet; Inactive emails have been used in at least one export. Note: The "Limit Emails Overuse" setting is not applied here.
5
Fields To Include Picker Select which fields to include in your download:
- Tag Name: The tag the email belongs to.
- Is Active: Usage status (Active/Inactive).
- Import Name: Name of the last import source.
- Date Imported: The date the email was added/updated.
- Export ID: ID of the last export it was used in.
- Last Used: Timestamp of the last export.
6
Finish Download Pressing this will save the specified emails with your selected fields to a file. Important: These emails will NOT be marked as used (their status remains unchanged).
7
Go Back Button Returns you to the previous view.

Exclude Tab

1
Scope Selector Choose the scope from which you want to exclude emails. You can either select a specific tag or "All Tags" to exclude emails across the entire set.
2
Standard Emails Importer Specify the list of emails you wish to exclude using this field.
3
Finish Exclude Button After clicking this button, the emails provided in the importer will be marked as inactive in either the specified tag or across all tags. They will not be included in any future exports unless they are imported again.
4
Go Back Button Returns you to the previous view.