Improve cracking command output and config defaults

CONTRIBUTING.md

@@ -0,0 +1,79 @@
+# Contributing to wifite2
+
+Thank you for your interest in contributing. Please follow these guidelines to keep the project consistent and maintainable.
+
+---
+
+## Development Environment
+
+```bash
+# Clone your fork
+git clone https://github.com/<your-username>/wifite2.git
+cd wifite2
+
+# Create and activate a virtual environment
+python3 -m venv .venv
+source .venv/bin/activate
+
+# Install in editable mode with all dependencies
+pip install -e .
+pip install -r requirements.txt
+```
+
+---
+
+## Running the Test Suite
+
+```bash
+pytest tests/ -v
+```
+
+All tests must pass before submitting a pull request. If you add new functionality, add corresponding tests in `tests/`.
+
+Some tests require external tools (`tshark`, `aircrack-ng`, `cowpatty`). Install them on your system or mock them in your test fixtures.
+
+---
+
+## Code Style
+
+- Follow **PEP 8** for all Python code.
+- Use the existing `Color` and `Output` utilities (`wifite/util/color.py`) for any user-facing output. Do not use bare `print()` calls.
+- Use `log_debug()` / `log_info()` from `wifite/util/logger.py` for internal diagnostic messages.
+- Keep functions focused. Refactor large blocks into helper methods rather than adding deeply nested logic.
+- Type hints are welcome but not required for existing modules; new modules should include them where practical.
+
+---
+
+## Submitting a Pull Request
+
+1. **Fork** the repository and create a feature branch off `master`:
+   ```bash
+   git checkout -b feature/my-improvement
+   ```
+2. Make your changes, following the style guidelines above.
+3. Run the test suite and confirm it passes.
+4. Commit with a clear, concise message describing *what* changed and *why*.
+5. Push your branch to your fork and open a **Pull Request against `master`**.
+6. Fill in the PR description: what problem it solves, how it was tested, and any known limitations.
+
+PRs that break existing tests or lack a description will not be merged.
+
+---
+
+## Testing Requirements
+
+Contributions that touch attack logic, capture parsing, or tool integrations **must** be tested on real hardware or with mocked interfaces. Specifically:
+
+- Use `.cap` / `.pcapng` fixture files in `tests/files/` for capture-related changes.
+- Mock external process calls (`aircrack-ng`, `tshark`, etc.) using `unittest.mock` where live hardware is not available.
+- Document in your PR description how you verified the change (hardware model, driver, OS, or mock strategy).
+
+---
+
+## Responsible Disclosure
+
+If you discover a security vulnerability in wifite2 itself (not a vulnerability in a third-party tool it wraps), **do not open a public GitHub issue**.
+
+Instead, email the maintainer directly. Provide a clear description of the issue, reproduction steps, and potential impact. Allow reasonable time for a fix before any public disclosure.
+
+Public issues are appropriate for bugs, feature requests, and usage questions, not for 0-day disclosures.

requirements.txt

@@ -3,7 +3,7 @@
 chardet>=7.4.3
 requests>=2.33.1
 rich>=15.0.0
-scapy>=2.7.1rc1; python_version < '4'
+scapy>=2.6.0; python_version < '4'
 setuptools>=82.0.1
 
 # Development dependencies (optional)

wifite/args.py

@@ -647,6 +647,17 @@ def _add_wep_args(self, wep):
                              'Seconds to wait before failing (default: {G}%d sec{W})' % self.config.wep_timeout))
         wep.add_argument('-wept', help=argparse.SUPPRESS, action='store', dest='wep_timeout', type=int)
 
+        wep.add_argument('--wep-fakeauth-time',
+                         action='store',
+                         dest='wep_fakeauth_time',
+                         metavar='[seconds]',
+                         type=int,
+                         help=self._verbose(
+                             'Seconds to wait for fake-authentication (default: {G}%d sec{W})'
+                             % self.config.wep_fakeauth_time))
+        wep.add_argument('-wep-fakeauth-time', help=argparse.SUPPRESS, action='store',
+                         dest='wep_fakeauth_time', type=int)
+
         wep.add_argument('--wepca',
                          action='store',
                          dest='wep_crack_at_ivs',
@@ -1106,6 +1117,12 @@ def _add_command_args(commands):
                               dest='crack_handshake',
                               help=Color.s('Show commands to crack a captured handshake'))
 
+        commands.add_argument('--print-crack-cmd',
+                              action='store_true',
+                              dest='show_cracking_command',
+                              help=Color.s('Print the exact cracking command before running it, '
+                                          'for easy copy/pasting into a terminal (default: {G}off{W})'))
+
         commands.add_argument('--syscheck',
                               action='store_true',
                               dest='syscheck',

wifite/attack/wep.py

@@ -21,7 +21,7 @@ class AttackWEP(Attack):
         Contains logic for attacking a WEP-encrypted access point.
     """
 
-    fakeauth_wait = 5  # TODO: Configuration?
+    fakeauth_wait = 5
 
     def __init__(self, target):
         super(AttackWEP, self).__init__(target)
@@ -206,7 +206,6 @@ def run(self):
                                 if not xor_file:
                                     # If .xor is not there, the process failed.
                                     Color.pl('\n{!} {O}%s attack{R} did not generate a .xor file' % attack_name)
-                                    # XXX: For debugging
                                     Color.pl('{?} {O}Command: {R}%s{W}' % ' '.join(aireplay.cmd))
                                     Color.pl('{?} {O}Output:\n{R}%s{W}' % aireplay.get_output())
                                     break
@@ -381,14 +380,15 @@ def fake_auth(self):
         Returns: True if successful, False is unsuccessful.
         """
         Color.p('\r{+} attempting {G}fake-authentication{W} with {C}%s{W}...' % self.target.bssid)
-        fakeauth = Aireplay.fakeauth(self.target, timeout=AttackWEP.fakeauth_wait)
+        fakeauth_wait = Configuration.wep_fakeauth_time or AttackWEP.fakeauth_wait
+        fakeauth = Aireplay.fakeauth(self.target, timeout=fakeauth_wait)
         if fakeauth:
             Color.pl(' {G}success{W}')
         else:
             Color.pl(' {R}failed{W}')
             if Configuration.require_fakeauth:
                 # Fakeauth is required, fail
-                raise Exception('Fake-authenticate did not complete within %d seconds' % AttackWEP.fakeauth_wait)
+                raise Exception('Fake-authenticate did not complete within %d seconds' % fakeauth_wait)
             # Warn that fakeauth failed
             Color.pl('{!} {O} unable to fake-authenticate with target (%s){W}' % self.target.bssid)
             Color.pl('{!} continuing attacks because {G}--require-fakeauth{W} was not set')

wifite/config/__init__.py

@@ -53,6 +53,7 @@ class Configuration:
     random_mac = None
     random_mac_vendor = None
     require_fakeauth = None
+    show_cracking_command = False
     scan_time = None
     show_bssids = None
     show_cracked = None
@@ -97,6 +98,7 @@ class Configuration:
     wep_attacks = None
     wep_crack_at_ivs = None
     wep_filter = None
+    wep_fakeauth_time = 5
     wep_keep_ivs = None
     wep_pps = None
     wep_restart_aircrack = None
@@ -216,6 +218,8 @@ def load_from_arguments(cls):
             cls.check_handshake = args.check_handshake
         if args.crack_handshake:
             cls.crack_handshake = True
+        if hasattr(args, 'show_cracking_command') and args.show_cracking_command:
+            cls.show_cracking_command = True
         if args.update_db:
             cls.update_db = True
         if hasattr(args, 'syscheck') and args.syscheck:

wifite/config/defaults.py

@@ -61,7 +61,7 @@ def initialize_defaults(cls):
     cls.interface_primary = None  # Primary interface name
     cls.interface_secondary = None  # Secondary interface name
     cls.auto_assign_interfaces = True  # Auto-assign interfaces (default True)
-    cls.prefer_dual_interface = True  # Prefer dual over single when available (default True)
+    cls.prefer_dual_interface = False  # Prefer dual over single when available (default False)
     cls.use_hcxdump = False  # Use hcxdumptool for dual interface WPA capture (default False)
 
     # WEP variables
@@ -70,6 +70,7 @@ def initialize_defaults(cls):
     cls.wep_timeout = 600  # Seconds to wait before failing
     cls.wep_crack_at_ivs = 10000  # Minimum IVs to start cracking
     cls.require_fakeauth = False
+    cls.wep_fakeauth_time = 5  # Seconds to wait for fake-authentication to complete
     cls.wep_restart_stale_ivs = 11  # Seconds to wait before restarting
     # Aireplay if IVs don't increase.
     # '0' means never restart.
@@ -152,6 +153,7 @@ def initialize_defaults(cls):
     cls.wps_timeout_threshold = 100  # Max number of timeouts
 
     # Commands
+    cls.show_cracking_command = False  # Print exact cracking command to stdout (--print-crack-cmd)
     cls.show_cracked = False
     cls.show_ignored = False
     cls.check_handshake = None

wifite/config/parsers/wep.py

@@ -18,6 +18,11 @@ def parse_wep_args(cls, args):
         cls.wep_timeout = args.wep_timeout
         Color.pl('{+} {C}option:{W} WEP attack timeout set to {G}%d seconds{W}' % args.wep_timeout)
 
+    if args.wep_fakeauth_time:
+        cls.wep_fakeauth_time = args.wep_fakeauth_time
+        Color.pl('{+} {C}option:{W} WEP fake-authentication timeout set to {G}%d seconds{W}'
+                 % args.wep_fakeauth_time)
+
     if args.require_fakeauth:
         cls.require_fakeauth = True
         Color.pl('{+} {C}option:{W} fake-authentication is {G}required{W} for WEP attacks')

wifite/model/handshake.py

@@ -40,12 +40,38 @@ def divine_bssid_and_essid(self):
 
         if not self.essid and not self.bssid and len(pairs) > 0:
             # We do not know the bssid nor the essid
-            # TODO: Display menu for user to select from list
-            # HACK: Just use the first one we see
-            self.bssid = pairs[0][0]
-            self.essid = pairs[0][1]
-            Color.pl('{!} {O}Warning{W}: {O}Arbitrarily selected ' +
-                     '{R}bssid{O} {C}%s{O} and {R}essid{O} "{C}%s{O}"{W}' % (self.bssid, self.essid))
+            if len(pairs) == 1:
+                self.bssid = pairs[0][0]
+                self.essid = pairs[0][1]
+            else:
+                # Multiple networks in capture; no prior context to choose from.
+                # TODO: Display menu for user to select from list
+                chosen_bssid, chosen_essid = pairs[0]
+                Color.pl(
+                    '{!} {O}Warning{W}: Multiple networks found in capture file. '
+                    'Using first: {C}%s{W} ({C}%s{W}). '
+                    'Use {G}--bssid{W} to target a specific network.' % (chosen_bssid, chosen_essid)
+                )
+                self.bssid = chosen_bssid
+                self.essid = chosen_essid
+        elif not self.essid and self.bssid and len(pairs) > 1:
+            # BSSID is already set (e.g. from attack context or filename); try to match it.
+            matched = next(
+                ((bssid, essid) for (bssid, essid) in pairs if bssid.lower() == self.bssid.lower()),
+                None,
+            )
+            if matched:
+                self.essid = matched[1]
+            else:
+                # Pre-set BSSID not found among captured pairs; warn and fall back to first.
+                chosen_bssid, chosen_essid = pairs[0]
+                Color.pl(
+                    '{!} {O}Warning{W}: Multiple networks found in capture file. '
+                    'BSSID {C}%s{W} not matched; using first: {C}%s{W} ({C}%s{W}). '
+                    'Use {G}--bssid{W} to target a specific network.' % (self.bssid, chosen_bssid, chosen_essid)
+                )
+                self.bssid = chosen_bssid
+                self.essid = chosen_essid
 
         if not self.bssid:
             # We already know essid

wifite/util/crack.py

@@ -18,7 +18,22 @@
 from ..util.sae_crack import SAECracker
 
 
-# TODO: Bring back the 'print' option, for easy copy/pasting. Just one-liners people can paste into terminal.
+def print_cracking_command(tool_name, command_parts):
+    """
+    Print the exact shell command that would be run for cracking,
+    so users can copy-paste it into a terminal.
+
+    Used by cracking helpers that need a consistently formatted command line.
+
+    Args:
+        tool_name:     Human-readable label for the tool (e.g. 'aircrack-ng').
+        command_parts: List of strings forming the shell command (argv style).
+    """
+    import shlex
+    from ..util.color import Color
+    cmd_str = ' '.join(shlex.quote(str(p)) for p in command_parts)
+    Color.pl('{+} {C}[crack-cmd]{W} {G}%s{W}: {W}%s' % (tool_name, cmd_str))
+
 
 def decode_hex_essid_if_needed(essid):
     """
@@ -383,20 +398,23 @@ def crack_4way(cls, hs, tool):
             Color.pl('{!} {R}Error: {O}%s{W}' % e)
             return None
 
+        # show_command is True when verbose or when --print-crack-cmd is set
+        show_cmd = Configuration.show_cracking_command or Configuration.verbose > 0
+
         wordlists_to_try = Configuration.wordlists if Configuration.wordlists else [Configuration.wordlist]
 
         for wordlist in wordlists_to_try:
             wordlist_name = os.path.basename(wordlist)
             Color.pl('{+} Trying wordlist: {C}%s{W}' % wordlist_name)
 
             if tool == 'aircrack':
-                key = Aircrack.crack_handshake(handshake, show_command=True, wordlist=wordlist)
+                key = Aircrack.crack_handshake(handshake, show_command=show_cmd, wordlist=wordlist)
             elif tool == 'hashcat':
-                key = Hashcat.crack_handshake(handshake, target_is_wpa3_sae=False, show_command=True, wordlist=wordlist)
+                key = Hashcat.crack_handshake(handshake, target_is_wpa3_sae=False, show_command=show_cmd, wordlist=wordlist)
             elif tool == 'john':
-                key = John.crack_handshake(handshake, show_command=True, wordlist=wordlist)
+                key = John.crack_handshake(handshake, show_command=show_cmd, wordlist=wordlist)
             elif tool == 'cowpatty':
-                key = Cowpatty.crack_handshake(handshake, show_command=True, wordlist=wordlist)
+                key = Cowpatty.crack_handshake(handshake, show_command=show_cmd, wordlist=wordlist)
 
             if key is not None:
                 return CrackResultWPA(hs['bssid'], hs['essid'], hs['filename'], key)
@@ -408,12 +426,15 @@ def crack_pmkid(cls, hs, tool):
         if tool != 'hashcat':
             Color.pl('{!} {O}Note: PMKID hashes can only be cracked using {C}hashcat{W}')
 
+        # show_command is True when verbose or when --print-crack-cmd is set
+        show_cmd = Configuration.show_cracking_command or Configuration.verbose > 0
+
         wordlists_to_try = Configuration.wordlists if Configuration.wordlists else [Configuration.wordlist]
 
         for wordlist in wordlists_to_try:
             wordlist_name = os.path.basename(wordlist)
             Color.pl('{+} Trying wordlist: {C}%s{W}' % wordlist_name)
-            key2 = Hashcat.crack_pmkid(hs['filename'], verbose=True, wordlist=wordlist)
+            key2 = Hashcat.crack_pmkid(hs['filename'], verbose=show_cmd, wordlist=wordlist)
             if key2 is not None:
                 return CrackResultPMKID(hs['bssid'], hs['essid'], hs['filename'], key2)
 
@@ -426,6 +447,9 @@ def crack_sae(cls, hs, tool):
             Color.pl('{!} {O}Note: WPA3-SAE handshakes can only be cracked using {C}hashcat{W}')
             return None
 
+        # show_command is True when verbose or when --print-crack-cmd is set
+        show_cmd = Configuration.show_cracking_command or Configuration.verbose > 0
+
         # Create SAEHandshake object
         sae_handshake = SAEHandshake(
             capfile=hs['filename'],
@@ -441,8 +465,8 @@ def crack_sae(cls, hs, tool):
             key = SAECracker.crack_sae_handshake(
                 sae_handshake,
                 wordlist=wordlist,
-                show_command=True,
-                verbose=True
+                show_command=show_cmd,
+                verbose=show_cmd
             )
             if key is not None:
                 return CrackResultSAE(hs['bssid'], hs['essid'], hs['filename'], key)