Philter, the inventory cleanup script

This is the "home" thread for Philter. Report bugs, give hugs, and discuss features.
We recently renamed from "OCD-Cleanup" to "Philter". For details, see the separate thread or the GitHub issue. A migration guide will be available soon.

Philter is an inventory cleanup script. It is a fork of @Bale's OCD Inventory Control.
Philter lives in GitHub, under the wings of Loathing Associates Scripting Society.

What does it do? How do I get it?​

Philter purges (i.e. "filters") junk in your inventory. Mallsell, autosell, pulverize, you name it. It's great for cleaning up items you accumulated during ascension, a dungeon run, or a day of farming.

To install Philter, enter the following into the KoLmafia gCLI:
svn checkout

Philter can live side-by-side with OCD Inventory Control, but you may run into some issues. In this case, you can uninstall OCD Inventory Control. Don't worry, you won't lose your data.
svn delete bale-ocd

Philter uses the same files and configs used by OCD Inventory Control, so your migration should be uneventful. If your scripts or aliases were using OCD Inventory Control.ash, modify them to use ocd-cleanup.ash instead.

So it's a copy of Bale's OCD? What's wrong with the old one?​

Nothing! You can continue to use OCD Inventory Control if you want.

However, Bale has not been around us for a while. OCD Inventory Control has been collecting subtle and dangerous bugs (example). Eventually, a KoL change made it unusable without a (pretty simple) fix. This motivated us to create a fork which became OCD-Cleanup.

I thought it was named "OCD-Cleanup"? Why rename it again? And why "Philter"?​

Yes, it was! After receiving multiple requests, we decided to move away from the old name which included ableist language. Check out user opinions at the rename thread.

We held a poll to select and/or suggest a new name. The poll was advertised here, over on GitHub, and as messages within the Manager UI itself.

Renaming the script will break my workflow!​

We're trying hard to make it as painless as possible for everyone involved. More updates will be posted here, with technical details available on the GitHub issues board.

What's with the "alpha" page?​

It's the new relay UI for Philter! I've been working on replacing the old UI for a while. Although it's far from complete, I felt it was ready for a preview.

The old UI will stay around until we're confident that the new one is just as good, if not better. Expect updates within the next few weeks. Please report bugs and request features here (or on GitHub)!
Last edited: