Skip to main content

Tools for finding and storing profile pics of whatsapp contacts in large scale.

Project description


Tools for finding and storing profile pics of whatsapp contacts in large scale.


From pypi

$ pip install peoplefinder

From source (current version 1.0b1)

$ git clone
$ cd people-finder
$ python install

Telegram API token

If you plan to use peopleuploader functionalities, make sure your environment variable PEOPLE_API_TOKEN points to our bot.


A graphical interface will be implemented in future updates, but, for now, the usage is inline. We've set up the number's format to our country, Brazil (+55 XX XXXX-XXXX). A example of use is

$ peoplefinder -n 10 -d 84 -r

where the 10 refers to number of loops in search, 84 refers to the local area code of the phone numbers and the -r flag indicates random number generation

Alternatively one can create a list of numbers in a file named input.txt in the same directory and omit this flag.

Uploading to telegram @peoplefinder

$ peopleuploader [-s <savedir>] [-c]

This will upload all pictures inside savedir. The optional flag -c will clear the files simultaneously.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

peoplefinder-1.0b1.tar.gz (4.2 kB view hashes)

Uploaded Source

Built Distributions

peoplefinder-1.0b1-py3.6.egg (12.6 kB view hashes)

Uploaded Source

peoplefinder-1.0b1-py3-none-any.whl (8.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page