free-games-v2's Introduction

Free Games V2

New and improved games grabber for Epic Games that utilizes the Desktop Application rather than the webapp. Designed to run on Windows, but this should also work on Mac and Linux.

If you have an improvement or bug fix, please feel free to make a pull request and I'll try to get to it as soon as I can

Logs in for you

And grabs the free game!

Installation and Setup

Install Python from their website
- Be sure to install PIP if it asks
- Check any boxes related to PATH (this will make execution by any scheduling tool much easier)
Clone this repository or download a ZIP using the green Code button on GitHub
In a terminal or command prompt run this command to install the required dependencies:
- pip install -r requirements.txt
- (If that doesn't work, try pip3 instead of pip)
Open the .env-sample file in a text editor (Notepad, VSCode, Sublime, whatever you have)
Modify these values to what they should be
- LAUNCHER_PATH: This is absolute filepath leading to the executable that launches the EpicGamesLauncher on your computer (on Windows this is a .exe file and on Mac I think this is .app). It will probably be named EpicGamesLauncher (at least, that's what it's called on Windows. If you have a Mac, please confirm this and post an Issue on this repo. Thank you :)). Make sure that there are quotes around the path like in the example
- EPIC_EMAIL: This is the email you use to login with
- EPIC_PASSWORD: This is the password you use to login with
Rename the .env-sample file to just .env
Once everything is modified and saved, go ahead and run the Free_Games_V2.py file
- For Windows: Open a command prompt, navigate to the folder housing the Free_Games_V2.py file and run it with .\Free_Games_V2.py. You can also just open the folder in the File Explorer and double-click on it
- For Mac: Open a terminal, navigate to the folder housing the Free_Games_V2.py file, and run it with python3 ./Free_Games_V2.py.

Schedule to run automatically

TODO, but basically, just use Windows Task Scheduler or a CRON job to run that script whenever you need to (I forget when Epic drops games now, but once a week should do it)

Edge cases

Can pass the EULA screen

TODO

Test/Trim sleep times in between actions to make it faster
Have the script close Epic Games app when finished (for some reason .terminate() and .kill() do not want to work)

free-games-v2's People

Contributors

Stargazers

Watchers

free-games-v2's Issues

Edge case scenario when epic is already open?

(Sorry if I should not be making an issue over this)

I know it will close epic in the future so this should not be an isssue. Just figured I would mention this. While testing this my epic was already scrolled past or already on the free games section. Then when I ran the tool it would click store and scroll which would then skip over the free game section.

Potential solution, could be having it check for the free now text before it does anything at all?

Another solution, could be making the script scroll back up after scrolling down for a while?

Again, Sorry if this is not an "issue" or not worth your time. Thank you for making this tool.

May be worth adding Github LFS explanation

Due to github LFS (Large File System) when I downloaded this via Zip the images in folders "GIFs" and "OCVTemplates" was not visible. It may be worth leaving a note that people should download via Github desktop or via command line.