Topics

#app #automation #bing-search #bot #inno-setup #microsoft-rewards #pyinstaller #pywebview #reward #rewards #selenium

Language breakdown

Python 68.7%

JavaScript 12.2%

CSS 9.5%

HTML 8.7%

Inno Setup 0.9%

▸ Files click to expand

README

AutoRewarder

Stars

Downloads

An advanced, set-and-forget automation tool for Microsoft Rewards (supporting both the legacy and new dashboards). AutoRewarder performs Bing searches for PC and mobile point collection, completes Daily Sets and More Activities, and uses mathematically driven, human-like input simulation (W3C Actions, Bezier curves, and smart scrolling).

Built with a robust Python/Selenium backend, it offers two modes of operation: a sleek HTML/CSS/JS frontend wrapped in a native window via pywebview, and a headless runner (CLI) for scheduled background runs and automation scripts. Packaged as an executable Windows app (via Inno Setup) for a seamless, plug-and-play experience.

Ready to start? Check out the complete USER GUIDE

Installation

Easy Way (Recommended): Download AutoRewarder-Setup.exe from the latest release and run it. The installer will verify all dependencies and install the app for you.

Portable Way: Download AutoRewarder.zip from the latest release and extract it to any folder (e.g., a USB drive). Run the executable. All your settings and profiles will be saved locally inside the config folder.

Note: Because the portable version is a single-file build, it may take a few seconds longer to start up compared to the installed version while it unpacks core components. Once open, it works at full speed.

Manual Way (Source): Clone this repo, create virtual environment, and run python AutoRewarder.py.

Screenshots & Demo

| Perform Searches | App Demo | | :---: | :---: | |||

| Daily Sets (New Dashboard) & Claim action | Tab Switching | | :---: | :---: | |||

View Legacy Dashboard Demo (click to expand)

| Daily Sets (Legacy Dashboard) | | :---: | ||

_{Demo is sped up for viewing purposes. Actual execution includes randomized delays and pauses to mimic human behavior.}

| Main Window & Account Management | Settings | | :---: | :---: | | | | | | |

| History | Statistics Dashboard | | :---: | :---: | | | |

Tech Stack

| Layer | Technology | |-------|------------| | Backend | Python 3.12, selenium, pywebview, pystray, Pillow | | Frontend | HTML, CSS, JavaScript | | Bridge | pywebview JS API (pywebview.api) | | Build | PyInstaller, Inno Setup |

System Requirements

OS: Windows 10 or later (installer), or Linux via source setup (no prebuilt executable)
Browser: Microsoft Edge (driver managed by Selenium Manager)
.NET Framework: 4.8 or higher (automatically checked by installer)
RAM: Minimum 512 MB (1 GB recommended)
Disk Space: ~100 MB

Features

User Experience & Interface:

Multi-account management (add, rename, delete, per-account profiles)
First Setup per account with a dedicated Edge profile
PC and Mobile query controls (0-130 / 0-99)
Optional hide-browser mode (headless UI toggle)
Close-to-tray behavior with a tray menu (reopen or exit)
Per-account scheduled runs (simple or advanced)
Start with Windows/Linux toggle (autostart)
Live terminal-like logs with update notifications (GitHub Releases)
Local history view per account (date, time, query, status)
Statistics dashboard: real scraped points balance, per-run earnings, lifetime activity counters, and a multi-account recap
Safe recovery for corrupted settings/history files
Detailed analytics window (lifetime counters, real balances, per-day activity charts)
Compact stats UI (total points and last run earnings card on main window)

Automation & Core Logic:

OS-level daily autostart (launches headless runs at per-account scheduled times)
Configurable run pacing (advanced scheduling with run duration and queries per hour)
Background WebDriver warmup at startup for faster execution
Human-like search behavior (typing delays, random pauses, smooth scrolling)
Mobile emulation for Rewards credit (iPhone UA and touch)
Uses real-world queries from assets/queries.json (8154 unique entries from google-trends dataset)
Randomized delays to reduce repetitive patterns
Optional tab switching between result categories (Images/Videos/News)
Natural mouse movement/clicking (W3C Actions)
Daily Set task collection (runs once per day, per account)
Separate browser profile per account
Smart dashboard selection (automatic detection and switching between legacy and new versions at runtime)

Developer & Code Quality:

Advanced documentation (comprehensive docstrings and detailed guides)
Strict code formatting and static type checking (Black, Flake8, MyPy)

Quick Start (For Users)

You do not need Python to use release builds.

Download AutoRewarder-Setup.exe from the latest release
Install and run the app
Add your first account and complete setup
Set PC/Mobile counts and start a run

Tip: Closing the main window sends AutoRewarder to the system tray. Use the tray icon to reopen the window or choose Exit to fully close the app.

For detailed guide, see USER_GUIDE.md

Development Setup (For Developers)

Clone the repository.
Create and activate a virtual environment.
Install dependencies.
Run the app.

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python AutoRewarder.py

CLI Usage

For users who prefer the terminal or want to integrate the bot into custom scripts, a headless runner is available. It is the same engine used by the Start with Windows setting. You can call AutoRewarder.py --headless or run AutoRewarder_CLI.py directly (arguments are the same).

Available CLI Arguments

These arguments can be combined. Without --account, it runs every enabled schedule sequentially.

Note: Headless mode is forced in the CLI and does not change the GUI Hide Browser preference.

Example CLI commands:

# Run every enabled schedule (same as autostart)
python AutoRewarder.py --headless
Run a single account once with overrides
python AutoRewarder.py --headless --account "Main" --pc 30 --mobile 20
Force a re-run the same day
python AutoRewarder.py --headless --account "Main" --pc 30 --force

Build & Distribution

Build EXE (for installer creation):

.\.venv\Scripts\python.exe -m PyInstaller --noconfirm --clean AutoRewarder.spec

Create Windows Installer:

"C:\Program Files (x86)\Inno Setup 6\iscc.exe" AutoRewarder.iss

Or use the Inno Setup IDE to open AutoRewarder.iss and compile it. Output: dist/AutoRewarder-Setup.exe

Project Structure

AutoRewarder/
├── gui/
│   ├── index.html             # Main window UI
│   ├── history.html           # History view UI
│   ├── history.css            # History view styling
│   ├── dashboard.html         # Statistics dashboard UI
│   ├── dashboard.css          # Statistics dashboard styling
│   ├── script.js              # Frontend logic and bridge calls
│   ├── settings.js            # Settings page logic and bridge calls
│   ├── styles.css             # App styling
│   └── normalize.css          # CSS reset
├── assets/
│   ├── icon.ico               # App icon
│   ├── queries.json           # Queries list (8154 unique queries)
│   └── screenshots/           # Screenshots and GIFs for documentation
├── src/
│   ├── init.py            # Python package initialization
│   ├── api.py                 # Centralizes all main operations (bridge API exposed to JS)
│   ├── config.py              # Configuration constants/platform and file paths
│   ├── utils.py               # Utility functions (human typing, update checks)
│   ├── accounts/              # Multi-account management
│   │   ├── manager.py         # Account CRUD + current account selection
│   │   ├── meta.py            # Per-account metadata (firstsetupdone, schedule)
│   │   └── settings.py        # App-wide settings (hide_browser, autostart)
│   ├── emulator/              # Selenium browser + human-like input
│   │   ├── driver.py          # Edge WebDriver setup
│   │   ├── human.py           # Human-like mouse / touch / scrolling
│   │   └── edge_policy.py     # Windows-only Edge auto-signin opt-out
│   ├── search/                # Bing query execution + history
│   │   ├── engine.py          # Search loop with human-like delays
│   │   └── history.py         # Per-account search history JSON
│   ├── dailytasks/            # Rewards daily-set + more-activities automation
│   │   ├── runner.py          # DailySet orchestrator + status persistence
│   │   ├── new_dashboard.py   # The New Dashboard support
│   │   ├── card.py            # RewardsCard: DOM checks + click + tab dance
│   │   └── card_js.py         # JS heuristics + CardStatus enum
│   └── stats/                 # Per-account statistics
│       └── manager.py         # StatsManager + points-balance scraper
├── AutoRewarder.py            # Python backend and webview window
├── AutoRewarder_CLI.py        # Headless runner (multi-account aware)
├── AutoRewarder.spec          # PyInstaller build spec
├── AutoRewarder.iss           # Inno Setup installer script
├── .pre-commit-config.yaml    # Pre-commit hooks configuration
├── requirements.txt           # Production dependencies
├── requirements-dev.txt       # Development & testing dependencies
├── LICENSE                    # MIT License
├── USER_GUIDE.md              # End-user documentation
└── README.md                  # Project overview and developer setup

Runtime Data

The application stores its runtime files (profiles, history, logs, and settings) in a dedicated folder separate from your main browser.

On Windows:

%USERPROFILE%\AppData\Local\AutoRewarder

On Linux:

~/.local/share/AutoRewarder

Created files and folders:

settings.json      # Global settings (hidebrowser, currentaccount_id, autoStartUp etc.) accounts.json      # Account index accounts/ 	<account_id>/ 		EdgeProfile/   # Separate Edge profile for WebDriver 		history.json   # Search history (date, time, query, status) 		status.json    # Daily Set completion status (per-day) 		stats.json     # Statistics: scraped points balance + activity counters 		meta.json      # Per-account metadata (firstsetupdone, schedule) background_log.txt # Logs from the background runner (for debugging)

Troubleshooting

For common issues and solutions, see the Troubleshooting section in the USER GUIDE.

Roadmap

[x] Windows installer with dependency checking (Inno Setup)
[x] Action Chains Selenium/W3C Actions for more natural mouse movement and clicks
[x] Daily Set collector
[x] Refactor: split monolith to src modules
[x] Update checks (GitHub Releases API)
[x] Better randomized scrolling (unique speed/length per session)
[x] Advanced "coffee" breaks during long sessions
[x] Navigation flow: sometimes switch result tabs (Images/Videos/News)
[x] Script-only version (CLI tool without GUI)
[x] Automatic start-up
[x] Query pacing over a specified duration (rate-based scheduling)
[x] Multi-account support (manage multiple Rewards accounts)
[x] Mobile support
[x] Per-Account Scheduling
[x] Brand New UI
[x] System tray (close-to-tray)
[x] Hide browser mode (headless UI)
[x] Statistics dashboard (points tracking, session summaries)
[x] Daily "Claim" actions
[x] The New Dashboard Support
[ ] Simulated human typos during search input
[ ] Region-specific search query datasets (US, UK, CA, AU, IN, etc.)
[ ] Browser choice (Chrome, Firefox support in addition to Edge)
[ ] Keyboard shortcuts