Streetpass Automation Script for Android
Hello everyone!
This is a android shell script I began creating as soon as I heard of the strides in homemade streetpass relays here on Temp and other places in the net. My focus is on customization.
It works quite like Chaldron's MAC Cycler, but on android. Since it can reverse tether your phone automatically, it's very useful for people without data plans like myself, or who only have access to a wireless router that can't clone its MAC easily. The way I have it setup, the internet connection comes from a wireless router to my PC, is shared with the phone by usb and is finally broadcast correctly from there.
To add or exclude MAC addresses, simply edit '/data/script.autoStreetPass/macList.txt'. By default it includes the GbaTemp prime MACs, the other 'near Nintendo Zone' MACs and personal MACs taken from the official spreadsheet.
Requirements
Usage
To install the script, simply unzip the contents of its release file to the root of your sd card.
My script was tested with Script Manager, but it should work with similar solutions. Navigate to /data/script.autoStreetpassForAndroid/ choose macCicle.sh, check Root and Wakelock, set your desired arguments and run. You can use the addon package SMWidgets to make a quick widget on the phone's launcher for quick access.
If you want to use reverse tethering just connect your phone to your PC, share a connection with the usb network adapter and turn on usb tethering before running the script with the proper argument(s) (See Configuration for details).
Configuration
In the main script there are some variables that can be edited along with a brief summary where applicable.
Thre is also file macList.txt, which stores all the MAC addresses that will be used. Invalid entries are ignored, as well as commentary lines denoted by '#' at their start.
As for the script's arguments, see the script's help text below:
Starts and manages a wifi access point while cicling through different MAC addresses -h Display help page -u ensure Enables usb reverse tethering Optional argument, if true quits on error -l loops Number of times to iterate through MAC list, default 1 Pass 0 for it to loop indefinitely -t delay<unit> Sets a custom delay beteen MAC changing Unit format: [s:seconds|m:minutes|h:hours|d:days]
Download
You can download it by going here and selecting the latest version. Also, please consider throwing me a penny for helping with college, by clicking here.
Considerations
Please report any issues here.
Thank you to everyone who made unnoficial streetpass relaying possible, now I can finally complete some puzzles!
This is a android shell script I began creating as soon as I heard of the strides in homemade streetpass relays here on Temp and other places in the net. My focus is on customization.
It works quite like Chaldron's MAC Cycler, but on android. Since it can reverse tether your phone automatically, it's very useful for people without data plans like myself, or who only have access to a wireless router that can't clone its MAC easily. The way I have it setup, the internet connection comes from a wireless router to my PC, is shared with the phone by usb and is finally broadcast correctly from there.
To add or exclude MAC addresses, simply edit '/data/script.autoStreetPass/macList.txt'. By default it includes the GbaTemp prime MACs, the other 'near Nintendo Zone' MACs and personal MACs taken from the official spreadsheet.
Requirements
- Root Access
- ROM able to read the Wi-Fi MAC address from a file (only implemented for CyanogenMod based ROMs for now)
- 'Wifi Tether for Root Users' app (found here)*
- Usb tethering capabilities for reverse tethering, optional
Usage
To install the script, simply unzip the contents of its release file to the root of your sd card.
My script was tested with Script Manager, but it should work with similar solutions. Navigate to /data/script.autoStreetpassForAndroid/ choose macCicle.sh, check Root and Wakelock, set your desired arguments and run. You can use the addon package SMWidgets to make a quick widget on the phone's launcher for quick access.
If you want to use reverse tethering just connect your phone to your PC, share a connection with the usb network adapter and turn on usb tethering before running the script with the proper argument(s) (See Configuration for details).
Configuration
In the main script there are some variables that can be edited along with a brief summary where applicable.
Thre is also file macList.txt, which stores all the MAC addresses that will be used. Invalid entries are ignored, as well as commentary lines denoted by '#' at their start.
As for the script's arguments, see the script's help text below:
Starts and manages a wifi access point while cicling through different MAC addresses -h Display help page -u ensure Enables usb reverse tethering Optional argument, if true quits on error -l loops Number of times to iterate through MAC list, default 1 Pass 0 for it to loop indefinitely -t delay<unit> Sets a custom delay beteen MAC changing Unit format: [s:seconds|m:minutes|h:hours|d:days]
Download
You can download it by going here and selecting the latest version. Also, please consider throwing me a penny for helping with college, by clicking here.
Considerations
Please report any issues here.
Thank you to everyone who made unnoficial streetpass relaying possible, now I can finally complete some puzzles!
