Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ on:
jobs:
terminal:
name: terminal wizard (no dependencies)
runs-on: ubuntu-latest
# ubuntu-latest no longer offers Python 3.9, the oldest version the wizard supports
runs-on: ubuntu-22.04
steps:
- uses: actions/checkout@v4
- uses: actions/setup-python@v5
Expand Down
38 changes: 22 additions & 16 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
name: Release

# Bump VERSION in maplead/art.py, tag, push:
# git tag v1.3.0 && git push origin v1.3.0
# git tag v1.4.0 && git push origin v1.4.0
#
# A tag push builds the Linux AppImage only. The Windows job runs when the
# workflow is started by hand (workflow_dispatch).
Expand Down Expand Up @@ -67,20 +67,26 @@ jobs:
tag_name: ${{ github.event.inputs.tag || github.ref_name }}
name: ${{ steps.meta.outputs.name }}
body: |
**MAPLEAD 1.3.1 — a social profile no longer counts as a website (Linux)**

A lead whose website is only a social profile or link-in-bio page is now
treated as having no website.

**What's fixed**

- **No website** now includes leads that only list a page such as Instagram,
Facebook or Linktree, and **Has website** leaves them out. Their cards drop
the *Website* chip, and the link button reads *Social*.
- **Only leads with a website**, `--require-website` and the *with website*
count follow the same rule, so a search with that option can return fewer
leads than before.
- **Bulk send** no longer crashes the AppImage on newer distros (e.g. Debian 13).
**MAPLEAD 1.4.0 — turbo mode (Linux)**

Turbo mode searches city by city and business by business, and sends your
WhatsApp message to every lead that passes your filter — with no clicks in
between.

**What's new**

- **Turbo mode** (under *Run search*, or `Ctrl+T`): tick the cities and the
business types, pick the filter (*No website* by default) and start. It
searches the first business type in the first city, messages the matching
leads through the bulk sender, moves to the next business type and, after
the last one, to the next city — until the lists end or you press **Stop**.
- The same safety pauses as **Bulk send**. Leads already messaged are never
messaged twice.
- Finished searches are remembered, so starting turbo mode again continues
where it stopped.
- Every search uses provider credits; the setup window shows how many
searches your lists add up to. Turbo mode does not run with the Demo
provider.

Full notes: https://github.com/${{ github.repository }}/blob/main/CHANGELOG.md ·
guide: https://github.com/${{ github.repository }}/blob/main/docs/GUIDE.md
Expand All @@ -105,7 +111,7 @@ jobs:

windows:
name: build Windows x64
# 1.3.0 ships for Linux only; build Windows by starting the workflow by hand
# 1.4.0 ships for Linux only; build Windows by starting the workflow by hand
if: github.event_name == 'workflow_dispatch'
runs-on: windows-latest
steps:
Expand Down
19 changes: 19 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,25 @@ All notable changes to MAPLEAD. Format follows [Keep a Changelog](https://keepac

## [Unreleased]

## [1.4.0] — 2026-11-12

Linux (AppImage) only — the Windows build and the terminal wizard are unchanged
in this release.

### Added
- **Turbo mode** — a new **Turbo mode** button under *Run search* (`Ctrl+T`)
walks a list of cities and, in each one, a list of business types: it runs the
search, keeps the leads that pass the filter you chose (*No website* by
default), sends them your saved WhatsApp message through the bulk sender, then
moves to the next business type and, after the last one, to the next city —
until the lists end or you press **Stop**.
- Tick the cities and business types (or add your own), pick the filter, the
leads per search and the same safety pauses as **Bulk send**.
- Leads already messaged are never messaged twice, and finished searches are
remembered (`~/.local/share/maplead/turbo-progress.json`), so starting turbo
mode again continues where it stopped.
- Not available with the Demo provider: its phone numbers are made up.

## [1.3.1] — 2026-11-09

### Fixed
Expand Down
27 changes: 22 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,7 @@ lead-scraper API and writes them to CSV / Excel / JSON / TXT / TSV / HTML.
| 🏷️ **68 business types · 35 fields** | you choose exactly which columns come out |
| 💬 **Leads panel + WhatsApp** | cards with one-click links and a first message built from the lead |
| 📨 **Bulk WhatsApp** | sends the message to a whole filter through WhatsApp Web, with safety pauses and a contact history |
| ⚡ **Turbo mode** | searches city by city and business by business, and messages every lead that passes your filter |
| 📄 **6 export formats** | csv · xlsx · json · txt · tsv · html |

<p align="center">
Expand All @@ -33,8 +34,8 @@ lead-scraper API and writes them to CSV / Excel / JSON / TXT / TSV / HTML.
**Linux x86_64, AppImage** — one file, no packages, no root:

```bash
chmod +x MAPLEAD-1.3.1-x86_64.AppImage
./MAPLEAD-1.3.1-x86_64.AppImage
chmod +x MAPLEAD-1.4.0-x86_64.AppImage
./MAPLEAD-1.4.0-x86_64.AppImage
```

Building it yourself (also fine for arm64/other distros with a rebuild):
Expand Down Expand Up @@ -132,6 +133,22 @@ Details and the safety settings: [docs/GUIDE.md › Bulk WhatsApp](docs/GUIDE.md
<a href="docs/screenshots/bulk-sender.png"><img src="docs/screenshots/bulk-sender.png" width="26%" alt="bulk send: progress and activity log"></a>
</p>

## 6 · Turbo mode (Linux)

**Turbo mode** (under *Run search*, or `Ctrl+T`) does the search and the bulk
send by itself, for a whole list of cities and business types:

1. tick the cities and the business types, pick the filter (*No website* by
default) and the safety pauses;
2. it searches the first business type in the first city, sends your saved
message to every lead that passes the filter, then moves to the next business
type — and, after the last one, to the next city;
3. it ends when the lists do, or when you press **Stop**. Starting it again
continues where it stopped, and nobody is messaged twice.

Every search uses provider credits. Details:
[docs/GUIDE.md › Turbo mode](docs/GUIDE.md#turbo-mode).

---

## Terminal wizard
Expand Down Expand Up @@ -183,9 +200,9 @@ On Linux the wizard is inside the AppImage — the same file as the desktop app,
nothing has to be installed first either:

```bash
./MAPLEAD-1.3.1-x86_64.AppImage --cli --demo
./MAPLEAD-1.3.1-x86_64.AppImage --cli --country DE --city Berlin --business dentist
./MAPLEAD-1.3.1-x86_64.AppImage --cli --doctor
./MAPLEAD-1.4.0-x86_64.AppImage --cli --demo
./MAPLEAD-1.4.0-x86_64.AppImage --cli --country DE --city Berlin --business dentist
./MAPLEAD-1.4.0-x86_64.AppImage --cli --doctor
```

You can add `~/.local/bin/maplead-cli` yourself (`#!/bin/sh` + `exec "$HOME/Apps"/MAPLEAD-*-x86_64.AppImage --cli "$@"`)
Expand Down
43 changes: 38 additions & 5 deletions docs/GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,11 +20,11 @@ New here? Read this once, then the [README](../README.md) is just a reminder.

### Linux x86_64

Download `MAPLEAD-1.3.1-x86_64.AppImage`, then:
Download `MAPLEAD-1.4.0-x86_64.AppImage`, then:

```bash
chmod +x MAPLEAD-1.3.1-x86_64.AppImage # first time only
./MAPLEAD-1.3.1-x86_64.AppImage
chmod +x MAPLEAD-1.4.0-x86_64.AppImage # first time only
./MAPLEAD-1.4.0-x86_64.AppImage
```

After `./build-appimage.sh --install` you can also just type `maplead`, and the app
Expand All @@ -36,7 +36,7 @@ only things it expects from the system are a display and the usual C library.
The same file runs the terminal wizard too — no Python needed:

```bash
./MAPLEAD-1.3.1-x86_64.AppImage --cli --demo
./MAPLEAD-1.4.0-x86_64.AppImage --cli --demo
```

**No FUSE?** Older AppImages mount themselves through `libfuse.so.2`. If your system
Expand Down Expand Up @@ -216,6 +216,39 @@ Windows); contacted leads show a *Contacted* chip and are skipped by default.
> the risk of the number being restricted; they do not remove it. Use a number
> dedicated to prospecting.

### Turbo mode

**Turbo mode** (under *Run search*, or `Ctrl+T`) runs the search and the bulk
send by itself for a list of cities and a list of business types. It uses the
provider, country, region and fields of the search form, and the WhatsApp
message saved in the leads panel. It needs a provider with an API key: the Demo
provider returns made-up phone numbers, so turbo mode refuses it.

1. Tick the **cities** and the **business types** to go through, in the order
listed. *Add* puts your own entry at the top of a list.
2. Choose **who gets the message**: the *Lead filter* (*No website*, *Has
website*, *Has e-mail* or *Every lead with WhatsApp*) and the *Leads per
search*. The **Safety** settings are the ones Bulk WhatsApp uses.
3. **Start turbo** opens WhatsApp Web inside MAPLEAD, then repeats: search one
business type in one city, keep the leads that pass the filter, send them the
message with the safety pauses, go to the next business type — and, after the
last one, to the next city. Each search also shows up in the results grid.
4. It ends after the last business type of the last city, or when you press
**Stop**. **Pause** and **Skip lead** work as in Bulk WhatsApp.

The footer of the setup window shows how many searches the lists add up to.
Every search uses provider credits, so start with a few cities and business
types.

Leads already messaged are never messaged again. Finished searches are
remembered in `turbo-progress.json` in the data folder, so starting turbo mode
again continues where it stopped; *Forget* in the setup window clears that
memory. With the default safety settings the run stops and asks every 25
messages and at 50 messages a day — set *Ask after* and *Daily limit* to 0 to
let it run unattended, at a higher risk of WhatsApp restricting the number.
After three failed searches in a row (for example a rejected API key) the run
stops by itself.

## 7 · The export file

A search **never writes a file by itself**. Results stay in the grid and in the
Expand Down Expand Up @@ -250,7 +283,7 @@ The original interface, still fully supported and dependency-free:
Without Python, the packaged builds carry the same wizard:

```bash
./MAPLEAD-1.3.1-x86_64.AppImage --cli --demo # Linux: the AppImage is both
./MAPLEAD-1.4.0-x86_64.AppImage --cli --demo # Linux: the AppImage is both
.\MAPLEAD-1.2.0-windows-x64.exe --cli --demo # Windows: same trick, one .exe
```

Expand Down
2 changes: 1 addition & 1 deletion maplead/art.py
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@

from . import host

VERSION = "1.3.1"
VERSION = "1.4.0"

# --------------------------------------------------------------------------- #
# colour plumbing
Expand Down
Loading
Loading