Skip to main content

Molly

Molly is a simple to use (noisy) multithreaded port scanner. You can use it to find potential vulnerabilities within your network.

Installation

Make sure you have either pip or pipenv installed on your system and run:

pip install molly

or

pipenv install molly

Basic Usage

Molly comes with a simple subcommand conveniently called scan. It takes a target as an argument and two non-required options: mode and workers

molly scan <target> --mode<mode> --workers <workers>

Below are a few examples

Very Simple Scan

molly scan scanme.nmap.org

Scan the top 20 ports for a given target

molly scan scanme.nmap.org --mode common

Increase the number of worker threads to improve speed

molly scan 192.168.0.4 --workers 200

Arguments and options

  • target: the target to perform the scan against (can be a hostname or a valid IPv4 address)
  • mode: the type of scan to perform. Choose between:
    • basic (default): Ports 1 to 1024.
    • full: all TCP ports.
    • common: top 20 ports (21, 22, 23, 25, 53, 80, 110, 111, 135, 139, 143, 443, 445, 993, 995, 1723, 3306, 3389, 5900, 8080 ).
    • custom (prompt): your desired port range (separated by a comma).
  • workers: the number of worker threads to run

Future features and Roadmap

While molly in its current state is not in alpha by any measure, I plan on adding more features to it as I go along and learn more about computer networking. The aim is for me to solidify my knowledge in the subject and to provide you with a solid application that you can use reliably.

The following is the list of features a plan on implementing:

  • Ping sweeps
  • IP Ranges
  • "Stealthy" port scanning

Licence

WTFPL

Contributing

This project is completely free and open source, therefore I not only welcome but encourage contributions from other developers.

If you want to report a bug or ask for a new feature, I invite you to open a new issue. Even better, if you want to dig in the code and offer your solution, open a PR with your changes (just make sure all the tests pass).

Release files for molly-py 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for molly-py 0.1.0
File Size Uploaded
molly-py-0.1.0.tar.gz 6.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for molly-py 0.1.0
File Interpreter ABI Platform
molly_py-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 15.2 kB

Release files / molly-py-0.1.0.tar.gz

Download URL molly-py-0.1.0.tar.gz
Size 6.4 kB
Tags Source
SHA-256 checksum
How to use checksums
40f2695838b2e2d3c7002c43ea30f7f922aaba3b3fb558fa1b2e4f9a10ee88f6
BLAKE2b-256 checksum
How to use checksums
270c66c82052f43bf7b89062b3b1e06141077cef749db729dee6be26268aeede
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4

Release files / molly_py-0.1.0-py3-none-any.whl

Download URL molly_py-0.1.0-py3-none-any.whl
Size 8.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
16b91a15c3d23a397f67a4a08c47425a24e9a980a995856d599edf49f85614c6
BLAKE2b-256 checksum
How to use checksums
9dc5247d61fca26233ac80ab125079b04060f6933eb5d58c9b9051dbff804f79
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page