Update 'README.md'

cleaned up README and clarified usage
master
RightToPrivacy 2022-05-20 16:16:19 -04:00
parent 3763462ca3
commit ed82bc8878
1 changed files with 19 additions and 11 deletions

View File

@ -2,27 +2,33 @@
### WIFi Device/MAC/Device Metadata Disinfo: Address Changer/Hostname randomizer/Device/Signal/location Privacy
[Without disconnecting you from the internet]
[Without disconnecting from internet]
---
#### NOTE: You don't need to understand everything in this README to get started. It's simple. Just run the install.sh and answer the simple questions to let wipri take care of the install + startup
#### NOTE: You don't need to understand everything in README to get started. It's simple.
Just run the install.sh and answer the simple questions to let wipri take care of the install + startup for you.
---
* NEW * wipri-list (option) allows you to create random yet valid OUI lists, select random mac from this list and set it, remove etc
* NEW * wipri-list (option) allows you to create random yet valid OUI lists (or single quasi-perm mac file!), flags to select at random a mac from list, set it, remove, generate new ones to list, etc.
---
#### wipri-list Command:
TIP: Want to install a single 'quasi-permanent' mac address on ethernet or wifi? Easy! Set this up as your wipri service automatically by running install.sh and choosing: wipri-list -s eth0 (replace eth0 with your device) command as your answer on initial install.sh 'boot' question.
TIP: Want a single 'quasi-permanent' mac address option for ethernet access control list (or wifi)?
Easy!
Set up wipri service automatically by running install.sh and choosing: wipri-list -s eth0 (replace eth0 with your device, be it wifi or ethernet) command as your answer on initial install.sh 'boot' question.
Above is easy. Running install.sh automatically creates the first wipri-list valid mac address, adding it to wipri-list's list (during install).
Since it automatically creates that first mac in your 'list', you could have it set a single quasi-perm mac address.
Since it automatically creates that first mac in your wipri-list 'list', you could leave it to create a single quasi-perm mac address service.
This can help for those who want to 'spoof' their mac, but have a valid yet random 'permanent' mac address. For mac access lists in network, or simply to recognize your spoofed mac at all times.
This can help for those who want to 'spoof' their mac, but wish to have a valid yet random 'permanent' mac address. Ideal for mac access lists (in network), or simply to recognize your mac at all times.
After this you can add additional mac addresses to your list anytime, by running wipri-list -a (to add new generated, valid OUI mac)
@ -30,7 +36,7 @@ And like I said, it's easy to automate this "set random mac from your wipri-list
---
Personal: It's up to you how you want to use it. I personally like setting permanent protective wipri service commands for wifi, and enjoy using wipri-list wipri-eth0.service file to maintain a quasi-perm ethernet mac (you can make it change every boot if you like, or keep recognized spoofed macs, generated automatically for you)
Personal: It's up to you how you want to use it. I personally like setting permanent protective wipri service commands for wifi, and enjoy wipri-list inside my wipri-eth0.service file to maintain a quasi-perm ethernet mac (you can make it change every boot if you like, or keep recognized spoofed macs, generated automatically for you)
I include an example wipri-eth0.service file for your convenience.
@ -40,7 +46,7 @@ The example wipri-eth0.service file can be edited to use commands to your liking
Once you are happy with the wipri related command flags and device name (eth0 in example for ethernet), you can then run following commands to activate the wipri-eth0.service file (to maintain quasi-perm mac address, or changing list at each boot for ethernet example)
Activate your wipri-eth0.service file (after running install.sh to install wipri):
Activating Example wipri-eth0.service File (after running install.sh installs wipri):
sudo cp wipri-eth0.service /etc/systemd/system
@ -51,11 +57,13 @@ Activate your wipri-eth0.service file (after running install.sh to install wipri
sudo systemctl start wipri-eth0.service (start newly added wipri ethernet service)
If something isn't clear on usage, maybe have questions about wipri-list, leave a comment, or email.
Something Not Clear?
Questions about wipri, wipri-list, leave a comment, Or, Send An Email: righttoprivacy[at]tutanota
---
#### Have great ideas you want to see? file an issue here, or contact me!
#### Have A Unique / Great Ideas You Want To See? file an issue here, or contact me!
---
@ -221,7 +229,7 @@ BRANDNEWTUBE: https://brandnewtube.com/@RightToPrivacy (NEW)
---
#### CONTACT / INQUIRY
#### CONTACT / INQURE
<righttoprivacy[at]tutanota.com>
---