mirror of https://github.com/LightZirconite/Microsoft-Rewards-Bot.git synced 2026-01-09 09:06:15 +00:00

Files

2025-11-15 13:52:37 +01:00

33 KiB

Raw Blame History

🚀 Getting Started# 🚀 Getting Started# 🚀 Getting Started Guide

Complete guide to set up and run Microsoft Rewards Bot****Complete step-by-step guide to set up and run Microsoft Rewards Bot

From zero to earning points in 10 minutes

← Back to Documentation ← Back to DocumentationComplete step-by-step tutorial to set up and run Microsoft Rewards Bot.

📋 Table of Contents

Requirements## 📋 Table of Contents---# 🚀 Getting Started
Installation
Account Setup
Configuration
First Run1. Prerequisites
Next Steps
Troubleshooting2. Get the Project

---3. Create Accounts## 📋 Table of Contents**🎯 From zero to earning Microsoft Rewards points in minutes**

✅ Requirements4. Configuration

Before starting, you need:5. First RunComplete setup guide for beginners

1. Node.js 20 or Higher6. What's Next

Download: https://nodejs.org/ (get the LTS version)1. Prerequisites

Verify installation:


node --version

```2. [Get the Project](#-get-the-project)</div>

Should show `v20.x.x` or `v22.x.x`

✅ Prerequisites

2. Microsoft Accounts

Create Microsoft Accounts

At least one Microsoft account (Outlook/Hotmail email)
If you don't have one, see Creating New AccountsBefore starting, you need:

3. Git (Optional)4. Configuration---

Download: https://git-scm.com/### 1. Node.js 20 or Higher
Alternative: Download project as ZIP from GitHub

First Run

Download: https://nodejs.org/

📦 Installation

Recommended: Version 226. Troubleshooting## ✅ Requirements

Option 1: Git Clone (Recommended)

Verify installation:


git clone https://github.com/LightZirconite/Microsoft-Rewards-Bot.git  ```bash

cd Microsoft-Rewards-Bot

npm install  node --version


### Option 2: Download ZIP

Should show `v20.x.x` or higher

1. Go to: https://github.com/LightZirconite/Microsoft-Rewards-Bot

2. Click **Code** → **Download ZIP**- **Microsoft accounts** with email + password

3. Extract the ZIP file

4. Open a terminal in the extracted folder### 2. Git (Optional but Recommended)

5. Run: `npm install`

## ✅ Prerequisites- **Optional:** Docker for containerized deployment

**Installation takes 2-3 minutes** to download dependencies.

- **Download:** https://git-scm.com/

---

- **Alternative:** Download project as ZIP from GitHub

## 🎯 Account Setup



You have **two options** for setting up accounts:

### 3. Your Referral LinkBefore starting, you need:---

### Option A: Setup Wizard (Easiest)



Run the interactive setup wizard:

**💰 Important: You earn 7,500 points per month for each account you refer!**

```bash

# Windows

setup\setup.bat

1. Log into your **main Microsoft account**1. **Node.js 20+** (version 22 recommended)## ⚡ Quick Setup (Recommended)

# Linux/Mac/WSL

bash setup/setup.sh2. Go to: https://rewards.bing.com/referandearn/



# Or via npm3. Copy your referral link (format: `https://rewards.bing.com/welcome?rh=XXXXX`)   - Download: https://nodejs.org/

npm run setup

The wizard will:--- - Verify: node --version should show v20 or higher

✅ Create src/accounts.jsonc from template
✅ Guide you through adding your Microsoft account(s)
✅ Build the TypeScript project
✅ Verify everything works## 📦 Get the Project

Option B: Manual Setup

Copy the template:### Option 1: Git Clone (Recommended)2. Git (optional, but recommended)### 🎬 One Command, Total Automation


# Windows

copy src\accounts.example.jsonc src\accounts.jsonc

```bash   - Download: https://git-scm.com/

# Linux/Mac

cp src/accounts.example.jsonc src/accounts.jsoncgit clone https://github.com/LightZirconite/Microsoft-Rewards-Bot.git


cd Microsoft-Rewards-Bot   - Or download project as ZIP</div>

2. **Edit `src/accounts.jsonc`:**

```jsonc```

{

  "accounts": [

    {

      "email": "your@email.com",### Option 2: Download ZIP

      "password": "your_password",

      "recoveryEmail": "backup@gmail.com",  // Optional but recommended3. **A main Microsoft account** (your personal account)```bash

      "totp": "",                            // Leave empty for now

      "enabled": true1. Visit: https://github.com/LightZirconite/Microsoft-Rewards-Bot

    }

  ]2. Click **Code** → **Download ZIP**   - Go to https://rewards.bing.com/referandearn/# 🪟 Windows

}

```3. Extract the ZIP file



3. **Build the project:**4. Open a terminal in the extracted folder   - Copy your referral link (looks like: `https://rewards.bing.com/welcome?rh=XXXX`)setup/setup.bat

```bash

npm run build

Install Dependencies - Why? You earn 7,500 points per month for each referral!

📖 Need 2FA/TOTP? See Accounts & 2FA Guide for detailed setup.


## 🆕 Creating New Accounts (Bonus)

npm i

**💰 Important:** You earn **7,500 bonus points per month** for each account created with your referral link!

```---bash setup/setup.sh

### Step 1: Get Your Referral Link



1. Log into your **main Microsoft account**

2. Go to: https://rewards.bing.com/referandearn/This installs all required packages (~2-3 minutes).

3. Copy your referral URL (format: `https://rewards.bing.com/welcome?rh=XXXXX`)



### Step 2: Create Account with Bot

---## 📦 Get the Project# 🌍 Any platform

**Recommended command** (full automation with 2FA):



```bash

npm run creator https://rewards.bing.com/welcome?rh=YOUR_CODE -y backup@gmail.com## 🎯 Create Accountsnpm run setup

Replace:

YOUR_CODE → Your actual referral code### Why Use the Account Creator?### Option 1: Git Clone (Recommended)```
backup@gmail.com → Your real recovery email

What this does:

✅ Creates realistic Microsoft account (email, password, name, birthdate)- ✅ Earn 7,500 bonus points per month per referral
✅ Enrolls in Microsoft Rewards using YOUR referral
✅ Adds recovery email for account security- ✅ Creates realistic accounts (avoids detection)
✅ Enables 2FA with TOTP (Google Authenticator)
✅ Saves everything to accounts-created/ folder- ✅ Automatic enrollment in Microsoft Rewards```bashThat's it! The wizard will:

Step 3: Complete CAPTCHA- ✅ Built-in 2FA security with TOTP

During creation:- ✅ Saves all account details for yougit clone https://github.com/LightZirconite/Microsoft-Rewards-Bot.git- ✅ Help you create src/accounts.json with your Microsoft credentials

CAPTCHA: Browser will pause - solve it manually
Recovery Email: Check your email, enter the 6-digit code
2FA Setup: Scan QR code with Google Authenticator app
Done: Account details saved automatically!### Step 1: Get Your Referral Linkcd Microsoft-Rewards-Bot- ✅ Install all dependencies automatically

Step 4: Find Your Account Info

After creation, find the file in:If you haven't already:```- ✅ Build the TypeScript project


accounts-created/account_USERNAME_TIMESTAMP.jsonc1. Log into your main Microsoft account

Visit: https://rewards.bing.com/referandearn/- ✅ Start earning points immediately

Example content:


{

  "email": "john.smith1995@outlook.com",### Option 2: Download ZIP

  "password": "Xyz789!@#AbcDef",

  "firstName": "John",### Step 2: Create Account

  "lastName": "Smith",

  "birthdate": {---

    "day": 15,

    "month": 6,**Recommended command (full automation):**

    "year": 1995

  },1. Go to: https://github.com/LightZirconite/Microsoft-Rewards-Bot

  "referralUrl": "https://rewards.bing.com/welcome?rh=YOUR_CODE",

  "recoveryEmail": "backup@gmail.com",```bash

  "totpSecret": "JBSWY3DPEHPK3PXP",

  "recoveryCode": "MWGR3-9MJC9-STK76-SZCE5-X77PR"npm run creator https://rewards.bing.com/welcome?rh=YOUR_CODE -y backup@gmail.com2. Click **Code** → **Download ZIP**## 🛠️ Manual Setup

}

**⚠️ KEEP THIS FILE SAFE!**3. Extract the ZIP file

totpSecret → Required for bot login (2FA)
recoveryCode → Emergency account recoveryReplace:
birthdate → Needed if account gets suspended
YOUR_CODE → Your actual referral code4. Open terminal in the extracted folder

📖 More details: Account Creator Full Guide

backup@gmail.com → Your real recovery email

📖 Prefer step-by-step? Click here

⚙️ Configuration

What this does:

The bot works great with default settings, but you can customize it:

Creates realistic Microsoft account (email, password, name, birthdate)### Install Dependencies

Essential Settings

Enrolls in Microsoft Rewards using YOUR referral

Open src/config.jsonc and review these:

Adds recovery email for account security### 1️⃣ Configure Your Accounts


{4. Enables 2FA with TOTP (Google Authenticator)

  "humanization": {

    "enabled": true,        // ⚠️ ALWAYS keep this true!5. Saves everything to `accounts-created/` folder```bash```bash

    "stopOnBan": true       // Stop if ban detected

  },

  "workers": {

    "doDesktopSearch": true,  // Desktop Bing searches### Step 3: Complete CAPTCHA & Verificationnpm icp src/accounts.example.json src/accounts.json

    "doMobileSearch": true,   // Mobile Bing searches

    "doDailySet": true,       // Daily activities

    "doMorePromotions": true, // Promotional offers

    "doPunchCards": true      // Multi-day challengesDuring creation:```# Edit accounts.json with your Microsoft credentials

  }

}

CAPTCHA: Browser will pause - solve it manually (required by Microsoft)```

Optional: Enable Scheduling

Recovery Email: Check your email, enter the 6-digit code

For automatic daily runs:

2FA Setup: This will install all required packages.


{   - Open Google Authenticator app on your phone

  "scheduling": {

    "enabled": true,   - Scan the QR code shown in browser### 2️⃣ **Install Dependencies & Build**

    "type": "auto",

    "cron": {   - Enter the 6-digit code from the app

      "schedule": "0 9 * * *"  // Daily at 9 AM (Linux/Mac/Raspberry Pi)

    },4. **Done**: Account saved automatically!---```bash

    "taskScheduler": {

      "schedule": "09:00"      // Daily at 9:00 (Windows)

    }

  }### Step 4: Find Your Account Infonpm install

}

**How it works:**After creation, a file is created in:## 🎯 Create Microsoft Accountsnpm run build

Run npm start once
Bot automatically schedules itself```
Runs every day at your chosen time
Perfect for Raspberry Pi!accounts-created/account_USERNAME_TIMESTAMP.jsonc```

📖 More options: Configuration Guide | Scheduling Guide```

---⚠️ IMPORTANT: Use the account creator with YOUR referral link to earn 7,500 points per account per month!

🎮 First RunExample content:

Manual Run```jsonc### 3️⃣ Choose Your Mode


npm start

```  "email": "john.smith1995@outlook.com",### Step 1: Get Your Referral Link```bash



**What happens:**  "password": "Xyz789!@#AbcDef",

1. Bot logs into each enabled account

2. Completes desktop searches (~30 searches)  "birthdate": {# Single run (test it works)

3. Completes mobile searches (~20 searches)

4. Does daily activities (quizzes, polls)    "day": 15,

5. Completes promotional offers

6. Shows summary of points earned    "month": 6,1. Log into your **main Microsoft account**npm start



### With Scheduling    "year": 1995



If you enabled scheduling:  },2. Go to: https://rewards.bing.com/referandearn/

```bash

npm start  "firstName": "John",

"lastName": "Smith",3. Copy your referral link (format: https://rewards.bing.com/welcome?rh=YOUR_CODE)# Schedule it (Task Scheduler, cron, etc.)

The bot will:

Run immediately once "createdAt": "2025-11-09T10:30:00.000Z",
Automatically schedule future runs (daily)
No need to run manually again! "referralUrl": "https://rewards.bing.com/welcome?rh=YOUR_CODE",# See docs/schedule.md for examples

--- "recoveryEmail": "backup@gmail.com",

🔧 Next Steps "totpSecret": "JBSWY3DPEHPK3PXP",### Step 2: Create Accounts```

Now that you're set up, explore these features: "recoveryCode": "MWGR3-9MJC9-STK76-SZCE5-X77PR"

High Priority}

| Guide | Why Important |```

|-------|---------------|

| Accounts & 2FA | Set up TOTP for secure automation |Recommended command (enables everything):

| Scheduling | Automate with Task Scheduler or cron |

⚠️ KEEP THIS FILE SAFE!

Medium Priority

totpSecret → Required for bot login (2FA)

| Guide | Why Useful |

|-------|------------|- recoveryCode → Emergency account recovery

| Notifications | Get alerts on your phone |

| Dashboard | Monitor accounts in real-time |- birthdate → Needed if account gets suspended```bash---

Optional- All info → Needed to restore account if banned

| Guide | When Needed |npm run creator https://rewards.bing.com/welcome?rh=YOUR_CODE -y backup@gmail.com

|-------|-------------|

| Proxy Setup | Enhanced privacy |### Alternative: Without 2FA (Not Recommended)

| Docker | Containerized deployment |


---

If you don't want 2FA:

## ❓ Troubleshooting



### "Account credentials are invalid"

```bash

**Problem**: Wrong email/password or missing TOTP

npm run creator https://rewards.bing.com/welcome?rh=YOUR_CODE**Replace:**The script will automatically:

**Solution**:

1. Check `src/accounts.jsonc` has correct credentials```

2. If 2FA enabled, make sure `totp` field has the secret

3. Test login manually: https://login.live.com/- `YOUR_CODE` with your actual referral code- 🔍 **Search Bing** for points (desktop + mobile)



### "Ban detected" or "Account suspended"Then answer "n" when asked about 2FA setup.



**Problem**: Microsoft detected automation- `backup@gmail.com` with your real recovery email- 📅 **Complete daily sets** (quizzes, polls, activities)  



**Solutions**:---

- ✅ Always keep `humanization.enabled: true`

- ✅ Don't run bot multiple times per day- 🎁 **Grab promotions** and bonus opportunities

- ✅ Use proxies (see [Proxy Guide](proxy.md))

- ✅ Start with 1-2 accounts to test## ⚙️ Configuration



**Account Recovery**:**What this does:**- 🃏 **Work on punch cards** (multi-day challenges)

- Use `birthdate` from `accounts-created/` file

- Use `recoveryCode` if you can't login### Step 1: Setup Accounts File



### "Browser launch failed"1. ✅ Creates a realistic Microsoft account (email, password, name, birthdate)- ✅ **Daily check-ins** for easy points



**Solution:**You have 2 options:

```bash

npx playwright install chromium2. ✅ Enrolls in Microsoft Rewards using YOUR referral link- 📚 **Read articles** for additional rewards

Option A: Setup Wizard (Easiest)

"Module not found" errors

✅ Adds recovery email for account security

Solution:

bashbash

npm install

npm run buildnpm run setup4. ✅ Enables 2FA with TOTP (Google Authenticator)All while looking completely natural to Microsoft! 🤖

Setup Script Issues

✅ Saves everything to accounts-created/ folder

Windows (if PowerShell blocks scripts):


# Run as Administrator

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser- Create `src/accounts.jsonc` from template---

.\setup\setup.bat

```- Guide you through configuration



**Linux/Mac (if permission denied):**- Build the project automatically### Step 3: CAPTCHA & Verification

```bash

chmod +x setup/setup.sh

bash setup/setup.sh

```**On Windows:**## 🐳 Docker Alternative



**📖 More help:** [Troubleshooting Guide](troubleshooting.md)```powershell



---setup\setup.batDuring account creation:



## 🎯 Best Practices```



1. ✅ **Use referral links** — Earn 7,500 extra points per account per monthIf you prefer containers:

2. ✅ **Enable 2FA** — Protects accounts from theft

3. ✅ **Keep humanization ON** — Reduces ban risk significantly**On Linux/Mac:**

4. ✅ **Run once per day** — Don't over-automate

5. ✅ **Save account files** — Keep `accounts-created/` folder safe```bash1. **CAPTCHA**: The browser will pause - solve it manually

6. ✅ **Use recovery email** — Helps recover suspended accounts

7. ✅ **Monitor logs** — Watch for ban warningsbash setup/setup.sh

8. ✅ **Start small** — Test with 1-2 accounts first

```2. **Recovery Email**: Check your email, enter the verification code```bash

---



## 🆘 Still Need Help?

#### Option B: Manual Setup3. **2FA Setup**: Scan the QR code with Google Authenticator app# Ensure accounts.json and config.json exist

- 💬 **[Join Discord](https://discord.gg/k5uHkx9mne)** — Community support

- 📖 **[Documentation Hub](index.md)** — All guides

- 🐛 **[Report Issue](https://github.com/LightZirconite/Microsoft-Rewards-Bot/issues)** — Found a bug?

1. **Copy the template:**4. **Complete**: Account details saved automaticallydocker compose up -d

---

   ```bash

<div align="center">

   # Windows

**Happy farming! 🎉**

   copy src\accounts.example.jsonc src\accounts.jsonc

[← Back to Documentation](index.md)

   ### Step 4: Find Your Account Info# Follow logs

</div>

   # Linux/Mac

   cp src/accounts.example.jsonc src/accounts.jsoncdocker logs -f microsoft-rewards-bot

After creation, check:```

Open src/accounts.jsonc in text editor


3. **Fill in account details:**

   ```jsoncaccounts-created/account_USERNAME_TIMESTAMP.jsonc**[Full Docker Guide →](./docker.md)**

   {

     "accounts": [```

       {

         "email": "john.smith1995@outlook.com",     // From accounts-created/ file---

         "password": "Xyz789!@#AbcDef",              // From accounts-created/ file

         "totp": "JBSWY3DPEHPK3PXP",                // ⚠️ REQUIRED if 2FA enabled!Example file content:

         "enabled": true                             // Set to true

       }```jsonc## 🔧 Next Steps

     ]

   }{

"email": "john.smith1995@outlook.com",Once running, explore these guides:

Copy info from accounts-created/ folder

"password": "Xyz789!@#AbcDef",

For each account you created:

Copy email "birthdate": {| Priority | Guide | Why Important |
Copy password
Copy totpSecret → Put in totp field "day": 15,|----------|-------|---------------|
Set enabled: true

"month": 6,| **High** | **[Accounts & 2FA](./accounts.md)** | Set up TOTP for secure automation |

Save the file

"year": 1995| High | External Scheduling | Automate with Task Scheduler or cron |

Step 2: Configure Bot Settings

},| Medium | Notifications | Get alerts on your phone |

Open src/config.jsonc:

"firstName": "John",| Low | Humanization | Advanced anti-detection |

Enable Automatic Scheduling (Recommended)

"lastName": "Smith",


{  "createdAt": "2025-11-09T10:30:00.000Z",---

  "scheduling": {

    "enabled": true,  "referralUrl": "https://rewards.bing.com/welcome?rh=YOUR_CODE",

    "type": "auto",

    "cron": {  "recoveryEmail": "backup@gmail.com",## 🆘 Need Help?

      "schedule": "0 9 * * *"    // Daily at 9 AM (Linux/Mac/Raspberry Pi)

    },  "totpSecret": "JBSWY3DPEHPK3PXP",

    "taskScheduler": {

      "schedule": "09:00"         // Daily at 9:00 (Windows)  "recoveryCode": "MWGR3-9MJC9-STK76-SZCE5-X77PR"**Script not starting?** → [Troubleshooting Guide](./diagnostics.md)  

    }

  }}**Login issues?** → [Accounts & 2FA Setup](./accounts.md)  

}

``````**Want Docker?** → [Container Guide](./docker.md)  



**How it works:**

- Run `npm start` once

- Bot automatically schedules itself**⚠️ IMPORTANT: Keep this file safe!****Found a bug?** [Report it here](https://github.com/LightZirconite/Microsoft-Rewards-Bot/issues)  

- Runs every day at your chosen time

- Perfect for Raspberry Pi!- `totpSecret`: Needed for 2FA login (bot uses this)**Need support?** [Join our Discord](https://discord.gg/k5uHkx9mne)



**See [Scheduling Guide](schedule.md) for details**- `recoveryCode`: Emergency account recovery



#### Notifications (Optional)- `birthdate`: Needed if Microsoft suspends account---



Get notified when bot finishes:- `password`: Keep it safe!



**Discord Webhook:**## 🔗 Related Guides

```jsonc

{### Without 2FA (Not Recommended)

  "conclusionWebhook": {

    "enabled": true,- **[Accounts & 2FA](./accounts.md)** — Add Microsoft accounts with TOTP

    "webhookUrl": "https://discord.com/api/webhooks/YOUR_WEBHOOK"

  }If you don't want 2FA, just omit `-y`:- **[Docker](./docker.md)** — Deploy with containers  

}

```- **[External Scheduling](./schedule.md)** — Automate daily execution



**NTFY Push Notifications:**```bash- **[Discord Webhooks](./conclusionwebhook.md)** — Get run summaries

```jsonc

{npm run creator https://rewards.bing.com/welcome?rh=YOUR_CODE

  "ntfy": {```

    "enabled": true,

    "topic": "your-unique-topic",Then answer "n" when asked about 2FA.

    "priority": 3

  }---

}

```## ⚙️ Configuration



**See [Notifications Guide](conclusionwebhook.md) for setup**### Step 1: Setup Accounts File



#### Important Settings#### Option A: Use Setup Wizard



```jsonc```bash

{# Windows

  "humanization": {setup\setup.bat

    "enabled": true,        // ⚠️ ALWAYS keep true!

    "stopOnBan": true       // Stop if ban detected# Linux/Mac

  },bash setup/setup.sh

  "workers": {

    "doDesktopSearch": true,# Or via npm

    "doMobileSearch": true,npm run setup

    "doDailySet": true,```

    "doMorePromotions": true,

    "doPunchCards": trueThe wizard will:

  }1. Create `src/accounts.jsonc` from template

}2. Ask you to fill in account details

```3. Compile the project



**See [Configuration Guide](config.md) for all options**#### Option B: Manual Setup



### Step 3: Build the Project1. Copy the template:

   ```bash

```bash   # Windows

npm run build   copy src\accounts.example.jsonc src\accounts.jsonc

Linux/Mac

Or skip if you used the setup wizard (it builds automatically). cp src/accounts.example.jsonc src/accounts.jsonc


---

2. Open `src/accounts.jsonc` in a text editor

## 🎮 First Run

3. Fill in your account(s):

### Manual Run   ```jsonc

{

```bash     "accounts": [

npm start       {

```         "email": "john.smith1995@outlook.com",  // From accounts-created/ file

      "password": "Xyz789!@#AbcDef",          // From accounts-created/ file

**What happens:**         "totp": "JBSWY3DPEHPK3PXP",            // ⚠️ REQUIRED if you enabled 2FA!

1. Bot logs into each enabled account         "enabled": true                         // Set to true to activate

2. Completes desktop searches (30+)       }

3. Completes mobile searches (20+)     ]

4. Does daily activities (quizzes, polls)   }

5. Completes promotional offers   ```

6. Shows summary of points earned

4. **For each account you created**, copy the info from `accounts-created/` folder

### With Automatic Scheduling

5. Save the file

If you enabled scheduling in config:

### Step 2: Configure Bot Settings (Optional)

```bash

npm startOpen `src/config.jsonc` and adjust settings:

Scheduling (Recommended)

The bot will:

Run immediately once```jsonc
Automatically schedule future runs{
Run daily at your chosen time "scheduling": {
No need to run manually again! "enabled": true, // Enable automatic scheduling

"type": "auto", // Auto-detect OS

Monitoring "cron": {

  "schedule": "0 9 * * *" // Run daily at 9 AM (Linux/Mac/Raspberry Pi)

Watch the console output to see: },

Login status "taskScheduler": {
Search queries "schedule": "09:00" // Run daily at 9:00 (Windows)
Activities completed }
Points earned }
Ban warnings (if any)}


---

**How it works:**

## 🎯 What's Next- Set `enabled: true`

- Run `npm start` once

### Optional: Enable Dashboard- Bot will automatically run every day at the scheduled time

- Perfect for Raspberry Pi or always-on PC!

Add to `src/config.jsonc`:

```jsonc#### Notifications (Optional)

{

  "dashboard": {Get notified when bot finishes:

    "enabled": true,

    "port": 3000**Discord Webhook:**

  }```jsonc

}{

```  "conclusionWebhook": {

    "enabled": true,

Then access: http://localhost:3000    "webhookUrl": "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"

  }

**See [Dashboard Guide](../src/dashboard/README.md)**}

Optional: Setup Proxies

NTFY Push Notifications:

For each account, add proxy in accounts.jsonc:```jsonc


{  "ntfy": {

  "email": "...",    "enabled": true,

  "password": "...",    "topic": "your-unique-topic",

  "proxy": {    "priority": 3

    "url": "proxy.example.com",  }

    "port": 8080,}

    "username": "user",```

    "password": "pass"

  }See [Notifications Guide](conclusionwebhook.md) for setup instructions.

}

```#### Other Important Settings



**See [Proxy Guide](proxy.md)**```jsonc

{

### Create More Accounts  "search": {

    "useLocalQueries": false,     // Use Google Trends (recommended)

Repeat the account creation process:    "settings": {

```bash      "useGeoLocaleQueries": true // Use account country (FR, DE, etc.)

npm run creator https://rewards.bing.com/welcome?rh=YOUR_CODE -y backup@gmail.com    }

```  },

  "humanization": {

Each account earns YOU 7,500 bonus points per month!    "enabled": true,               // ⚠️ ALWAYS keep this true!

    "stopOnBan": true              // Stop if ban detected

---  },

  "workers": {

## ❓ Troubleshooting    "doDesktopSearch": true,       // Desktop searches

    "doMobileSearch": true,        // Mobile searches

### "Account credentials are invalid"    "doDailySet": true,            // Daily activities

    "doMorePromotions": true,      // Promotional offers

**Cause:** Wrong email/password or missing TOTP    "doPunchCards": true           // Multi-day challenges

  }

**Solution:**}

1. Check `src/accounts.jsonc` has correct credentials```

2. If 2FA enabled, make sure `totp` field has the secret

3. Test login manually: https://login.live.com/### Step 3: Build the Project



### "Ban detected" or "Account suspended"```bash

npm run build

**Cause:** Microsoft detected automation```



**Solutions:**Or if you used the setup wizard, it already did this for you.

- Always keep `humanization.enabled: true`

- Don't run bot multiple times per day---

- Use proxies (see [Proxy Guide](proxy.md))

- Start with 1-2 accounts to test## 🎮 First Run



**Recovery:**### Manual Run

- Use `birthdate` from `accounts-created/` file

- Use `recoveryCode` if can't login```bash

- Contact Microsoft with account creation datenpm start

"Browser launch failed"

The bot will:

**Solution:**1. ✅ Log into each enabled account


npx playwright install chromium3. ✅ Complete mobile searches (20+)

```4. ✅ Do daily activities (quizzes, polls)

5. ✅ Complete promotional offers

### "Module not found"6. ✅ Show summary of earned points



**Solution:**### With Scheduling (Recommended)

```bash

npm iIf you enabled scheduling in config:

npm run build

``````bash

npm start

### More Help```



- 📖 [Configuration Reference](config-reference.md)Then the bot will:

- 📖 [Diagnostics Guide](diagnostics.md)- Run immediately once

- 📖 [Accounts & 2FA](accounts.md)- **Automatically schedule future runs** (daily at your chosen time)

- 💬 [Join Discord](https://discord.gg/k5uHkx9mne)- You don't need to run it again manually!



---Perfect for Raspberry Pi or always-on systems.



## 🎯 Best Practices---



1. **Use referral links** — 7,500 extra points per account## 🔍 Monitoring

2. **Enable 2FA** — Protects accounts

3. **Keep humanization ON** — Reduces ban risk### Real-time Logs

4. **Run once per day** — Don't overuse

5. **Save account files** — Keep `accounts-created/` safeWatch the console output to see:

6. **Monitor logs** — Watch for warnings- Login status for each account

7. **Start small** — Test with 1-2 accounts- Search queries being performed

- Activities completed

---- Points earned

- Ban warnings (if any)

## 📚 Related Documentation

### Dashboard (Optional)

- [Configuration Guide](config.md)

- [Account Creator Details](../src/account-creation/README.md)Enable the web dashboard:

- [Dashboard Guide](../src/dashboard/README.md)

- [Scheduling Setup](schedule.md)```jsonc

- [Docker Deployment](docker.md){

- [Troubleshooting](diagnostics.md)  "dashboard": {

    "enabled": true,

---    "port": 3000

  }

[← Back to Documentation](index.md)}

Then access: http://localhost:3000

Features:

Real-time account status
Live log streaming
Manual sync buttons
Configuration editor
Historical metrics

❓ Troubleshooting

"Account credentials are invalid"

Problem: Wrong email/password or missing TOTP

Solution:

Check src/accounts.jsonc has correct email and password
If you enabled 2FA, make sure totp field has the secret from accounts-created/ file
Test login manually at https://login.live.com/

"Ban detected" or "Account suspended"

Problem: Microsoft detected automation

Solutions:

✅ Always keep humanization.enabled: true in config
✅ Don't run the bot multiple times per day
✅ Use different proxies for each account (see Proxy Guide)
✅ Start with 1-2 accounts to test

Account Recovery:

Use the birthdate from accounts-created/ file
Use the recoveryCode if you can't login
Contact Microsoft support with account creation date

"Browser launch failed"

Problem: Chromium not installed or missing system dependencies

Solution:

Windows/Mac:

npx playwright install chromium

Linux (Ubuntu/Debian):

# Install Chromium + system dependencies
npx playwright install-deps chromium
npx playwright install chromium

# Alternative manual installation:
sudo apt-get install -y \
    libnss3 \
    libnspr4 \
    libatk1.0-0 \
    libatk-bridge2.0-0 \
    libcups2 \
    libdrm2 \
    libxkbcommon0 \
    libxcomposite1 \
    libxdamage1 \
    libxfixes3 \
    libxrandr2 \
    libgbm1 \
    libasound2

Linux (Other distributions):

# Red Hat/CentOS/Fedora
sudo yum install -y atk cups-libs libXdamage libXrandr libgbm alsa-lib

# Arch
sudo pacman -S nss atk cups libdrm libxkbcommon libxcomposite libxdamage libxfixes libxrandr alsa-lib

"Module not found" errors

Problem: Dependencies not installed

Solution:

npm i
npm run build

Setup Script Not Working

Windows:

# Run as Administrator
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
.\setup\setup.bat

Linux/Mac:

chmod +x setup/setup.sh
bash setup/setup.sh

More Help

🎯 Best Practices

Use referral links - Earn 7,500 extra points per account per month
Enable 2FA - Protect accounts from being stolen
Keep humanization ON - Reduces ban risk
Run once per day - Don't over-automate
Save account files - Keep accounts-created/ folder safe
Use recovery email - Helps recover suspended accounts
Monitor logs - Watch for ban warnings
Start small - Test with 1-2 accounts first

🚀 Next Steps

Now that you're set up:

✅ Let the bot run once to see results
✅ Check points earned on https://rewards.bing.com/
✅ Set up scheduling for automatic runs
✅ Configure notifications to stay informed
✅ Add more accounts with referrals (earn more points!)

Happy farming! 🎉

33 KiB Raw Blame History Unescape Escape

🚀 Getting Started# 🚀 Getting Started# 🚀 Getting Started Guide

📋 Table of Contents

✅ Requirements4. Configuration

1. Node.js 20 or Higher6. What's Next

✅ Prerequisites

2. Microsoft Accounts

3. Git (Optional)4. Configuration---

📦 Installation

Option 1: Git Clone (Recommended)

Option B: Manual Setup

Install Dependencies - Why? You earn 7,500 points per month for each referral!

Step 3: Complete CAPTCHA- ✅ Built-in 2FA security with TOTP

Step 4: Find Your Account Info

⚙️ Configuration

Essential Settings

Optional: Enable Scheduling

🎮 First RunExample content:

Manual Run```jsonc### 3️⃣ Choose Your Mode

🔧 Next Steps "totpSecret": "JBSWY3DPEHPK3PXP",### Step 2: Create Accounts```

High Priority}

Medium Priority

Optional- All info → Needed to restore account if banned

Option A: Setup Wizard (Easiest)

"Module not found" errors

Setup Script Issues

Step 2: Configure Bot Settings

Enable Automatic Scheduling (Recommended)

Linux/Mac

Scheduling (Recommended)

Monitoring "cron": {

Optional: Setup Proxies

"Browser launch failed"

❓ Troubleshooting

"Account credentials are invalid"

"Ban detected" or "Account suspended"

"Browser launch failed"

"Module not found" errors

Setup Script Not Working

More Help

🎯 Best Practices

🚀 Next Steps

📚 Related Documentation

33 KiB

Raw Blame History