LightZirconite/Microsoft-Rewards-Script
1
0
Fork 0
mirror of https://github.com/TheNetsky/Microsoft-Rewards-Script.git synced 2026-01-11 02:46:17 +00:00
Code Issues Packages Projects Releases Wiki Activity

Revise README for setup and features clarity

Browse Source 
Updated README with detailed setup instructions and features overview.
This commit is contained in:
Netsky
2025-11-11 11:12:30 +01:00
committed by GitHub
parent 624f5a32e1
commit 649cf28ad9
1 changed files with 305 additions and 164 deletions
Download Patch File Download Diff File Expand all files Collapse all files

443
README.md
View File

@@ -1,209 +1,350 @@
[![Discord](https://img.shields.io/badge/Join%20Our%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/8BxYbV4pkj) [![Discord](https://img.shields.io/badge/Join%20Our%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/8BxYbV4pkj)
# Quick Setup (Recommended)
**Easiest way to get started — download and run:**
1. **Clone the branch** or download the zip.
2. **Run the setup script:**
* **Windows:** double-click `setup/setup.bat` or run it from a command prompt
* **Linux / macOS / WSL:**
```bash
bash setup/setup.sh
```
* **Alternative (any platform):**
```bash
npm run setup
```
3. **Follow the setup prompts.** The script will:
* Rename `accounts.example.json` → `accounts.json`
* Ask for Microsoft account credentials
* Remind you to review `config.json`
* Install dependencies (`npm install`)
* Build the project (`npm run build`)
* Optionally start the script
**That's it — the setup script handles the rest.**
--- ---
# Advanced Setup Options ## Table of Contents
- [Setup](#setup)
- [1. Clone the Repository](#1-clone-the-repository)
- [2. Copy Configuration Files](#2-copy-configuration-files)
- [3. Install Dependencies and Prepare the Browser](#3-install-dependencies-and-prepare-the-browser)
- [4. Build and Run](#4-build-and-run)
- [Nix Users](#nix-setup)
- [Docker Setup](#docker-setup)
- [Before Starting](#before-starting)
- [Quick Start](#quick-start)
- [Example compose.yaml](#example-composeyaml)
- [Configuration Reference](#configuration-reference)
- [Account Configuration](#account-configuration)
- [Features Overview](#features-overview)
- [Disclaimer](#disclaimer)
### Nix Users ---
1. Install Nix from [https://nixos.org/](https://nixos.org/) ## Setup
2. Run:
**Requirements:** Node.js ≥ 20 and Git
Works on Windows, Linux, macOS, and WSL.
---
### 1. Clone the Repository
**All systems:**
```bash ```bash
./run.sh git clone https://github.com/TheNetsky/Microsoft-Rewards-Script.git
cd Microsoft-Rewards-Script
```
Or download the latest release ZIP and extract it.
---
### 2. Copy Configuration Files
**Windows:**
Rename manually:
```
src/accounts.example.json → src/accounts.json
``` ```
### Manual Setup (if setup script fails) **Linux / macOS / WSL:**
1. Copy `src/accounts.example.json` → `src/accounts.json` and add accounts.
2. Edit `src/config.json` as needed.
3. Install dependencies:
```bash ```bash
npm install cp src/accounts.example.json src/accounts.json
``` ```
4. Build: Then edit:
- `src/accounts.json` — fill in your Microsoft account credentials.
- `src/config.json` — review or customize options.
---
### 3. Install Dependencies and Prepare the Browser
**All systems:**
```bash
npm run pre-build
```
This command:
- Installs all dependencies
- Clears old builds (`dist/`)
- Installs Playwright Chromium (required browser)
---
### 4. Build and Run
**All systems:**
```bash ```bash
npm run build npm run build
```
5. Start:
```bash
npm run start npm run start
``` ```
--- ---
# Docker Setup (Experimental) ## Nix Setup
**Before starting** If using Nix:
```bash
./run.sh
```
* Remove local `/node_modules` and `/dist` if you previously built. The script will:
* Remove old Docker volumes when upgrading from v1.4 or earlier. - Run `npm run pre-build` to install dependencies and Chromium
* You can reuse older `accounts.json`. - Then start the script headlessly using `xvfb-run`
**Quick Docker (recommended for scheduling)** ---
1. Clone v2 and configure `accounts.json`. ## Docker Setup
### Before Starting
- Remove local `/node_modules` and `/dist` if previously built.
- Remove old Docker volumes if upgrading from older versions.
- You can reuse your existing `accounts.json`.
---
### Quick Start
1. Clone the repository and configure your `accounts.json`.
2. Ensure `config.json` has `"headless": true`. 2. Ensure `config.json` has `"headless": true`.
3. Edit `compose.yaml`: 3. Edit `compose.yaml`:
- Set your timezone (`TZ`)
- Set the cron schedule (`CRON_SCHEDULE`)
- Optionally enable `RUN_ON_START=true`
4. Start the container:
```bash
docker compose up -d
```
5. Monitor logs:
```bash
docker logs microsoft-rewards-script
```
* Set `TZ` (timezone) The container includes a randomized delay (about 5–50 minutes by default)
* Set `CRON_SCHEDULE` (use crontab.guru for help) before each scheduled run to appear more natural. This can be configured or disabled via environment variables.
* Optional: `RUN_ON_START=true`
4. Start:
```bash
docker compose up -d
```
5. Monitor:
```bash
docker logs microsoft-rewards-script
```
> The container randomly delays scheduled runs by ~5–50 minutes to appear more natural.
--- ---
# Usage Notes ### Example compose.yaml
* **Headless=false cleanup:** If you stop the script without closing browser windows, use Task Manager / `npm run kill-chrome-win` to close leftover instances. ```yaml
* **Scheduling advice:** Run at least twice daily. Use `"runOnZeroPoints": false` in config to skip runs with no points. services:
* **Multiple accounts:** Use `clusters` in `config.json` to run accounts in parallel. microsoft-rewards-script:
image: ghcr.io/your-org/microsoft-rewards-script:latest
container_name: microsoft-rewards-script
restart: unless-stopped
volumes:
- ./src/accounts.json:/usr/src/microsoft-rewards-script/dist/accounts.json:ro
- ./src/config.json:/usr/src/microsoft-rewards-script/dist/config.json:ro
- ./sessions:/usr/src/microsoft-rewards-script/dist/sessions
# - ./jobstate:/usr/src/microsoft-rewards-script/dist/jobstate
environment:
TZ: "Europe/Amsterdam"
NODE_ENV: "production"
CRON_SCHEDULE: "0 7,16,20 * * *"
RUN_ON_START: "true"
# MIN_SLEEP_MINUTES: "5"
# MAX_SLEEP_MINUTES: "50"
# SKIP_RANDOM: "true"
deploy:
resources:
limits:
cpus: "1.0"
memory: "1g"
```
#### compose.yaml Notes
- **volumes**
- `accounts.json` and `config.json` are mounted read-only to prevent accidental edits.
- `sessions` persists login sessions and fingerprints across runs.
- If `jobState.enabled` is used, mount its directory as a volume.
- **CRON_SCHEDULE**
- Uses standard crontab syntax (e.g., via [crontab.guru](https://crontab.guru/)).
- Schedule is evaluated inside the container using the configured `TZ`.
- **RUN_ON_START**
- Runs the script once immediately on startup, then continues on schedule.
- **Randomization**
- Default delay: 5–50 minutes.
- Adjustable via `MIN_SLEEP_MINUTES` and `MAX_SLEEP_MINUTES`, or disable with `SKIP_RANDOM`.
--- ---
# Configuration Reference ## Configuration Reference
Edit `src/config.json` to customize behavior. Edit `src/config.json` to customize behavior.
Below is a summary of key configuration sections.
### Core Settings (examples) ### Core
| Setting | Description | Default | | Setting | Description | Default |
| ----------------- | -------------------------------: | -------------------------: | |----------|-------------|----------|
| `baseURL` | Microsoft Rewards URL | `https://rewards.bing.com` | | `baseURL` | Microsoft Rewards base URL | `https://rewards.bing.com` |
| `sessionPath` | Session/fingerprint storage | `sessions` | | `sessionPath` | Folder to store browser sessions | `sessions` |
| `headless` | Run browser in background | `false` | | `dryRun` | Simulate execution without running tasks | `false` |
| `parallel` | Run mobile/desktop tasks at once | `true` |
| `runOnZeroPoints` | Run when no points available | `false` |
| `clusters` | Concurrent account instances | `1` |
### Fingerprint Settings
### Browser
| Setting | Description | Default | | Setting | Description | Default |
| ------------------------- | ------------------------: | ------: | |----------|-------------|----------|
| `saveFingerprint.mobile` | Reuse mobile fingerprint | `false` | | `browser.headless` | Run browser invisibly | `false` |
| `saveFingerprint.desktop` | Reuse desktop fingerprint | `false` | | `browser.globalTimeout` | Timeout for actions | `"30s"` |
### Task Settings (important ones)
### Fingerprinting
| Setting | Description | Default | | Setting | Description | Default |
| -------------------------- | -----------------: | ------: | |----------|-------------|----------|
| `workers.doDailySet` | Do daily set | `true` | | `fingerprinting.saveFingerprint.mobile` | Reuse mobile fingerprint | `true` |
| `workers.doMorePromotions` | Promotional offers | `true` | | `fingerprinting.saveFingerprint.desktop` | Reuse desktop fingerprint | `true` |
| `workers.doPunchCards` | Punchcard tasks | `true` |
| `workers.doDesktopSearch` | Desktop searches | `true` |
| `workers.doMobileSearch` | Mobile searches | `true` |
| `workers.doDailyCheckIn` | Daily check-in | `true` |
| `workers.doReadToEarn` | Read-to-earn | `true` |
### Search Settings
### Execution
| Setting | Description | Default | | Setting | Description | Default |
| ---------------------------------------- | ---------------------: | ------------: | |----------|-------------|----------|
| `searchOnBingLocalQueries` | Use local queries | `false` | | `execution.parallel` | Run desktop and mobile simultaneously | `false` |
| `searchSettings.useGeoLocaleQueries` | Geo-based queries | `false` | | `execution.runOnZeroPoints` | Run even with zero points | `false` |
| `searchSettings.scrollRandomResults` | Random scrolling | `true` | | `execution.clusters` | Number of concurrent account clusters | `1` |
| `searchSettings.clickRandomResults` | Random link clicks | `true` |
| `searchSettings.searchDelay` | Delay between searches | `3-5 minutes` |
| `searchSettings.retryMobileSearchAmount` | Mobile retry attempts | `2` |
### Advanced Settings
### Job State
| Setting | Description | Default | | Setting | Description | Default |
| ------------------------- | --------------------------: | ------------------: | |----------|-------------|----------|
| `globalTimeout` | Action timeout | `30s` | | `jobState.enabled` | Save last job state | `true` |
| `logExcludeFunc` | Exclude functions from logs | `SEARCH-CLOSE-TABS` | | `jobState.dir` | Directory for job data | `""` |
| `proxy.proxyGoogleTrends` | Proxy Google Trends | `true` |
| `proxy.proxyBingTerms` | Proxy Bing Terms | `true` |
### Webhook Settings
### Workers (Tasks)
| Setting | Description | Default | | Setting | Description | Default |
| --------------------------- | ---------------------------: | ------: | |----------|-------------|----------|
| `webhook.enabled` | Enable Discord notifications | `false` | | `doDailySet` | Complete daily set | `true` |
| `webhook.url` | Discord webhook URL | `null` | | `doMorePromotions` | Complete more promotions | `true` |
| `conclusionWebhook.enabled` | Summary-only webhook | `false` | | `doPunchCards` | Complete punchcards | `true` |
| `conclusionWebhook.url` | Summary webhook URL | `null` | | `doDesktopSearch` | Perform desktop searches | `true` |
| `doMobileSearch` | Perform mobile searches | `true` |
| `doDailyCheckIn` | Complete daily check-in | `true` |
| `doReadToEarn` | Complete Read-to-Earn | `true` |
| `bundleDailySetWithSearch` | Combine daily set and searches | `true` |
### Search
| Setting | Description | Default |
|----------|-------------|----------|
| `search.useLocalQueries` | Use local query list | `true` |
| `search.settings.useGeoLocaleQueries` | Use region-based queries | `true` |
| `search.settings.scrollRandomResults` | Random scrolling | `true` |
| `search.settings.clickRandomResults` | Random link clicking | `true` |
| `search.settings.retryMobileSearchAmount` | Retry mobile searches | `2` |
| `search.settings.delay.min` | Minimum delay between searches | `1min` |
| `search.settings.delay.max` | Maximum delay between searches | `5min` |
### Query Diversity
| Setting | Description | Default |
|----------|-------------|----------|
| `queryDiversity.enabled` | Enable multiple query sources | `true` |
| `queryDiversity.sources` | Query providers | `["google-trends", "reddit", "local-fallback"]` |
| `queryDiversity.maxQueriesPerSource` | Limit per source | `10` |
| `queryDiversity.cacheMinutes` | Cache lifetime | `30` |
### Humanization
| Setting | Description | Default |
|----------|-------------|----------|
| `humanization.enabled` | Enable human behavior | `true` |
| `stopOnBan` | Stop immediately on ban | `true` |
| `immediateBanAlert` | Alert instantly if banned | `true` |
| `actionDelay.min` | Minimum delay per action (ms) | `500` |
| `actionDelay.max` | Maximum delay per action (ms) | `2200` |
| `gestureMoveProb` | Chance of random mouse movement | `0.65` |
| `gestureScrollProb` | Chance of random scrolls | `0.4` |
### Vacation Mode
| Setting | Description | Default |
|----------|-------------|----------|
| `vacation.enabled` | Enable random pauses | `true` |
| `minDays` | Minimum days off | `2` |
| `maxDays` | Maximum days off | `4` |
### Risk Management
| Setting | Description | Default |
|----------|-------------|----------|
| `enabled` | Enable risk-based adjustments | `true` |
| `autoAdjustDelays` | Adapt delays dynamically | `true` |
| `stopOnCritical` | Stop on critical warning | `false` |
| `banPrediction` | Predict bans based on signals | `true` |
| `riskThreshold` | Risk tolerance level | `75` |
### Retry Policy
| Setting | Description | Default |
|----------|-------------|----------|
| `maxAttempts` | Maximum retry attempts | `3` |
| `baseDelay` | Initial retry delay | `1000` |
| `maxDelay` | Maximum retry delay | `30s` |
| `multiplier` | Backoff multiplier | `2` |
| `jitter` | Random jitter factor | `0.2` |
### Proxy
| Setting | Description | Default |
|----------|-------------|----------|
| `proxy.proxyGoogleTrends` | Proxy Google Trends requests | `true` |
| `proxy.proxyBingTerms` | Proxy Bing terms requests | `true` |
### Notifications
| Setting | Description | Default |
|----------|-------------|----------|
| `notifications.webhook.enabled` | Enable Discord webhook | `false` |
| `notifications.webhook.url` | Discord webhook URL | `""` |
| `notifications.conclusionWebhook.enabled` | Enable summary webhook | `false` |
| `notifications.conclusionWebhook.url` | Summary webhook URL | `""` |
| `notifications.ntfy.enabled` | Enable Ntfy push alerts | `false` |
| `notifications.ntfy.url` | Ntfy server URL | `""` |
| `notifications.ntfy.topic` | Ntfy topic name | `"rewards"` |
### Logging
| Setting | Description | Default |
|----------|-------------|----------|
| `excludeFunc` | Exclude from console logs | `["SEARCH-CLOSE-TABS", "LOGIN-NO-PROMPT", "FLOW"]` |
| `webhookExcludeFunc` | Exclude from webhook logs | `["SEARCH-CLOSE-TABS", "LOGIN-NO-PROMPT", "FLOW"]` |
| `redactEmails` | Hide emails in logs | `true` |
--- ---
# Features ## Account Configuration
**Account & Session** Edit `src/accounts.json`:
* Multi-account support ```json
* Persistent sessions & fingerprints {
* 2FA support & passwordless options "accounts": [
{
**Automation** "enabled": true,
"email": "email_1@outlook.com",
* Headless operation & clustering "password": "password_1",
* Selectable task sets "totp": "",
* Proxy support & scheduling (Docker) "recoveryEmail": "your_email@domain.com",
"proxy": {
**Search & Rewards** "proxyAxios": true,
"url": "",
* Desktop & mobile searches "port": 0,
* Emulated browsing, scrolling, clicks "username": "",
* Daily sets, promotions, punchcards, quizzes "password": ""
}
**Interactions** }
]
* Quiz solving (10 & 30–40 point variants) }
* Polls, ABC quizzes, “This or That” answers ```
**Notifications**
* Discord webhooks and summary webhooks
* Extensive logs for debugging
--- ---
# Disclaimer ## Features Overview
**Use at your own risk.** Automation may cause suspension or banning of Microsoft Rewards accounts. This project is provided for educational purposes only. The maintainers are **not** responsible for account actions taken by Microsoft. - Multi-account and session handling
- Persistent browser fingerprints
- Parallel task execution
- Proxy and retry support
- Human-like behavior simulation
- Full daily set automation
- Mobile and desktop search support
- Vacation and risk protection
- Webhook and Ntfy notifications
- Docker scheduling support
---
## Disclaimer
Use at your own risk.
Automation of Microsoft Rewards may lead to account suspension or bans.
This software is provided for educational purposes only.
The authors are not responsible for any actions taken by Microsoft.