thearyadev / MSRF

Automates Microsoft rewards.
Apache License 2.0
62 stars 9 forks source link
free-money microsoft python rewards selenium
### v0.8b Changes: 
- use docker compose
- update server installation process
- move accounts.sqlite to ./accounts/accounts.sqlite

Microsoft Rewards Famer (MSRF)

GitHub release (latest SemVer) Flet

This project is a automated farmer for Microsoft Rewards. It will log into given accounts and complete surveys, quizzes, and conduct bing searches. The farmer will automatically schedule runs to farm points for each account. More details on what exactly it is doing is outlined below.

Usage of this application may get your Microsoft account permanently banned. I take no responsibility for any actions made on your account.

This project is a rewrite of "Microsoft-Rewards-Farmer". The goal of this project is to move towards a documented and test driven code base. The entire code base has been restructured, and over 90% of it is re-written. Some components from the original project still exist within this one.

Demo

Light Mode Demo Dark Mode Demo Add Account Demo

Installation: Windows Application

Download the zip file from the Github releases for this project. It will include everything needed to run this program, including:

Run the executable to start the program.

*Note: The bundled Chrome and Chromedriver binaries will likely be outdated. This is to prevent breaking changes in Chrome and Chromedriver from affecting the program. For every major release, both bundled binaries will be updated. When using this program, you accept the risk of using unsecure software that may compromise the overall security of your system.

Installation: Server

version: "3.9"
services:
  msrf:
    image: ghcr.io/thearyadev/msrf:latest
    ports:
    # external:internal
    - "50947:50947"
    volumes:
    - ./accounts:/msrf/accounts # directory which should contain the accounts.sqlite file. 

Updating

  1. Delete the existing files. If you know how to use git then feel free to just fetch the changes from the latest release, and skip this and the next step.
  2. Clone the latest release git clone --branch v0.8b https://github.com/thearyadev/MSRF.git. Remember to change the branch name.
  3. Run docker compose up -d --build. The --build flag will ensure the docker image is re-built for the changes.

Making changes after installing

When re-deploying the docker stack, use docker compose up -d --build so that the container is re-built. You should do this when updating any files, such as the configuration.yaml file, as these are embedded into the docker image, and need to be re-built to be included.

Development

This project was developed in Python 3.10.8 and has not been tested with any other version of python. The valid Python range is 3.10 -> 3.12. Most are untested.

This project uses Poetry for dependency management. Using poetry, run poetry install in the root of the project directory. This will install all dependencies.

Tests use environment variables to load some testing account credentials. Check the tests module for more information.

python -m pip install -r requirements.txt

Selenium requires a Chromedriver binary and Chrome installation. This is automatically detected assuming you have correctly configured both on your machine. This behavior can be changed temporarily for development. Browser initialization is done in the file ./util/browser/browser_setup.py. Here you can configure custom chromedriver and chrome binary paths.

Information

Yields

I haven't recorded any numbers for how well this works. I do know that not all quizzes will be completed, sometimes the daily set won't fully complete, and you may not get the streak for that day. If the quiz types change, or new data is present that I have not designed this farmer around, they will not be completed.

That being said, from my testing and observation, a level 2 microsoft rewards account seems to get 150-250 points per day. This number can be increased by manually ensuring that the daily set is completed, so that you gain streak bonuses, and that any additional quizzes or polls that the bot is unable to do are completed.

07/01/2023 - Some surveys don't work. Fixes maybe soon :)

Bans

I've been developing this for about a month now. I haven't been banned on the 4 accounts that I have been testing on. After redeeming excess of $25 worth of rewards, and continuously running this daily, not one account has been banned.

Microsoft may change their methods of banning at any time. Use accounts that you do not value, and redeem your reward as soon as you have enough points.

I'm also not currently aware of any IP bans or rate limits for a single IP when it comes to point collection and reward redemption, as I haven't encountered this in my testing. If this concerns you, i advise you use a VPN. If this becomes a major problem I may incorporate proxy servers into this project.

Breaking Changes

Microsoft can make changes at any time. They may break the farmer. I've designed this so that whichever component does not work, is simply skipped, outputting a critical error then continuing to the next task. When breaking changes are known, I will work towards fixing them.

Not working?

The most common problem I've seen in testing is login problems. The prompt may say something like invalid credentials, which may be the case. Microsoft sometimes has other steps to the login, which I have not considered.

If an account is continuously failing to log in, you can enter "debugging mode" by clicking the bug icon at the bottom control panel. This will show the Chrome browser that is being used by the program, and will allow you to see what is preventing the login.

For example:

If other errors are occurring, you can use debugging mode to determine why those issues are arising.

Updates

When the program gets updated, it will reveal an update prompt. It is important to keep this app up to date, to prevent your account from getting banned.

This project currently has no update/installer. It is just a zipped folder with an executable in it. To copy your accounts over, copy the accounts.sqlite file to the directory that contains the updated files.

Bugs & Feature Requests

Open an issue on this Github repository. Outline the problem to the best of your ability. Be sure to include a screenshot of the log window to show any reported errors, if any.

Unzip your error report, and remove any personal information from it. You can then include it in the Github issue. Without an error report, you may not get help, as it is very hard to determine what the cause of a bug in this program is.

Please use the Github issue template for all bugs and feature requests.

Development Roadmap / Known Issues (All to be implemented at or before the v1.0 release.)

Contributing

There are no contributing guidelines (for now).

🚀 About Me

I'm a developer. Actively learning and looking for new and interesting opportunities. Send me a message: aryan@aryankothari.dev

License

Apache-2.0