bitscuit 2d399a5325 | ||
---|---|---|
.gitignore | ||
LICENSE | ||
README.md | ||
main.py | ||
shammer |
README.md
Shammer
Shammer is a simple web crawler that generates internet requests to hide your real traffic.
Installation
Note: assuming your computer runs Ubuntu 18.04
Follow these steps to install Shammer of your machine:
- Clone the source code:
git clone https://git.bitscuit.be/bitscuit/Shammer.git
andcd Shammer
. - Install the dependencies:
pip3 install requests
. - Run the script to generate a default configuration file:
./shammer
. - Edit
config.json
with your favourite text editor and tweak the settings to your liking (see Configuration). - Run the script again to verify configuration:
./shammer
. - Create a
SystemD Unit
for Shammer:- Run
sudo vim /etc/systemd/system/shammer.service
and add the following text:[Unit] Description = Shammer internet traffic generator [Service] User=<username> ExecStart = /path/to/shammer/script [Install] WantedBy = multi-user.target
- Enable the service:
sudo systemctl enable shammer.service
- Start the service:
sudo systemctl start shammer.service
- Check if runs correctly:
service shammer status
- Run
- Shammer is now installed on your machine 🥳
Configuration
The configuration for Shammer is stored in the config.json
file in the project root directory. A default configuration is generated when running Shammer for the first time.
You must add all of the following attributes to config.json
:
INDEX_URL
: URL of the website Shammer needs to start at.MAX_CONTENT_LENGTH
: The maximum file size in bytes of a request. If theContent-Length
header is provided with the response, Shammer will only download the full page is this value is belowMAX_CONTENT_LENGTH
.REQUESTS_PER_MINUTE
: The average number of requests per minute. If set to0
, Shammer won't sleep between requests.HOUR_START
: The hour at which to start shamming.HOUR_END
: The hour at which to end shamming.
To reset the configuration back to the default settings, simply delete config.json
and run ./shammer
to create a new configuration file.
Contributing
Want to help develop Shammer? Awesome!
Feel free to fork this repository, add new features and submit a pull request. Thanks!
Disclaimer
Copyright 2021 Thomas Van Acker
This project is available under the GPLv3 license. This program comes with ABSOLUTELY NO WARRANTY.
I am not responsible for any damage that may be caused by this software. USE AT YOUR OWN RISK.