Skip to content

eikowagenknecht/lootscraper

Repository files navigation

LootScraper

image

Publish to Docker Hub and Github Packages CC BY-NC-SA 4.0

You like getting games for free, but you don't like having to keep track of the various sources (Amazon Prime, Epic Games, Steam, ...) for free offers? Also your F5 key starts to look a bit worn out? Then this is for you!

Public feeds / channels / bots

Let's face it, you're probably not here because you're interested in the technical details of how this works. You just want free games. And that's fine. Here's where to find them! You have the following options:

Telegram channels

Want to get a Telegram notification every time a new offer is discovered? Simply subscribe to the Telegram channels.

For our mobile gamers:

Telegram bot

Want to receive only the offers you want in a single chat? Subscribe directly to the source: The Telegram LootScraperBot will happily send you push notifications for new offers. You can choose which categories you want to subscribe to.

If you want, you can even add the bot to your own groups (including threaded groups) and channels. Just make sure to give it the neccessary permissions (admin rights work best).

This is what it currently looks like in Telegram:

image

RSS feeds

Prefer the anonymity and manageability of RSS feeds? Sure. You can use the links below. These feeds contain all active offers.

You can also have all sources in one feed.

This is how it looks in Feedly:

image

E-Mail

If you want to get the offers by email, you can use free services like Blogtrottr or Feedsub to convert from RSS to email.

Discord

If you want to get the offers in a Discord channel, you can use the free MonitoRSS bot to post them there for you. I suggest the following settings:

  • Feed URL: Use the RSS feed links above

  • Content:

    **{{title}}**
    
    {{description}}
  • Button: Label: Claim, URL: {{link}}

  • Embed: Just select Image URL with the {{extracted::atom:content__#::image1}} variable

HTML pages

Want to check a website for new deals once in a while, but not be bothered by push notifications? Here are the latest offers in a nice and clean HTML page:

You can also have all sources on one page.

This is how it looks like:

image

HTML archive

There is also an archive version of the HTML pages. These contain all offers that have been discovered so far, including expired ones.

You can also have all sources on one page.

This is how it looks like:

image

Even more convenience

Now that you get notified about all the free games, you might want to make the process of claiming them even easier. For this, I created some userscripts that can be used with Tampermonkey / Greasemonkey / Violentmonkey. You can find them here.

How it works

This Python (3.12+) application uses Playwright to automatically visit websites with free game-related offers (see below for the supported sources) and then puts the collected information neatly into RSS feeds and a Telegram bot.

If you encounter any problems feel free to open an issue here and I'll do my best to help. I'd also love to hear your feature requests! This is also tracked in the GitHub issues.

For power users and developers

You can either run this project locally on your computer or in any environment capable of running a Docker container.

If you want to do this or even contribute, please see the README for developers file.

Usage Stats

Just in case anyone is interested, these are the stats as of 2024-09-26:

  • The Telegram bot has 311 active subscribers (out of a total of 388, so retention is pretty good).
  • I can't say for sure how many people use the RSS feeds. But my web hosting provider tells me that there is about 10GB of traffic per month from about 2 million hits in total. Epic is the most popular with around 600k hits. Steam follows with 400k hits, GOG 300k, Humble 200k, Amazon 200k, Ubisoft 150k. Itch and the mobile platforms have around 50k each and the all-in-one has 90k. How hits translate to users I can't say. Since the feeds are probably pulled regularly by readers and aggregators like Feedly, the actual number of users will be lower.
  • The HTML pages are a very mixed bag. The Epic page is the most popular with about 10k hits per month. Steam games get 9k hits per month, the rest are between 5 and 25 hits. The all-in-one page is at 400 hits per month.

Star History Chart

License

CC BY-NC-SA 4.0

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.