Awesome
<h1 align="center"> Partyloud </h1> <p align="center"> Get your privacy back<br> Generate fake web browsing and mitigate tracking </p> <div align="center"> <br /> <!-- made-with-bash --> <a href="https://www.gnu.org/software/bash/"> <img src="https://img.shields.io/badge/Made%20with-Bash-1f425f.svg" alt="made-with-bash" /> </a> <!-- CodeFactor --> <a href="https://www.codefactor.io/repository/github/realtho/partyloud"> <img src="https://www.codefactor.io/repository/github/realtho/partyloud/badge" alt="CodeFactor" /> </a> <!-- GitHub code size in bytes --> <a href="#"> <img src="https://img.shields.io/github/languages/code-size/realtho/PartyLoud.svg" alt="GitHub code size in bytes" /> </a> <br /> <!-- GitHub last commit --> <a href="#"> <img src="https://img.shields.io/github/last-commit/realtho/PartyLoud.svg" alt="Last commit" /> </a> <!-- License --> <a href="#"> <img src="https://img.shields.io/github/license/realtho/Partyloud.svg" alt="License" /> </a> <br /> <!-- License --> <a href="http://makeapullrequest.com"> <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" alt="PRs Welcome" /> </a> <br /> </div> <p align="center"> <br /> PartyLoud is a highly configurable and straightforward free tool that helps you prevent tracking directly from your linux terminal, no special skills required. Once started, you can forget it is running. It provides several flags; each flag lets you customize your experience and change PartyLoud behaviour according to your needs. <br /> <img src="https://i.imgur.com/cPO0X1U.png" alt="Screenshot" /> </p> <p align="center"> <b>Please <a href="https://github.com/realtho/PartyLoud/issues">submit bugs and feature requests</a> and help me to continuously improve this project.</b><br /> For questions / feedbacks please contact me <a href="https://twitter.com/realTHO2">Here</a><br /> <br /> </p>- Simple. 3 files only, no installation required, just clone this repo an you're ready to go.
- Powerful. Thread-based navigation.
- Stealthy. Optimized to emulate user navigation.
- Portable. You can use this script on every unix-based OS.
This project was inspired by noisy.py
๐ Changelog
โ๏ธ How It Works
- URLs and keywords are loaded (either from partyloud.conf and badwords or from user-defined files)
- If proxy flag has been used, proxy config will be tested
- For each URL in ULR-list a thread is started, each thread as an user agent associated
- Each thread will start by sending an HTTP request to the given URL
- The response if filtered using the keywords in order to prevent 404s and malformed URLs
- A new URL is choosen from the list generated after filering
- Current thread sleeps for a random time
- Actions from 4 to 7 are repeated using the new URL until user send kill signal (CTRL-C or enter key)
๐ Features
- Configurable urls list and blocklist
- Random DNS Mode : each request is done on a different DNS Server
- Multi-threaded request engine (# of thread are equal to # of urls in partyloud.conf)
- Error recovery mechanism to protect Engines from failures
- Spoofed User Agent prevent from fingerprinting (each engine has a different user agent)
- Dynamic UI
๐ Setup
Clone the repository:
git clone https://github.com/realtho/PartyLoud.git
Navigate to the directory and make the script executable:
cd PartyLoud
chmod +x partyloud.sh
Run 'partyloud':
./partyloud.sh
๐ Usage
Usage: ./partyloud.sh [options...]
-d --dns <file> DNS Servers are sourced from specified FILE,
each request will use a different DNS Server
in the list
!!WARNING THIS FEATURE IS EXPERIMENTAL!!
!!PLEASE LET ME KNOW ISSUES ON GITHUB !!
-l --url-list <file> read URL list from specified FILE
-b --blocklist <file> read blocklist from specified FILE
-p --http-proxy <http://ip:port> set a HTTP proxy
-s --https-proxy <https://ip:port> set a HTTPS proxy
-n --no-wait disable wait between one request and an other
-h --help dispaly this help
To stop the script press either enter or CRTL-C
ย โ ๏ธ File Specifications
<p align="center">
<b>In current release there is no input-validation on files.</b><br />
If you find bugs or have suggestions on how to improve this features please help me by opening issues on GitHub <br />
<br />
</p>
Intro
If you donโt have special needs , default config files are just fine to get you started.
Default files are located in:
Please note that file name and extension are not important, just content of files matter
badwords - Keywords-based blocklist
badwords is a keywords-based blocklist used to filter non-HTML content, images, document and so on.
The default config as been created after several weeks of testing. If you really think you need a custom blocklist, my suggestion is to start by copy and modifying default config according to your needs.
Here are some hints on how to create a great blocklist file:
DO โ | DONT ๐ซ |
---|---|
Use only ASCII chars | Define one-site-only rules |
Try to keep the rules as general as possible | Define case-sensitive rules |
Prefer relative path | Place more than one rule per line |
partyloud.conf - ULR List
partyloud.conf is a ULR List used as starting point for fake navigation generators.
The goal here is to create a good list of sites containing a lot of URLs.
Aside suggesting you not to use google, youtube and social networks related links, I've really no hints for you.
Note #1 - To work properly the URLs must be well-formed
Note #2 - Even if the file contains 1000 lines only 10 are used (first 10, working on randomness)
Note #3 - Only one URL per line is allowed
DNSList - DNS List
DNSList is a List of DNS used as argument for random DNS feature. Random DNS is not enable by default, so the โdefault fileโ is really just a guide line and a test used while developing the function to se if everything was working as expected.
The only suggestion here is to add as much address as possible to increase randomness.