If you twist it hard enough, mcbash will stand for Yet Another MAC Scanner.

Quick start

$ wget https://raw.githubusercontent.com/dougy147/mcbash/refs/heads/master/bin/mcbash
$ chmod +x ./mcbash
$ ./mcbash

Overview

mcbash --help displays most common options.

Requests

Option	Functionality
-u, --url	Server's URL/IP
-w, --wait	Wait X seconds between each requests
-b, --break	Make a break every X requests
-d, --pause-for	Break duration (in seconds)
-s, --stop	Stop McBash after X tested MACs
-t, --timeout	Consider request a timeout after X seconds
-P, --proxy	Set the proxy URL (any authentication method supported)
-pu, --proxy-user	Set your proxy credentials user:password
--proxy-file	Read proxy IPs from a file. Rotation when request timeout
-EA, --enhanced-auth	Add SN and DevID1 to GET request (and save them if match)

Scan mode

Option	Functionality
--mac-file	Choose a file to read MACs from (MACs should be line by line)
--seq	Check MACs in sequential order (--range is forced)
--range	Set a range for checked MACs
-F, --from	Set range lower boundary (lowest MAC value to check)
-L, --to	Set range higher boundary (highest MAC value to check)
--prefix	Select MACs prefix when screening in random mode

Others

Option	Functionality
-k, --keep	Store expired MACs (valid addresses but expired accounts)
-np, --default	Don't ask for parameters. Use default configuration
--show-only-mac	Only outputs found MACs
--no-checkpoint	Don't store checkpoints

For advanced settings, read the manual : man mcbash.

To change default options, simply edit $HOME/.config/mcbash/mcbash.conf.

Usecase examples

$ mcbash -F 00:1A:79:00:00:00 -L 00:1A:79:00:11:11 --seq

Scans sequentially from 00:1A:79:00:00:00 to 00:1A:79:00:11:11.

$ mcbash --proxy http://localhost:12345 --proxy-user user:pwd

Uses specified proxy http://localhost:12345, with user:pwd username and password.

$ mcbash --proxy-file /path/to/proxies-list.txt

Uses proxies listed in a file (format must be IP[:PORT], one line = one proxy). Auto-rotates if proxy fails.

$ mcbash --mac-file ./path/to/your-MACs-list.txt

Scans using your own list of MACs (one line = one MAC).

Install

From source

$ git clone https://github.com/dougy147/mcbash
$ cd ./mcbash
$ make install

ArchLinux

$ yay -S mcbash

DISCLAIMER

bla bla bla don't hurt anyone with this tool, including yourself 3;)

Special thanks to contributors !

Feel free ! 😎

If mcbash has been of any help to you, I'd be glad and thankful !

BTC : bc1q4cflj0e3hwcn5edut654je86upn37p37gut5yk