Filtration ♦ Item Filter Script Editor ♦ [ v1.1.0 ] ♦ Updated 2018-12-06

When Item Filters were announced, Jonathan from GGG stated "As you can see, the array of UI options that we would have to provide to allow the specific filtering requirements of every player would be completely impractical."

Challenge accepted.

Introducing Filtration, a Path of Exile item filter script editor.

Filtration aims to be a full featured item filter script editor, allowing you to not only create new item filters, but edit existing ones too - no code editing required.

The application gives a concise overview of item filter scripts, including previews of how the name plates will look in-game.


How do I get it?

You can download Filtration and/or download the source from the GitHub page at

Filtration is fully open source under the GPL license.

Frequently Asked Questions

When I load an existing item filter some of comments aren't displayed

Filtration uses a specific marker for Section comments (comments between filter blocks), only comments in between blocks that start with # Section: are loaded as section comments. This was a design decision taken to save having to decide what to do with multiple comments in between blocks.

How can I make my script fully compatible with Filtration's features?
There is detailed information about how Filtration parses item filter scripts, and the syntax you need to use for Block Groups and Sections at the Notes for Script Creators wiki page

Scripts with Filtration Block Group Support
If your script is compatible with Filtration's Block Group Browser, let me know and I'll add it here.

Antnee's Classy Item Filter for Distinguished Exiles
One Filter to rule them all by Muldini
Sayya's Item Filter
Didii's Item Filter
MaskedChimp's Item Filter

Recent Changes

2018-12-06 - 1.1.0

♦ Added support for new Prophecies block item type
♦ Added Betrayal League Item Base Types and Item Classes to static data
♦ All open filter scripts are now remembered on exit and reopened when the application is started rather than just the last opened one (#95)
♦ Filter sections are once again now expanded by default when scripts are opened, unless the new "Auto-expand all sections when opening scripts" setting is disabled
♦ A new Clear Styles button has been added which removes all styles from the selected block (#96)
♦ New buttons for adding/removing DisableDropSound from all selected blocks have been added (#110)
♦ The Enable/Disable Block toggle button is now visible on both the Regular Block Items and Appearance Block Items views
♦ When there are too many block items to fit horizontally in a block a horizontal scrollbar will now appear
♦ Fixed an issue with MinimapIcon block items causing an "Unused Theme Components" message box to erroneously be shown when saving (#116)
♦ Fixed the Advanced tab in the Color Picker in the Theme Editor not being clickable (#115)
♦ Fixed the previously incorrect handling of DisableDropSound as a true/false value when in fact it is enabled/disabled purely by its presence or lack thereof in a block (#111)
♦ Fixed the application freezing for a long period of time when Ctrl+A (Select All) is performed
♦ Fixed the Switch to Appearance/Regular Block Items text overlapping block items
♦ Fixed theme saving (blank theme files were being saved) (#83)
♦ Fixed checkboxes in Block Group Browser (#97)
♦ Fixed the Select Path of Exile data directory dialog appearing after every upgrade (#94)
♦ Fixed an issue where custom sounds were only populated from the default Path of Exile data directory rather than the configured directory
♦ Clean installs no longer prompt to select the Path of Exile data directory if the default directory exists

2018-10-01 - 1.0.3

♦ Added missing AlertSound mp3 resources to installer
♦ Fixed a crash related to performing certain commands with no blocks selected
♦ Added extra logging to updater

2018-09-30 - 1.0.2

♦ Fixed crash on exit

2018-09-30 - 1.0.1

♦ Fixed the Block Output Preview pane not working
♦ The Block Output Preview pane now supports previewing multiple selected blocks
♦ The Block Output Preview pane now supports selecting the text within it

2018-09-30 - 1.0.0

This is the first release of Filtration using the new installer - you will need to manually uninstall any existing install of Filtration 0.20 or earlier.

Filtration has now finally moved to version 1.0.0 and has a new installer which has fully a integrated auto updater meaning no more manual downloads of new releases (it uses the same framework that Discord uses for seamless updates).

Filtration's versioning never really made sense since it just went from 0.1 upwards - from this release we are moving to using semantic versioning. Feature releases will change the second part of the version, and bug fixes will change the last part of the version. So for example a bug fix to version 1.0.0 would be 1.0.1, but a new feature release would be 1.1.0.

2018-09-30 - 1.0.0

New Features
♦ Implemented copying and pasting of multiple blocks (multiple blocks can be selected by holding the Ctrl and/or Shift keys while clicking)
♦ Added Expand All, Collapse All, and Clear All Filters buttons to the Block Group Browser
♦ It is now possible to add/remove Block Groups from blocks (there is a new text box and a + button on each block in the editor)
♦ The Block Group browser now has an additional column of checkboxes which enables block groups to be enabled/disabled as well as shown/hidden
♦ Implemented a new auto-update mechanism - previous versions of Filtration will need to be manually uninstalled
♦ The state (maximised/restored) and size of the application window is now remembered
♦ The visibility of the Section Browser, Block Group Browser, and Block Output Preview tool panes is now remembered
♦ The last active script is now re-opened on when the application is launched

Bug Fixes / Improvements
♦ Fixed incorrect filtering behavior in the Block Group Browser
♦ Increased the maximum value of Quality block items to 30 from 20
♦ Changed default opacity of colours to 240 from 255
♦ MinimapIcon preview icons have been improved in appearance and now have a transparent background
♦ Fixed an issue where several section-related commands didn't correctly mark the script as unsaved
♦ Increased the HasExplicitMod block item limit from 1 to 8 since it is possible to use up to 8 of these blocks together to only match items that have an explicit mod from all HasExplicitMod block items within a block
♦ Changed the default colours of TextColor, BorderColor and BackgroundColor block items to sensible defaults instead of 100% transparent

Once again, thanks to Halil and GlenCFL for contributions to this release.

Bugs / Issues

Please raise a bug report on the Filtration GitHub page for any bugs that you find.

You can also find me on #filtration under the nick XVar.
Creator of Filtration, a Path of Exile Item Filter Editor
Last edited by AtomYcX on Dec 6, 2018, 5:09:08 PM
Last bumped on Dec 6, 2018, 6:42:38 PM
I will try it out, ty for that work!

"Nerdstube, deutsche Path of Exile Community"
Asiabox: "Ist das so!"
Bumped, because this seriously needs more attention.

I'm having my coffee now, and just tinkering with this. It's fucking excellent. When I have a bit of time, I am going to try to recreate my script using your tool, and I think that will provide a solid basis for me to give you some feedback.

One thing I noticed right away is that the item previews could use some work. I use subtle borders in my filter, and because the field color of the program is so bright, they are washed out completely. I would suggest (just throwing this out there) a black or gray (or otherwise dark) border, something like this:

This is obviously a quick n dirty example, but you get the idea. It's very difficult to do anything subtle because the surrounding colors are so bright.

Great work!
A comprehensive, easy on the eyes loot filter:

Need a chill group exiles to hang with? Join us:
Hey, thanks for the feedback :)

That's a very good point about the preview borders, I hadn't noticed that. I've made a quick tweak - the border now has 3px padding around it so the image behind (which is an image of some ground tiles from in-game) shows through around the edge.

Is that what you had in mind? It does make light borders much more visible. It'll be in the next release - probably later today.
Creator of Filtration, a Path of Exile Item Filter Editor

I added this to your reddit post as well, but one feature I'd like to request is the ability to toggle show/hide by just clicking (or right-clicking) the show/hide box, without using the dropdown.

Reason being, I have gear-specific blocks in my script, and it would be great to be able to tell people "just open it in FFF, and click whatever boxes you wish to see/hide."

I hope that makes sense. I'm going to add a link to your program in my loot filter post, if you don't mind!
A comprehensive, easy on the eyes loot filter:

Need a chill group exiles to hang with? Join us:
Last edited by Antnee on Jun 7, 2015, 6:26:55 AM
Psst..that's not my Reddit post :) That's another editor, the one written in AHK. I didn't post this to Reddit yet as I'd rather get it a bit more polished and iron out any glaring bugs before unleashing it to the masses.

I'll have a look into toggling Show/Hide - it shouldn't be too difficult to implement.

And yeah no worries at all about adding a link to it in your filter post.
Creator of Filtration, a Path of Exile Item Filter Editor
Whoa, holy shit... I didn't even bother to look at the reddit links, because I assumed it was the same thing!
A comprehensive, easy on the eyes loot filter:

Need a chill group exiles to hang with? Join us:
Good job! Looks promising. Like Antnee, +1 to have a Show/Hide direct toggle, say, on right click.
This needs more visibilty.
Another quality ZAP! post.
Completed 8 Challengeshondana wrote:
Good job! Looks promising. Like Antnee, +1 to have a Show/Hide direct toggle, say, on right click.

Thanks! The Show/Hide toggle will be in a release later today, I implemented it earlier when Antnee suggested it. I don't want to make a release for every feature that's added, I'd rather batch a few up and do at most one release per day (apart from releases for show stopping bugs).
Creator of Filtration, a Path of Exile Item Filter Editor

Report Forum Post

Report Account:

Report Type

Additional Info