SteamGifts v2 Giveaway Filter (with SteamGifts++ and SGv2 Dark support)

Back in the days of (good) old SteamGifts v1, I couldn't even image using the site without SteamGifts+ with endless scrolling and giveaway filtering. When SteamGifts v2 was in beta, I heard about people working on SteamGifts++, a version of SteamGifts+ for the new site. I was pretty happy thinking that when the new site comes out, I'll be able to use it the same way as before. Unfortunatelly, development of SG++ stopped, probably due to personal/time reasons which I completely understand and respect. One feature in the current SG++ was missing though, and it was the giveaway filtering, a crucial part of the original SG+ plugin. I waited a few months and after I did my first "Hello world" in Javascript, I decided I'd try to create the filtering scrip for myself. After I did, I sent it to the proud people of The Reset and surprisingly they liked it (thanks for the alpha testing, guys). Even though I refused it before, I decided to try to make a UI for the filter and make it public. And here we are!

You might ask why I didn't add the filtering to SG++ itself. I looked at it and they seemed to use some framework(s) which I didn't want to learn since pure Javascript seemed enough for the job. If anyone wants and is skilled enough, he/she can take this plugin and convert it to SG++, I won't mind. Just be aware that if you do so, I won't be able to support the development of the plugin as much as I could if it'd have stayed in pure Javascript. Now as mentioned earlier, I'm no web/Javascript developer and I don't aspire to be one. If you look at the code and think it's ugly, wrong or anything like that, I'll be happy to take any suggestions you can give me to improve it. Just try to avoid comments like "use jQuery, you noob" since these are not helping at all. If you want and think you can, you can always create a pull request and I'll be happy to take a look at your work and merge it into the plugin if possible.

I'll try to monitor the discussion below and try to implement the most requested features into the plugin, but since I'm working on the plugin in my free time, I might refuse to implement some features if I think it's too hard to do them properly without significant usability gain or I might take "forever" to develop them if I just don't have time to do it at the moment.

Thanks for reading, I hope you enjoy the plugin and happy giving/winning!


Features

  • Filtering giveaways based on the level required to join, number of entries and/or points required to enter.
  • Possibility to exclude group/whitelist/pinned/region-restricted giveaways from filtering.
  • Filtering enabled on per-page basis.
  • Hide entered giveaways (with or without respect to other filter options).
  • Support for SG++ endless scroll and grid view.
  • Remove pagination for truly seamless endless scrolling.

Screenshot here


Requirements

It might work with older versions of the browsers or userscript plugins, but it has been tested on those above mentioned. If it works on older versions, share it in the comments and I'll try to update the requirements based on what you say. My intention is to always make it work on the newest version of the browser/plugin without any backwards compatibility unless explicitly requested.


Download

There are three options how to get the plugin:

  • The release version - download here - suitable for most, should always be stable and without any major bugs.
  • The beta version - download here - suitable for those that want new features/bugfixes early and don't mind some minor problems with the plugin.
  • The development version - download here - for enthusiasts, always have the current state-of-the-art technology, but might contain plugin-breaking bugs.

Changelog

0.5.7-BETA

  • Fixed filtering on the main page in Chrome.

0.5.6-BETA

  • Added support for the "Recommended" giveaway view.

0.5.5-BETA

  • Fixed filtering not working after SG moved to the HTTPS protocol. - by SilentGuy
  • Fixed SG++ GridView filtering not working properly. - by SilentGuy/SquishedPotatoe

0.5.4-BETA

  • Added support for SGv2 Dark. (REQ2) - by SquishedPotatoe
  • Fixed filter being displayed in the details of a giveaway. - by 0657code
  • Fixed filtering not working in some versions of Chrome (hopefully should be working now).

0.4.2-BETA

  • Changed the hide entered giveaways option to have multiple modes ("Yes" and "Always") with different behavior.

0.4.1-BETA

  • Added an option to filter giveaways based on points required to enter. (REQ3)
  • Added an option to exclude region-restricted giveaways from filtering.
  • Added an option to hide entered giveaways.
  • Added an option to remove pagination (for truly seamless endless scrolling). (REQ1) - by Timmaeh
  • Fixed filtering not working when there are no pinned giveaways.
  • Fixed giveaways user can't currently enter due to level requirements being filtered as well even when they belong to the level range.

0.2.2-BETA

  • Fixed support for SG++ 0.4.0beta.

0.2.1-BETA

  • Fixed handling of pinned GAs in the SG++ grid view.

0.2-BETA

  • Initial version of the script.

Requested features

I'll try to keep track of the features requested by you here. You can "like" a request by positively mentioning it in your comment with the REQ code assigned to all requests. I'll try to keep track of the likes and requests with more likes will get more attention.


Contributors

(in order in which they did their first commit)


Supporting the plugin

If you can and want, the best support is to go and code a requested feature and send a pull request with it. You'll be listed as a contributor/developer of course. If you can't or don't want to be involved in the development, there is another way how to support. Now before I tell you more, let me say that I'll continue the development unless stated otherwise without any further support, but supporting might increase the speed of the development or push forward some features you'd like to see, but everything is strictly voluntary. If you want, you can support by donating me a game from my wishlist. While donating, we can talk about what feature or anything else you'd like to see in the plugin and we can agree that I'll do it based on your donation. If we, for some reason, don't agree, you don't have to donate the game, it's completely voluntary. You can also donate games not on my wishlist, but always consult me before because I don't want to just hoard games I'm not going to play. You'd do better service just simply giving the game away on SteamGifts instead of giving it to me :). I don't accept any money or any other kind of stuff/services.

3 years ago*

Comment has been collapsed.

Much needed, thanks :d

3 years ago
Permalink

Comment has been collapsed.

thanks

3 years ago
Permalink

Comment has been collapsed.

I'd like the gridview to have no spacings (removing the page count maybe?)

This was missing btw from the SG++, so thanks!

3 years ago
Permalink

Comment has been collapsed.

Created a REQ1 out of this.

3 years ago
Permalink

Comment has been collapsed.

Thank you so much for this! <3

3 years ago
Permalink

Comment has been collapsed.

You are very welcome!

3 years ago
Permalink

Comment has been collapsed.

Nice! Only thing to not is that it does not get recolored by SGv2 dark...

3 years ago
Permalink

Comment has been collapsed.

Created a REQ2 out of this.

3 years ago
Permalink

Comment has been collapsed.

Hey! why are you being silent about Addlinks to SGtools? it's a nice script..are you waiting to change something before making a thread for it?

3 years ago
Permalink

Comment has been collapsed.

You are right, hiding it in a comment somewhere was very low key... Made a post (which you already have found) just cause you reminded me :-D

3 years ago
Permalink

Comment has been collapsed.

View attached image.
3 years ago
Permalink

Comment has been collapsed.

Should work with SGv2 Dark now, test it out :)

2 years ago
Permalink

Comment has been collapsed.

it's very helpful!

View attached image.
3 years ago
Permalink

Comment has been collapsed.

Glad to hear that :)

3 years ago
Permalink

Comment has been collapsed.

Thanks, I love it already. I'd like to request the feature to filter by the amount of points needed to enter a giveaway.
For example: Show only giveaways that I need a maximum of 20 points and a minimum of 10 points to enter. (Much like the level filter)

By the way, what do you mean by "You can "star" a request you like by using the REQ code"? I really like REQ1, so should I just mention that in my comment to "star" it?

3 years ago*
Permalink

Comment has been collapsed.

Sorry, I rephrased it a little bit. Hope it's more clear now :) Also added your request.

3 years ago
Permalink

Comment has been collapsed.

Wonderful. Thanks for this.

3 years ago
Permalink

Comment has been collapsed.

You're welcome :)

3 years ago
Permalink

Comment has been collapsed.

Uhm, sounds cool, but... where are the filtering options? ^^"
EDIT: huh, now the bar appeared...

3 years ago*
Permalink

Comment has been collapsed.

Sorry, should have included a screenshot :) It's there now.

3 years ago
Permalink

Comment has been collapsed.

Did you update the script? There was no bar before on the "all" and "new" pages, only on the user one (which worked for the user page, but not any other O.o) Or am I going mad? XD

3 years ago
Permalink

Comment has been collapsed.

No, I didn't update it :) You probably just missed it :)

3 years ago
Permalink

Comment has been collapsed.

No, I looked for it... Ok, I'm officially crazy :'(
EDIT: ok, I checked and now changing the setting on the user page works for all pages. Since I did find it there before and tried it without any result, I guess it either didn't work properly before or I somehow triggered an uncommon bug. Weird. O.o

View attached image.
3 years ago*
Permalink

Comment has been collapsed.

Weird indeed :) Are you, by any chance, using any other SG addons?

3 years ago
Permalink

Comment has been collapsed.

Yup:
Add links to SGtools
Entries and Comments (Find those leechers)
Steamgifts Blacklist/Whitelist Indicator
Steamgifts Whitelist Wishlist Fetcher
Steamgifts thank filter
SG++
However, I did try disabling them to see if there was some kind of conflict and it didn't help.

3 years ago
Permalink

Comment has been collapsed.

I still think it might be a conflict :) If I have time, I'll try them and see if I find something.

3 years ago
Permalink

Comment has been collapsed.

Thank you very very very much!
I needed this so much. It really helps a lot! :)

3 years ago
Permalink

Comment has been collapsed.

You're welcome :)

3 years ago
Permalink

Comment has been collapsed.

Finally! Thanks a load for this!

3 years ago
Permalink

Comment has been collapsed.

You're welcome :)

3 years ago
Permalink

Comment has been collapsed.

Great! Been looking for this for quite some time!

However it seems to work and exclude group giveaways but it doesn't exclude whitelist giveaways on the main page?

I have to go to the Whitelist tab to see them....
Can you look into this?

3 years ago
Permalink

Comment has been collapsed.

Glad you like it :)

Are you sure you are not mistaking whitelist for wishlist? It should work for whitelist :) It doesn't do anything with the wishlist at the moment.

3 years ago
Permalink

Comment has been collapsed.

Oh I'm sorry I must have! Would you consider implementing an exclude for wishlisted games or that wouldn't work? For now it's quite alright for me to look at the wishlist tab seperately too.

Great job on tye addon again, makes it so much easier to browse.

3 years ago
Permalink

Comment has been collapsed.

I was actually thinking about it, but SteamGifts no longer export the information about the GA being from your Wishlist on the front page, so it's not easy to do (I have an idea how that might work, but don't know how to actually do it at the moment). Created a REQ4 from this and we'll see :)

3 years ago
Permalink

Comment has been collapsed.

This is awesome.

3 years ago
Permalink

Comment has been collapsed.

Glad you like it :)

3 years ago
Permalink

Comment has been collapsed.

i am sticking with leomoty's SG++

and sorry dude. i hate people asking for donation on forums. seen way too many times.

3 years ago
Permalink

Comment has been collapsed.

You probably misunderstood the purpose of this addon. It's made to be complementary with SG++, meaning it shouldn't duplicate features, but add more (usually missing from SG++ as compared to SG+).

3 years ago
Permalink

Comment has been collapsed.

Update to version 0.2.2-BETA released (with support for SG++ 0.4.0beta).

3 years ago
Permalink

Comment has been collapsed.

Thank you for this addon, very useful. :)
Had to reinstall the addon to make it work, didn't work after the automatic update for some reason.

It would be great if you could add a fliter by winning chance percentage (which SG++ v2 already calculates/displays), a filter that SG++ v1 used to have.

3 years ago
Permalink

Comment has been collapsed.

Glad you like it :) Dunno what it was with the update, Tampermonkey/Greasemonkey should handle it.

Created a request out of your post, we'll see :)

3 years ago
Permalink

Comment has been collapsed.

Wow, it works pretty well! Thanks for the time and effort you put into this!

3 years ago
Permalink

Comment has been collapsed.

You're welcome :)

3 years ago
Permalink

Comment has been collapsed.

Thank you, I was looking around the site for filters, but I never found it. Hope this helps!

3 years ago
Permalink

Comment has been collapsed.

You're welcome :)

3 years ago
Permalink

Comment has been collapsed.

3 years ago
Permalink

Comment has been collapsed.

Thank you!! This is the only feature I ever wanted and none of the other add-ons ever added it!! Now I can stick to yours, no need for all the other weird stuff. Awesomeness!

3 years ago
Permalink

Comment has been collapsed.

Awesome!

3 years ago
Permalink

Comment has been collapsed.

Thanks a lot, guys! :D

3 years ago
Permalink

Comment has been collapsed.

You're welcome :)

3 years ago
Permalink

Comment has been collapsed.

Is it possible to disable SG filter with this script? (without removing games from filter)

3 years ago
Permalink

Comment has been collapsed.

Hi, I just tested it and it's not possible, sorry. If you put a game into the filter, the giveaways won't be exported to the client = browser (so basically instead of becoming hidden on your giveaway page, they are completely gone). The script can only modify what gets to the client and since these giveaways don't, it can't do anything about it.

3 years ago
Permalink

Comment has been collapsed.

Thanks for taking the time to test it :)

3 years ago
Permalink

Comment has been collapsed.

Any of these mods DON"T use greasemoney etc etc? I Just want endless scrolling and hide already entered.

3 years ago
Permalink

Comment has been collapsed.

Hi, it's no possible without it unfortunately. Cg would need to add the functionality directly to the site. Functionality created by users will always need some kind of browser addon/extension to work (be it through a middle man like Greasemonkey or directly)..

3 years ago
Permalink

Comment has been collapsed.

Thanks so much! I was looking for something like this :)

3 years ago
Permalink

Comment has been collapsed.

Glad you like it :)

3 years ago
Permalink

Comment has been collapsed.

this is such an awesome add on man. thanks for all the great work! May i make a suggestion to add a filter for region restricted giveaways? It would show region restricted giveaways regardless of the levels or chances, since some of the regional giveaways have a very small participant pools.

3 years ago
Permalink

Comment has been collapsed.

You're welcome :) And exclusion for region-restricted GAs is already in the DEV version :)

3 years ago
Permalink

Comment has been collapsed.

oh i didnt know that. that is amazing!

3 years ago
Permalink

Comment has been collapsed.

yeah, thank you very much. i was wondering yesterday if something like that would exist

3 years ago
Permalink

Comment has been collapsed.

You're welcome :)

3 years ago
Permalink

Comment has been collapsed.

I've installed it (and reinstalled it), but I don't actually get the filtering options like in the picture. Just the Hide Entered checkmarks on the left side.

3 years ago
Permalink

Comment has been collapsed.

The checkbox on the left is from SG++, not this addon. Do you meet the requirements mentioned?

3 years ago
Permalink

Comment has been collapsed.

Aye. I have Chrome 43 and Tampermonkey 3.10.109. I'll try reinstalling Tampermonkey.

3 years ago
Permalink

Comment has been collapsed.

Do you use any other addons on SG? Should be working with SG++, but I don't use/test with anything else. By the way (if it's not clear from the screenshot), the filter options should be located above the giveaways on the main page, below pinned ones.

3 years ago
Permalink

Comment has been collapsed.

Just SG++. Heck, the only other Chrome add-on I use is Adblock, but I've tried disabling that.

I've tried all three versions of this filter, but with no success yet.

View attached image.
3 years ago
Permalink

Comment has been collapsed.

Hmm, did you try disabling everything just to see if that changes things? Could you also try it in a different browser? (I know it's a pain, but these kind of bugs when stuff "just doesn't work" are pretty hard to debug.)

3 years ago
Permalink

Comment has been collapsed.

I know, which is why I mentioned it. I didn't intend to be a pain, but I figured it might help on your end. I've tried disabling every single add-on except for the filter and it still didn't work. I'll try a different browser.

3 years ago
Permalink

Comment has been collapsed.

Nah, I meant it's a pain to install a different browser, addons etc just to test stuff :) I'd like to fix it for you if I can.

3 years ago
Permalink

Comment has been collapsed.

Does it work for you on the profile page for example? There is a bug Tragikos discovered making it not work on the GA page when there are no pinned GAs.

3 years ago
Permalink

Comment has been collapsed.

I'm not sure what changed, but it works now. Thanks for the sweet add-on! In the past, I'd had to just use a manual search to try and find specific level giveaways.

3 years ago
Permalink

Comment has been collapsed.

I think you didn't have any pinned giveaways as well and since I fixed that, it works for you now :)

3 years ago
Permalink

Comment has been collapsed.

Sign in through Steam to add a comment.