mcbash
(for mac checker bash version) scans for valid MAC addresses on Stalker Portal servers.
It's a fast, modular and user-friendly script. Just feed it with a server URL or IP, and let it check by itself.
ℹ now compatible with macOS
If you're an Arch user, you can install from the AUR with yay -S mcbash
. Else, simply :
git clone https://github.com/dougy147/mcbash
cd mcbash
sudo make install
mcbash
As servers may differ in the way they handle requests, one need to adapt.
The key feature of mcbash
is flexibility. It comes with handy options to manage your requests. mcbash --help
display most common options. For "advanced" settings, read the manual (man mcbash
).
Option | Functionality |
---|---|
-k , --keep |
Store expired MAC (valid addresses but expired accounts) |
-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 |
-u , --url |
Server's URL/IP |
-w , --wait |
Wait X seconds between each requests |
-np , --default |
Don't ask for parameters. Use default configuration |
By default, MACs are checked randomly. If you want to screen a specific range, use --range
.
Option | Functionality |
---|---|
--range |
Check MACs in sequential order |
-F , --from |
Set first MAC to check (--range is forced) |
-L , --to |
Set last MAC to check (--range is forced) |
🆕 You can now tell mcbash
to use your proxy (credentials supported too).
Option | Functionality |
---|---|
-P , --proxy |
Set the proxy URL (any authentication method supported |
-pu , --proxy-user |
Set your proxy credentials user:password |
🆕 Only redirect found MAC addresses to stdout.
Option | Functionality |
---|---|
--show-only-mac |
Only outputs found MACs (useful if you want to redirect stdout to another program) |
The config file (mcbash.conf
) is created during the install process here : $HOME/.mcbash/mcbash.conf
. Change some values according to your needs.
Did you close your terminal ? Don't worry, when a valid MAC is found, it is stored in mcbash
directory : $HOME/.mcbash
.
When executing mcbash
with arguments (except for -u
and --range
alone), it will generally assume you know what you're doing, and won't ask questions.
Else, it will prompt you for settings. Check below for options you can manually set.
For 00:1A:79:xx:xx:xx
-like MAC addresses (the most commonly used), there are
-
Solution 1 : join the colorblind gang.
-
Solution 2 : colors are set with
tput
(e.g.tput setf 1
). Change its value from 0 to 7. If you know of a more universal/efficient way to color text, please contact me.
mcbash -u my-fakedns.org:8080 -w 1.5 -b 10 -d 3 -s 1500 -t 2
The program sleeps 1.5 seconds between each requests, pauses every 10 requests for 3 seconds, stops after 1500 MACs checkeds, and consider timeout after 2 seconds (timeouts trigger a pause to avoid flood).
mcbash -u my-fakedns.org:8080 -F 00:1A:79:00:00:00 -L 00:1A:79:00:11:11
Scan from first (-F
) to last (-L
) provided MAC.
mcbash -u my-fakedns.org:8080 --proxy http://localhost:12345 --proxy-user user:password
Tells mcbash
to communicate through proxy http://localhost:12345
with user:password
username and password.
Power is all relative, and this program's is pretty low; even quite harmless. However, I must release myself of any responsibility in the way you will use this program. Indeed, its use might be unappropriate in your country.
As far as I understand (i.e. poorly), imperative programming is like stacking bricks on top of each other. If there's nothing wrong stacking, climbing the pile might. That way, it's unnecessary to say I'm only responsible for sharing a recipe one could find all the ingredients thanks to any search engine.
So, illegality is not contained in that program. It can only be in its user's behavior. Please use that script consciously, with and on your personal goods only.
Don't just pass by, and help improve mcbash
. Pull requests are open
If you (1) are cool enough to know what to do with this 😎 and (2) find this program useful, I'd be glad and thankful :
bc1q4cflj0e3hwcn5edut654je86upn37p37gut5yk