Metadata-Version: 2.4
Name: auto-website-visitor
Version: 0.0.8
Summary: A CLI tool to automate website traffic using Selenium.
Author-email: nayandas69 <nayanchandradas@hotmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/nayandas69/auto-website-visitor
Project-URL: Bug Tracker, https://github.com/nayandas69/auto-website-visitor/issues
Project-URL: Documentation, https://github.com/nayandas69/auto-website-visitor#readme
Project-URL: Source Code, https://github.com/nayandas69/auto-website-visitor
Keywords: auto website visitor,website visitor,automation,selenium,selenium python,cli tool,website traffic,website automation,auto visits,traffic generator,auto bot
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 3.7
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: selenium>=4.10.0
Requires-Dist: colorama>=0.4.4
Requires-Dist: webdriver-manager>=3.8.0
Requires-Dist: requests>=2.25.1
Dynamic: license-file

# Auto Website Visitor (AWV)

**Auto Website Visitor** is a fun yet powerful tool that automates repeated visits to a given website using real browser automation via Selenium.  
It supports Chrome, Firefox, and Edge with additional features like human-like scrolling, proxy support, headless mode, and interval-based automation.

![Workflow Status](https://img.shields.io/github/actions/workflow/status/nayandas69/auto-website-visitor/buildpypi.yml?style=flat-square&color=4DB6AC&logo=github)
![Python Version](https://img.shields.io/pypi/pyversions/auto-website-visitor?style=flat-square&color=42A5F5&logo=python)
![PyPI Version](https://img.shields.io/pypi/v/auto-website-visitor?style=flat-square&color=00C853&logo=pypi)
![PyPI Downloads](https://static.pepy.tech/badge/auto-website-visitor)  

Perfect for testing, load simulation, SEO boosting, and more — all with a sprinkle of style and control.

> [!WARNING]
> This tool is for **educational and personal use only**. Do not use it for any malicious or unauthorized activity.

## Features

- [x] **Headless mode** support (silent, no UI)  
- [x] **Proxy support** (http/https)  
- [x] **Smart auto-scroll** to simulate real user behavior  
- [x] **Randomized behavior** like scroll direction, pauses, element focus    
- [x] **Logging**: Tracks visit logs with timestamps   
- [x] **Human-readable countdown timer** between visits    

## Installation

### Clone & Run from Source

```bash
git clone https://github.com/nayandas69/auto-website-visitor.git
cd auto-website-visitor
python3 -m venv .venv            # (Recommended)
source .venv/bin/activate
pip3 install -r requirements.txt
python3 awv.py
```

### OR Install via pip

```bash
pip install auto-website-visitor
```

Then run it from anywhere:

```bash
auto-website-visitor
```

### Browser Installation (Linux)

> [!WARNING]
> Make sure you have the latest version of your browser installed.
> AWV uses Selenium to control the browser, so it needs the browser to be installed on your system.
> If you have a different version of the browser, please check the [Selenium documentation](https://www.selenium.dev/documentation/webdriver/getting_started/install_drivers/) for compatibility.

## Supported Browsers

- [x] Google Chrome  
- [x] Mozilla Firefox  
- [x] Microsoft Edge  

#### Google Chrome
```bash
sudo apt update
sudo apt install wget -y
wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo apt install ./google-chrome-stable_current_amd64.deb -y
```

#### Mozilla Firefox
```bash
sudo apt update
sudo apt install firefox -y
```

#### Microsoft Edge
```bash
curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
sudo install -o root -g root -m 644 microsoft.gpg /usr/share/keyrings/
sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/edge stable main" > /etc/apt/sources.list.d/microsoft-edge.list'
sudo apt update
sudo apt install microsoft-edge-stable -y
```

> [!TIP] 
> You only need one browser installed to run the tool.
> Edge is mostly recommended on Windows. 
> For Linux, Chrome and Firefox work best.

## EXE, Linux Binary & .deb package

> [!WARNING]
> Check the **latest release assets** section to download the ready-to-use files.

### For Windows

- Download `awv.exe` from the release
- Double click to launch
- Follow on-screen prompts

### For Linux

```bash
tar -xvzf awv-linux.tar.gz
sudo chmod +x awv
./awv
```

### For Debain-based Linux

```bash
sudo dpkg -i auto-website-visitor_<version>_amd64.deb
```
> Replace `<version>` with the actual version number of the downloaded package.
> This also adds the `awv` command globally on your system.

## Visit Our AWV Web Portal

Check it out here only for latest updates version:  
[Click](https://nayandas69.github.io/auto-website-visitor)

> [!TIP]
> Use **headless mode** if you want background visits.
> Always keep **visit interval above 10s** when using auto-scroll.
> Add proxies for more anonymity.
> Set infinite visits with `0` for endless loops.

## How to Use (Menu Breakdown)

Once you launch AWV, you’ll see:

```
1. Start             → Start visiting a website
2. Check for Updates → Check for new releases
3. Help              → Read what it can do
4. Exit              → Close the app
```

### Start Menu Options

- Website URL  
- Number of visits (`0` = infinite)  
- Interval between visits  
- Browser of choice  
- Proxy support  
- Headless mode  
- Enable auto-scroll  

---

## Tested Platforms

- [x] Windows 11  
- [x] Kali Linux  

## Future Planned & Current Features

- [x] Human-like scrolling  
- [x] Smart pause simulation  
- [x] Proxy rotation  
- [x] Multi-browser support  
- [x] Update checker   
- [ ] Customizable user-agent
- [ ] More browser support (Safari, Opera, etc.)
- [ ] More proxy types (SOCKS, etc.)

## Contribute

Got ideas or improvements?  
Pull requests, issues, or even a star ⭐ are always welcome!

## Author

- **Nayan Das**  
- [Website](https://nayandas69.github.io/link-in-bio)  
- nayanchandradas@hotmail.com  

## Disclaimer

> [!WARNING]
> This tool is strictly for **educational purposes**, testing, and personal experimentation.  
> The developer is not responsible for any misuse. Always comply with website terms and local laws.
