mirror of
https://github.com/LightZirconite/Microsoft-Rewards-Bot.git
synced 2026-01-10 01:06:17 +00:00
docs: Update README and getting-started guide for clarity and structure; remove git conflict resolution guide
This commit is contained in:
46
README.md
46
README.md
@@ -35,43 +35,35 @@ This TypeScript-based automation bot helps you maximize your **Microsoft Rewards
|
|||||||
|
|
||||||
## 🚀 Quick Start
|
## 🚀 Quick Start
|
||||||
|
|
||||||
### Prerequisites
|
### ⚡ Prerequisites
|
||||||
|
|
||||||
- **Node.js 20+** (version 22 recommended) — [Download here](https://nodejs.org/)
|
- **Node.js 20+** (v22 recommended) — [Download here](https://nodejs.org/)
|
||||||
- **Git** for cloning the repository
|
- **Git** (optional) — [Download here](https://git-scm.com/) or download project as ZIP
|
||||||
- **Microsoft account(s)** with email and password
|
|
||||||
|
|
||||||
### Installation
|
### 🎯 3-Step Setup
|
||||||
|
|
||||||
**The automated setup script handles everything for you:**
|
1. **Get the project:**
|
||||||
|
|
||||||
1. **Clone the repository:**
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/Obsidian-wtf/Microsoft-Rewards-Bot.git
|
git clone https://github.com/Obsidian-wtf/Microsoft-Rewards-Bot.git
|
||||||
cd Microsoft-Rewards-Bot
|
cd Microsoft-Rewards-Bot
|
||||||
```
|
```
|
||||||
|
Or download ZIP: [Code → Download ZIP](https://github.com/Obsidian-wtf/Microsoft-Rewards-Bot/archive/refs/heads/main.zip)
|
||||||
|
|
||||||
2. **Run the setup script:**
|
2. **Install dependencies:**
|
||||||
- **Windows:** Double-click `setup/setup.bat` or run in PowerShell:
|
```bash
|
||||||
```powershell
|
npm i
|
||||||
.\setup\setup.bat
|
```
|
||||||
```
|
|
||||||
- **Linux / macOS / WSL:**
|
|
||||||
```bash
|
|
||||||
bash setup/setup.sh
|
|
||||||
```
|
|
||||||
- **Or use npm:**
|
|
||||||
```bash
|
|
||||||
npm run setup
|
|
||||||
```
|
|
||||||
|
|
||||||
3. **The setup wizard will:**
|
3. **Create accounts & configure:**
|
||||||
- ✅ Create and configure `accounts.jsonc` with your credentials
|
```bash
|
||||||
- ✅ Install all dependencies automatically
|
# Use our account creator (recommended - earn +7,500 points/month!)
|
||||||
- ✅ Build the TypeScript project
|
npm run creator https://rewards.bing.com/welcome?rh=YOUR_CODE -y backup@gmail.com
|
||||||
- ✅ Optionally start the script immediately
|
|
||||||
|
# Or use setup wizard
|
||||||
|
npm run setup
|
||||||
|
```
|
||||||
|
|
||||||
**That's it! You're ready to start earning points.** 🎉
|
**📖 Need detailed instructions? See [Getting Started Guide](docs/getting-started.md)**
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
@@ -1,138 +1,597 @@
|
|||||||
<div align="center">
|
# 🚀 Getting Started Guide<div align="center">
|
||||||
|
|
||||||
<img src="../assets/logo.png" alt="Microsoft Rewards Script Logo" width="120"/>
|
|
||||||
|
|
||||||
# 🚀 Getting Started
|
|
||||||
|
|
||||||
**🎯 From zero to earning Microsoft Rewards points in minutes**
|
Complete step-by-step tutorial to set up and run Microsoft Rewards Bot.<img src="../assets/logo.png" alt="Microsoft Rewards Script Logo" width="120"/>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
---# 🚀 Getting Started
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## 📋 Table of Contents**🎯 From zero to earning Microsoft Rewards points in minutes**
|
||||||
|
|
||||||
*Complete setup guide for beginners*
|
*Complete setup guide for beginners*
|
||||||
|
|
||||||
</div>
|
1. [Prerequisites](#-prerequisites)
|
||||||
|
|
||||||
---
|
2. [Get the Project](#-get-the-project)</div>
|
||||||
|
|
||||||
## ✅ Requirements
|
3. [Create Microsoft Accounts](#-create-microsoft-accounts)
|
||||||
|
|
||||||
|
4. [Configuration](#-configuration)---
|
||||||
|
|
||||||
|
5. [First Run](#-first-run)
|
||||||
|
|
||||||
|
6. [Troubleshooting](#-troubleshooting)## ✅ Requirements
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
---- **Node.js 18+** (22 recommended) — [Download here](https://nodejs.org/)
|
||||||
|
|
||||||
- **Node.js 18+** (22 recommended) — [Download here](https://nodejs.org/)
|
|
||||||
- **Microsoft accounts** with email + password
|
- **Microsoft accounts** with email + password
|
||||||
- **Optional:** Docker for containerized deployment
|
|
||||||
|
|
||||||
---
|
## ✅ Prerequisites- **Optional:** Docker for containerized deployment
|
||||||
|
|
||||||
## ⚡ Quick Setup (Recommended)
|
|
||||||
|
|
||||||
<div align="center">
|
|
||||||
|
|
||||||
### **🎬 One Command, Total Automation**
|
Before starting, you need:---
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# 🪟 Windows
|
1. **Node.js 20+** (version 22 recommended)## ⚡ Quick Setup (Recommended)
|
||||||
setup/setup.bat
|
|
||||||
|
- Download: https://nodejs.org/
|
||||||
|
|
||||||
|
- Verify: `node --version` should show v20 or higher<div align="center">
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
2. **Git** (optional, but recommended)### **🎬 One Command, Total Automation**
|
||||||
|
|
||||||
|
- Download: https://git-scm.com/
|
||||||
|
|
||||||
|
- Or download project as ZIP</div>
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
3. **A main Microsoft account** (your personal account)```bash
|
||||||
|
|
||||||
|
- Go to https://rewards.bing.com/referandearn/# 🪟 Windows
|
||||||
|
|
||||||
|
- Copy your referral link (looks like: `https://rewards.bing.com/welcome?rh=XXXX`)setup/setup.bat
|
||||||
|
|
||||||
|
- **Why?** You earn **7,500 points per month** for each referral!
|
||||||
|
|
||||||
# 🐧 Linux/macOS/WSL
|
# 🐧 Linux/macOS/WSL
|
||||||
bash setup/setup.sh
|
|
||||||
|
|
||||||
# 🌍 Any platform
|
---bash setup/setup.sh
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## 📦 Get the Project# 🌍 Any platform
|
||||||
|
|
||||||
npm run setup
|
npm run setup
|
||||||
```
|
|
||||||
|
|
||||||
**That's it!** The wizard will:
|
### Option 1: Git Clone (Recommended)```
|
||||||
- ✅ Help you create `src/accounts.json` with your Microsoft credentials
|
|
||||||
- ✅ Install all dependencies automatically
|
|
||||||
- ✅ Build the TypeScript project
|
|
||||||
|
```bash**That's it!** The wizard will:
|
||||||
|
|
||||||
|
git clone https://github.com/Obsidian-wtf/Microsoft-Rewards-Bot.git- ✅ Help you create `src/accounts.json` with your Microsoft credentials
|
||||||
|
|
||||||
|
cd Microsoft-Rewards-Bot- ✅ Install all dependencies automatically
|
||||||
|
|
||||||
|
```- ✅ Build the TypeScript project
|
||||||
|
|
||||||
- ✅ Start earning points immediately
|
- ✅ Start earning points immediately
|
||||||
|
|
||||||
|
### Option 2: Download ZIP
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🛠️ Manual Setup
|
1. Go to: https://github.com/Obsidian-wtf/Microsoft-Rewards-Bot
|
||||||
|
|
||||||
|
2. Click **Code** → **Download ZIP**## 🛠️ Manual Setup
|
||||||
|
|
||||||
|
3. Extract the ZIP file
|
||||||
|
|
||||||
|
4. Open terminal in the extracted folder<details>
|
||||||
|
|
||||||
<details>
|
|
||||||
<summary><strong>📖 Prefer step-by-step? Click here</strong></summary>
|
<summary><strong>📖 Prefer step-by-step? Click here</strong></summary>
|
||||||
|
|
||||||
|
### Install Dependencies
|
||||||
|
|
||||||
### 1️⃣ **Configure Your Accounts**
|
### 1️⃣ **Configure Your Accounts**
|
||||||
```bash
|
|
||||||
cp src/accounts.example.json src/accounts.json
|
```bash```bash
|
||||||
# Edit accounts.json with your Microsoft credentials
|
|
||||||
|
npm icp src/accounts.example.json src/accounts.json
|
||||||
|
|
||||||
|
```# Edit accounts.json with your Microsoft credentials
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
This will install all required packages.
|
||||||
|
|
||||||
### 2️⃣ **Install Dependencies & Build**
|
### 2️⃣ **Install Dependencies & Build**
|
||||||
```bash
|
|
||||||
|
---```bash
|
||||||
|
|
||||||
npm install
|
npm install
|
||||||
npm run build
|
|
||||||
|
## 🎯 Create Microsoft Accountsnpm run build
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
**⚠️ IMPORTANT: Use the account creator with YOUR referral link to earn 7,500 points per account per month!**
|
||||||
|
|
||||||
### 3️⃣ **Choose Your Mode**
|
### 3️⃣ **Choose Your Mode**
|
||||||
```bash
|
|
||||||
|
### Step 1: Get Your Referral Link```bash
|
||||||
|
|
||||||
# Single run (test it works)
|
# Single run (test it works)
|
||||||
npm start
|
|
||||||
|
|
||||||
# Schedule it (Task Scheduler, cron, etc.)
|
1. Log into your **main Microsoft account**npm start
|
||||||
|
|
||||||
|
2. Go to: https://rewards.bing.com/referandearn/
|
||||||
|
|
||||||
|
3. Copy your referral link (format: `https://rewards.bing.com/welcome?rh=YOUR_CODE`)# Schedule it (Task Scheduler, cron, etc.)
|
||||||
|
|
||||||
# See docs/schedule.md for examples
|
# See docs/schedule.md for examples
|
||||||
```
|
|
||||||
|
|
||||||
</details>
|
### Step 2: Create Accounts```
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 🎯 What Happens Next?
|
|
||||||
|
|
||||||
The script will automatically:
|
**Recommended command** (enables everything):</details>
|
||||||
- 🔍 **Search Bing** for points (desktop + mobile)
|
|
||||||
- 📅 **Complete daily sets** (quizzes, polls, activities)
|
|
||||||
|
|
||||||
|
```bash---
|
||||||
|
|
||||||
|
npm run creator https://rewards.bing.com/welcome?rh=YOUR_CODE -y backup@gmail.com
|
||||||
|
|
||||||
|
```## 🎯 What Happens Next?
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
**Replace:**The script will automatically:
|
||||||
|
|
||||||
|
- `YOUR_CODE` with your actual referral code- 🔍 **Search Bing** for points (desktop + mobile)
|
||||||
|
|
||||||
|
- `backup@gmail.com` with your real recovery email- 📅 **Complete daily sets** (quizzes, polls, activities)
|
||||||
|
|
||||||
- 🎁 **Grab promotions** and bonus opportunities
|
- 🎁 **Grab promotions** and bonus opportunities
|
||||||
- 🃏 **Work on punch cards** (multi-day challenges)
|
|
||||||
- ✅ **Daily check-ins** for easy points
|
|
||||||
- 📚 **Read articles** for additional rewards
|
|
||||||
|
|
||||||
**All while looking completely natural to Microsoft!** 🤖
|
**What this does:**- 🃏 **Work on punch cards** (multi-day challenges)
|
||||||
|
|
||||||
|
1. ✅ Creates a realistic Microsoft account (email, password, name, birthdate)- ✅ **Daily check-ins** for easy points
|
||||||
|
|
||||||
|
2. ✅ Enrolls in Microsoft Rewards using YOUR referral link- 📚 **Read articles** for additional rewards
|
||||||
|
|
||||||
|
3. ✅ Adds recovery email for account security
|
||||||
|
|
||||||
|
4. ✅ Enables 2FA with TOTP (Google Authenticator)**All while looking completely natural to Microsoft!** 🤖
|
||||||
|
|
||||||
|
5. ✅ Saves everything to `accounts-created/` folder
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
### Step 3: CAPTCHA & Verification
|
||||||
|
|
||||||
## 🐳 Docker Alternative
|
## 🐳 Docker Alternative
|
||||||
|
|
||||||
|
During account creation:
|
||||||
|
|
||||||
If you prefer containers:
|
If you prefer containers:
|
||||||
|
|
||||||
```bash
|
1. **CAPTCHA**: The browser will pause - solve it manually
|
||||||
# Ensure accounts.json and config.json exist
|
|
||||||
docker compose up -d
|
2. **Recovery Email**: Check your email, enter the verification code```bash
|
||||||
|
|
||||||
|
3. **2FA Setup**: Scan the QR code with Google Authenticator app# Ensure accounts.json and config.json exist
|
||||||
|
|
||||||
|
4. **Complete**: Account details saved automaticallydocker compose up -d
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
### Step 4: Find Your Account Info# Follow logs
|
||||||
|
|
||||||
# Follow logs
|
|
||||||
docker logs -f microsoft-rewards-bot
|
docker logs -f microsoft-rewards-bot
|
||||||
|
|
||||||
|
After creation, check:```
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
**[Full Docker Guide →](./docker.md)**
|
accounts-created/account_USERNAME_TIMESTAMP.jsonc**[Full Docker Guide →](./docker.md)**
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## 🔧 Next Steps
|
Example file content:
|
||||||
|
|
||||||
Once running, explore these guides:
|
```jsonc## 🔧 Next Steps
|
||||||
|
|
||||||
| Priority | Guide | Why Important |
|
{
|
||||||
|----------|-------|---------------|
|
|
||||||
| **High** | **[Accounts & 2FA](./accounts.md)** | Set up TOTP for secure automation |
|
|
||||||
| **High** | **[External Scheduling](./schedule.md)** | Automate with Task Scheduler or cron |
|
|
||||||
| **Medium** | **[Notifications](./ntfy.md)** | Get alerts on your phone |
|
|
||||||
| **Low** | **[Humanization](./humanization.md)** | Advanced anti-detection |
|
|
||||||
|
|
||||||
---
|
"email": "john.smith1995@outlook.com",Once running, explore these guides:
|
||||||
|
|
||||||
## 🆘 Need Help?
|
"password": "Xyz789!@#AbcDef",
|
||||||
|
|
||||||
**Script not starting?** → [Troubleshooting Guide](./diagnostics.md)
|
"birthdate": {| Priority | Guide | Why Important |
|
||||||
**Login issues?** → [Accounts & 2FA Setup](./accounts.md)
|
|
||||||
**Want Docker?** → [Container Guide](./docker.md)
|
|
||||||
|
|
||||||
**Found a bug?** [Report it here](https://github.com/Obsidian-wtf/Microsoft-Rewards-Bot/issues)
|
"day": 15,|----------|-------|---------------|
|
||||||
**Need support?** [Join our Discord](https://discord.gg/k5uHkx9mne)
|
|
||||||
|
|
||||||
---
|
"month": 6,| **High** | **[Accounts & 2FA](./accounts.md)** | Set up TOTP for secure automation |
|
||||||
|
|
||||||
|
"year": 1995| **High** | **[External Scheduling](./schedule.md)** | Automate with Task Scheduler or cron |
|
||||||
|
|
||||||
|
},| **Medium** | **[Notifications](./ntfy.md)** | Get alerts on your phone |
|
||||||
|
|
||||||
|
"firstName": "John",| **Low** | **[Humanization](./humanization.md)** | Advanced anti-detection |
|
||||||
|
|
||||||
|
"lastName": "Smith",
|
||||||
|
|
||||||
|
"createdAt": "2025-11-09T10:30:00.000Z",---
|
||||||
|
|
||||||
|
"referralUrl": "https://rewards.bing.com/welcome?rh=YOUR_CODE",
|
||||||
|
|
||||||
|
"recoveryEmail": "backup@gmail.com",## 🆘 Need Help?
|
||||||
|
|
||||||
|
"totpSecret": "JBSWY3DPEHPK3PXP",
|
||||||
|
|
||||||
|
"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)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
**⚠️ IMPORTANT: Keep this file safe!****Found a bug?** [Report it here](https://github.com/Obsidian-wtf/Microsoft-Rewards-Bot/issues)
|
||||||
|
|
||||||
|
- `totpSecret`: Needed for 2FA login (bot uses this)**Need support?** [Join our Discord](https://discord.gg/k5uHkx9mne)
|
||||||
|
|
||||||
|
- `recoveryCode`: Emergency account recovery
|
||||||
|
|
||||||
|
- `birthdate`: Needed if Microsoft suspends account---
|
||||||
|
|
||||||
|
- `password`: Keep it safe!
|
||||||
|
|
||||||
## 🔗 Related Guides
|
## 🔗 Related Guides
|
||||||
|
|
||||||
|
### Without 2FA (Not Recommended)
|
||||||
|
|
||||||
- **[Accounts & 2FA](./accounts.md)** — Add Microsoft accounts with TOTP
|
- **[Accounts & 2FA](./accounts.md)** — Add Microsoft accounts with TOTP
|
||||||
- **[Docker](./docker.md)** — Deploy with containers
|
|
||||||
|
If you don't want 2FA, just omit `-y`:- **[Docker](./docker.md)** — Deploy with containers
|
||||||
|
|
||||||
- **[External Scheduling](./schedule.md)** — Automate daily execution
|
- **[External Scheduling](./schedule.md)** — Automate daily execution
|
||||||
- **[Discord Webhooks](./conclusionwebhook.md)** — Get run summaries
|
|
||||||
|
```bash- **[Discord Webhooks](./conclusionwebhook.md)** — Get run summaries
|
||||||
|
|
||||||
|
npm run creator https://rewards.bing.com/welcome?rh=YOUR_CODE
|
||||||
|
```
|
||||||
|
|
||||||
|
Then answer "n" when asked about 2FA.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## ⚙️ Configuration
|
||||||
|
|
||||||
|
### Step 1: Setup Accounts File
|
||||||
|
|
||||||
|
#### Option A: Use Setup Wizard
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Windows
|
||||||
|
setup\setup.bat
|
||||||
|
|
||||||
|
# Linux/Mac
|
||||||
|
bash setup/setup.sh
|
||||||
|
|
||||||
|
# Or via npm
|
||||||
|
npm run setup
|
||||||
|
```
|
||||||
|
|
||||||
|
The wizard will:
|
||||||
|
1. Create `src/accounts.jsonc` from template
|
||||||
|
2. Ask you to fill in account details
|
||||||
|
3. Compile the project
|
||||||
|
|
||||||
|
#### Option B: Manual Setup
|
||||||
|
|
||||||
|
1. Copy the template:
|
||||||
|
```bash
|
||||||
|
# Windows
|
||||||
|
copy src\accounts.example.jsonc src\accounts.jsonc
|
||||||
|
|
||||||
|
# Linux/Mac
|
||||||
|
cp src/accounts.example.jsonc src/accounts.jsonc
|
||||||
|
```
|
||||||
|
|
||||||
|
2. Open `src/accounts.jsonc` in a text editor
|
||||||
|
|
||||||
|
3. Fill in your account(s):
|
||||||
|
```jsonc
|
||||||
|
{
|
||||||
|
"accounts": [
|
||||||
|
{
|
||||||
|
"email": "john.smith1995@outlook.com", // From accounts-created/ file
|
||||||
|
"password": "Xyz789!@#AbcDef", // From accounts-created/ file
|
||||||
|
"totp": "JBSWY3DPEHPK3PXP", // ⚠️ REQUIRED if you enabled 2FA!
|
||||||
|
"enabled": true // Set to true to activate
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
4. **For each account you created**, copy the info from `accounts-created/` folder
|
||||||
|
|
||||||
|
5. Save the file
|
||||||
|
|
||||||
|
### Step 2: Configure Bot Settings (Optional)
|
||||||
|
|
||||||
|
Open `src/config.jsonc` and adjust settings:
|
||||||
|
|
||||||
|
#### Scheduling (Recommended)
|
||||||
|
|
||||||
|
```jsonc
|
||||||
|
{
|
||||||
|
"scheduling": {
|
||||||
|
"enabled": true, // Enable automatic scheduling
|
||||||
|
"type": "auto", // Auto-detect OS
|
||||||
|
"cron": {
|
||||||
|
"schedule": "0 9 * * *" // Run daily at 9 AM (Linux/Mac/Raspberry Pi)
|
||||||
|
},
|
||||||
|
"taskScheduler": {
|
||||||
|
"schedule": "09:00" // Run daily at 9:00 (Windows)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**How it works:**
|
||||||
|
- Set `enabled: true`
|
||||||
|
- Run `npm start` once
|
||||||
|
- Bot will automatically run every day at the scheduled time
|
||||||
|
- Perfect for Raspberry Pi or always-on PC!
|
||||||
|
|
||||||
|
#### Notifications (Optional)
|
||||||
|
|
||||||
|
Get notified when bot finishes:
|
||||||
|
|
||||||
|
**Discord Webhook:**
|
||||||
|
```jsonc
|
||||||
|
{
|
||||||
|
"conclusionWebhook": {
|
||||||
|
"enabled": true,
|
||||||
|
"webhookUrl": "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
**NTFY Push Notifications:**
|
||||||
|
```jsonc
|
||||||
|
{
|
||||||
|
"ntfy": {
|
||||||
|
"enabled": true,
|
||||||
|
"topic": "your-unique-topic",
|
||||||
|
"priority": 3
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
See [Notifications Guide](conclusionwebhook.md) for setup instructions.
|
||||||
|
|
||||||
|
#### Other Important Settings
|
||||||
|
|
||||||
|
```jsonc
|
||||||
|
{
|
||||||
|
"search": {
|
||||||
|
"useLocalQueries": false, // Use Google Trends (recommended)
|
||||||
|
"settings": {
|
||||||
|
"useGeoLocaleQueries": true // Use account country (FR, DE, etc.)
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"humanization": {
|
||||||
|
"enabled": true, // ⚠️ ALWAYS keep this true!
|
||||||
|
"stopOnBan": true // Stop if ban detected
|
||||||
|
},
|
||||||
|
"workers": {
|
||||||
|
"doDesktopSearch": true, // Desktop searches
|
||||||
|
"doMobileSearch": true, // Mobile searches
|
||||||
|
"doDailySet": true, // Daily activities
|
||||||
|
"doMorePromotions": true, // Promotional offers
|
||||||
|
"doPunchCards": true // Multi-day challenges
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Step 3: Build the Project
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm run build
|
||||||
|
```
|
||||||
|
|
||||||
|
Or if you used the setup wizard, it already did this for you.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎮 First Run
|
||||||
|
|
||||||
|
### Manual Run
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm start
|
||||||
|
```
|
||||||
|
|
||||||
|
The bot will:
|
||||||
|
1. ✅ Log into each enabled account
|
||||||
|
2. ✅ Complete desktop searches (30+)
|
||||||
|
3. ✅ Complete mobile searches (20+)
|
||||||
|
4. ✅ Do daily activities (quizzes, polls)
|
||||||
|
5. ✅ Complete promotional offers
|
||||||
|
6. ✅ Show summary of earned points
|
||||||
|
|
||||||
|
### With Scheduling (Recommended)
|
||||||
|
|
||||||
|
If you enabled scheduling in config:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm start
|
||||||
|
```
|
||||||
|
|
||||||
|
Then the bot will:
|
||||||
|
- Run immediately once
|
||||||
|
- **Automatically schedule future runs** (daily at your chosen time)
|
||||||
|
- You don't need to run it again manually!
|
||||||
|
|
||||||
|
Perfect for Raspberry Pi or always-on systems.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🔍 Monitoring
|
||||||
|
|
||||||
|
### Real-time Logs
|
||||||
|
|
||||||
|
Watch the console output to see:
|
||||||
|
- Login status for each account
|
||||||
|
- Search queries being performed
|
||||||
|
- Activities completed
|
||||||
|
- Points earned
|
||||||
|
- Ban warnings (if any)
|
||||||
|
|
||||||
|
### Dashboard (Optional)
|
||||||
|
|
||||||
|
Enable the web dashboard:
|
||||||
|
|
||||||
|
```jsonc
|
||||||
|
{
|
||||||
|
"dashboard": {
|
||||||
|
"enabled": true,
|
||||||
|
"port": 3000
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
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**:
|
||||||
|
1. Check `src/accounts.jsonc` has correct email and password
|
||||||
|
2. If you enabled 2FA, make sure `totp` field has the secret from `accounts-created/` file
|
||||||
|
3. 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](proxy.md))
|
||||||
|
- ✅ 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
|
||||||
|
|
||||||
|
**Solution**:
|
||||||
|
```bash
|
||||||
|
npx playwright install chromium
|
||||||
|
```
|
||||||
|
|
||||||
|
### "Module not found" errors
|
||||||
|
|
||||||
|
**Problem**: Dependencies not installed
|
||||||
|
|
||||||
|
**Solution**:
|
||||||
|
```bash
|
||||||
|
npm i
|
||||||
|
npm run build
|
||||||
|
```
|
||||||
|
|
||||||
|
### Setup Script Not Working
|
||||||
|
|
||||||
|
**Windows:**
|
||||||
|
```powershell
|
||||||
|
# Run as Administrator
|
||||||
|
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
|
||||||
|
.\setup\setup.bat
|
||||||
|
```
|
||||||
|
|
||||||
|
**Linux/Mac:**
|
||||||
|
```bash
|
||||||
|
chmod +x setup/setup.sh
|
||||||
|
bash setup/setup.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
### More Help
|
||||||
|
|
||||||
|
- 📖 [Configuration Reference](config-reference.md)
|
||||||
|
- 📖 [Accounts & 2FA](accounts.md)
|
||||||
|
- 📖 [Proxy Setup](proxy.md)
|
||||||
|
- 📖 [Diagnostics & Logs](diagnostics.md)
|
||||||
|
- 💬 [Join Discord](https://discord.gg/k5uHkx9mne)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🎯 Best Practices
|
||||||
|
|
||||||
|
1. **Use referral links** - Earn 7,500 extra points per account per month
|
||||||
|
2. **Enable 2FA** - Protect accounts from being stolen
|
||||||
|
3. **Keep humanization ON** - Reduces ban risk
|
||||||
|
4. **Run once per day** - Don't over-automate
|
||||||
|
5. **Save account files** - Keep `accounts-created/` folder safe
|
||||||
|
6. **Use recovery email** - Helps recover suspended accounts
|
||||||
|
7. **Monitor logs** - Watch for ban warnings
|
||||||
|
8. **Start small** - Test with 1-2 accounts first
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 🚀 Next Steps
|
||||||
|
|
||||||
|
Now that you're set up:
|
||||||
|
|
||||||
|
1. ✅ Let the bot run once to see results
|
||||||
|
2. ✅ Check points earned on https://rewards.bing.com/
|
||||||
|
3. ✅ Set up scheduling for automatic runs
|
||||||
|
4. ✅ Configure notifications to stay informed
|
||||||
|
5. ✅ Add more accounts with referrals (earn more points!)
|
||||||
|
|
||||||
|
**Happy farming! 🎉**
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 📚 Related Documentation
|
||||||
|
|
||||||
|
- [Configuration Guide](config.md)
|
||||||
|
- [Account Creator Full Guide](../src/account-creation/README.md)
|
||||||
|
- [Dashboard Guide](../src/dashboard/README.md)
|
||||||
|
- [Scheduling Setup](schedule.md)
|
||||||
|
- [Docker Deployment](docker.md)
|
||||||
|
- [Troubleshooting](diagnostics.md)
|
||||||
|
|||||||
@@ -1,193 +0,0 @@
|
|||||||
# Git Conflict Resolution Guide
|
|
||||||
|
|
||||||
## Problem: "Pulling is not possible because you have unmerged files"
|
|
||||||
|
|
||||||
This error occurs when Git has conflicting changes between your local repository and the remote repository.
|
|
||||||
|
|
||||||
## Quick Fix (Recommended)
|
|
||||||
|
|
||||||
### Option 1: Keep Remote Changes (Safest for updates)
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Abort any ongoing operations
|
|
||||||
git merge --abort
|
|
||||||
git rebase --abort
|
|
||||||
|
|
||||||
# Reset to remote version (discards local changes)
|
|
||||||
git fetch --all
|
|
||||||
git reset --hard origin/main
|
|
||||||
|
|
||||||
# Reinstall and rebuild
|
|
||||||
npm ci
|
|
||||||
npm run build
|
|
||||||
```
|
|
||||||
|
|
||||||
### Option 2: Keep Local Changes
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Save your changes
|
|
||||||
git stash push -m "My local changes"
|
|
||||||
|
|
||||||
# Get remote changes
|
|
||||||
git fetch --all
|
|
||||||
git reset --hard origin/main
|
|
||||||
|
|
||||||
# Reapply your changes (may cause conflicts again)
|
|
||||||
git stash pop
|
|
||||||
```
|
|
||||||
|
|
||||||
## Automatic Conflict Prevention
|
|
||||||
|
|
||||||
The update script (`setup/update/update.mjs`) now automatically:
|
|
||||||
|
|
||||||
1. **Detects conflicts** before attempting updates
|
|
||||||
2. **Aborts** failed merge/rebase operations
|
|
||||||
3. **Preserves** your stashed changes
|
|
||||||
4. **Reports** exactly what went wrong
|
|
||||||
|
|
||||||
### Update Script Features
|
|
||||||
|
|
||||||
- ✅ Pre-flight conflict detection
|
|
||||||
- ✅ Automatic abort of failed operations
|
|
||||||
- ✅ Smart backup of config.jsonc and accounts.json
|
|
||||||
- ✅ User-configurable auto-update preferences
|
|
||||||
- ✅ Detailed error reporting with recovery instructions
|
|
||||||
|
|
||||||
## Config Options
|
|
||||||
|
|
||||||
In `config.jsonc`, set these to control what gets auto-updated:
|
|
||||||
|
|
||||||
```jsonc
|
|
||||||
{
|
|
||||||
"update": {
|
|
||||||
"autoUpdateConfig": false, // Keep your local config.jsonc
|
|
||||||
"autoUpdateAccounts": false, // Keep your local accounts.json
|
|
||||||
"git": true, // Enable Git updates
|
|
||||||
"docker": false // Enable Docker updates
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
## Manual Conflict Resolution
|
|
||||||
|
|
||||||
If you need to manually resolve conflicts:
|
|
||||||
|
|
||||||
### 1. Check Status
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git status
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2. View Conflicted Files
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git ls-files -u
|
|
||||||
```
|
|
||||||
|
|
||||||
### 3. For Each Conflicted File
|
|
||||||
|
|
||||||
**Option A: Keep Remote Version**
|
|
||||||
```bash
|
|
||||||
git checkout --theirs <file>
|
|
||||||
git add <file>
|
|
||||||
```
|
|
||||||
|
|
||||||
**Option B: Keep Local Version**
|
|
||||||
```bash
|
|
||||||
git checkout --ours <file>
|
|
||||||
git add <file>
|
|
||||||
```
|
|
||||||
|
|
||||||
**Option C: Manual Edit**
|
|
||||||
- Open the file
|
|
||||||
- Look for `<<<<<<<`, `=======`, `>>>>>>>` markers
|
|
||||||
- Edit to keep what you want
|
|
||||||
- Remove the markers
|
|
||||||
- Save the file
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git add <file>
|
|
||||||
```
|
|
||||||
|
|
||||||
### 4. Complete the Merge
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git commit -m "Resolved conflicts"
|
|
||||||
```
|
|
||||||
|
|
||||||
## Prevention Tips
|
|
||||||
|
|
||||||
1. **Don't edit code files directly** - they're meant to be updated from Git
|
|
||||||
2. **Only customize** `config.jsonc` and `accounts.json`
|
|
||||||
3. **Use the auto-update feature** with proper config flags
|
|
||||||
4. **Commit your config changes** if you want version control
|
|
||||||
5. **Use branches** for custom modifications
|
|
||||||
|
|
||||||
## Troubleshooting
|
|
||||||
|
|
||||||
### "detached HEAD state"
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git checkout main
|
|
||||||
git pull
|
|
||||||
```
|
|
||||||
|
|
||||||
### "Your branch has diverged"
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git fetch origin
|
|
||||||
git reset --hard origin/main
|
|
||||||
```
|
|
||||||
|
|
||||||
### "Permission denied" or file locks
|
|
||||||
|
|
||||||
On Windows:
|
|
||||||
```powershell
|
|
||||||
# Close all Node/VS Code instances
|
|
||||||
taskkill /F /IM node.exe
|
|
||||||
git clean -fd
|
|
||||||
git reset --hard origin/main
|
|
||||||
```
|
|
||||||
|
|
||||||
On Linux/macOS:
|
|
||||||
```bash
|
|
||||||
sudo chown -R $USER:$USER .git
|
|
||||||
git clean -fd
|
|
||||||
git reset --hard origin/main
|
|
||||||
```
|
|
||||||
|
|
||||||
## Emergency Recovery
|
|
||||||
|
|
||||||
If everything is broken:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Backup your config and accounts
|
|
||||||
cp src/config.jsonc ~/backup-config.jsonc
|
|
||||||
cp src/accounts.json ~/backup-accounts.json
|
|
||||||
|
|
||||||
# Nuclear option: fresh clone
|
|
||||||
cd ..
|
|
||||||
rm -rf Microsoft-Rewards-Bot
|
|
||||||
git clone https://github.com/Obsidian-wtf/Microsoft-Rewards-Bot.git
|
|
||||||
cd Microsoft-Rewards-Bot
|
|
||||||
|
|
||||||
# Restore your files
|
|
||||||
cp ~/backup-config.jsonc src/config.jsonc
|
|
||||||
cp ~/backup-accounts.json src/accounts.json
|
|
||||||
|
|
||||||
# Reinstall
|
|
||||||
npm ci
|
|
||||||
npm run build
|
|
||||||
```
|
|
||||||
|
|
||||||
## Support
|
|
||||||
|
|
||||||
If conflicts persist:
|
|
||||||
1. Check GitHub Issues
|
|
||||||
2. Create a new issue with the output of `git status`
|
|
||||||
3. Include your update configuration settings
|
|
||||||
4. Mention your OS and Git version
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
**Remember**: The safest approach is to let Git updates manage code files, and only customize config and accounts files.
|
|
||||||
Reference in New Issue
Block a user