Filter items and sigils in your inventory based on affixes, aspects and thresholds of their values. For questions, feature request or issue reports join the discord or use github issues.

• Filter items in inventory and stash
• Filter by item type and item power
• Filter by affix and their values
• Filter by aspects and their values
• Filter uniques and their affix and aspect values
• Filter sigils by blacklisting locations and affixes
• Supported resolutions: 1920x1080, 3840x1080, 2560x1080, 2560x1440, 3440x1440, 5120x1440, 2560x1600, 3840x1600, 3840x2160

• Font size can be small or medium (better tested on small) in the Gameplay Settings
• Game Language must be English

• Download the latest version (.zip) from the releases: https://github.com/aeon0/d4lf/releases
• Execute d4lf.exe and go to your D4 screen
• There is a small overlay on the center bottom with buttons:
  • max/min: Show or hide the console output
  • filter: Auto filter inventory and stash if open (number of stash tabs configurable)
  • vision: Turn vision mode (overlay) on/off
• Alternative use the hotkeys. e.g. f11 for filtering

• The tool does not play well with HDR as it makes everything super bright
• The advanced item comparision feature sometimes causes bad classifications. Better turn it off when using d4lf

The config folder contains:

• profiles/*.yaml: These files determine what should be filtered.
• params.ini: Different hotkey settings and number of chest stashes that should be looked at.
• game.ini: Settings regarding color thresholds and image positions. You dont need to touch this.

All items are whitelist filters. If a filter for an unique or a certain item type is not included in your .yaml filters, they will be discarded. All sigils are blacklist filted, meaning by default all sigils are good unless they match any of the blacklisted affixes. See more detailed descriptions below.

In your profile .yaml files any aspects can be added in the format of [ASPECT_KEY, THRESHOLD, CONDITION]. The condition can be any of [larger, smaller] and defaults to larger if no value is given. Smaller has to be used when the aspect go from high value to a lower value (eg. ‍Blood-bathed Aspect)

For example:

Aspects:
    # Filter for a perfect umbral
    - [of_the_umbral, 4]
    # Filter for any umbral
    - of_the_umbral

Aspect keys are lower case and spaces are replaced by underscore. You can find the full list of keys in assets/lang/enUS/aspect.json. If Aspects is empty, all legendary items will be kept.

Affixes have the same structure of [AFFIX_KEY, THRESHOLD, CONDITION] as described above. Additionally, it can be filtered by itemType, minPower and minAffixCount. See the list of affix keys in assets/lang/enUS/affixes.json. For items with inherent affixes inherentPool can be specified, then at least one of these has to match the inherent affixes on that item.

Affixes:
  # Search for armor and pants that have at least 3 affixes of the affixPool
  - NiceArmor:
      itemType: [armor, pants]
      minPower: 725
      affixPool:
        - [damage_reduction_from_close_enemies, 10]
        - [damage_reduction_from_distant_enemies, 12]
        - [damage_reduction, 5]
        - [total_armor, 9]
        - [maximum_life, 700]
      minAffixCount: 3

  # Search for boots that have at least 2 of the specified affixes and
  # either max evade charges or reduced evade cooldown as inherent affix
  - GreatBoots:
      itemType: boots
      minPower: 800
      inherentPool:
        - maximum_evade_charges
        - attacks_reduce_evades_cooldown
      affixPool:
        - [movement_speed, 16]
        - [cold_resistance]
        - [lightning_resistance]
      minAffixCount: 2

  # Search with "any_of" affixPool. Any of these will be ok, but they will only contribute
  # once to the overall matched affix count. Any affix on the item can only match once!
  # Example: We want to have boots with movement speed and 2 resistances from a pool of shadow, cold, lightning res
  - ResBoots:
      itemType: boots
      minPower: 800
      affixPool:
        - [movement_speed, 16]
        - any_of:
          - [shadow_resistance]
          - [cold_resistance]
          - [lightning_resistance]
        - any_of:
          - [shadow_resistance]
          - [cold_resistance]
          - [lightning_resistance]
      minAffixCount: 3

Uniques are identified by their aspect (see assets/lang/enUS/uniques.json). They also have an affixPool, but since uniques have these fixed you only need to specify the ones you want to threshold.

# Take all Tibault's Will pants that have item power > 900 and dmg reduction from close > 12 as well as aspect value > 25
Uniques:
  - aspect: [tibaults_will]
    minPower: 900
    affixPool:
      - [damage_reduction_from_close_enemies, 12]

Sigils are all ok unless they match any of the blacklisted locations or affixes. See all sigil locations and affixes here: assets/lang/enUS/sigils.json

Sigils:
  minTier: 40
  maxTier: 100
  blacklist:
    # locations
    - endless_gates
    - vault_of_the_forsaken

    # affixes
    - armor_breakers
    - resistance_breakers

D4LF will look for params.ini and for profiles/*.yaml also in C:/Users/WINDOWS_USER/.d4lf. All values in params.ini will overwrite the value from the param.ini in the D4LF folder. In the profiles folder additional custom profiles can be added and used.

This is helpful to make it easier to update to a new version as you dont need to copy around your config and profiles. In case there are breaking changes to the configuration there will be a major release. E.g. update from 2.x.x -> 3.x.x.

• Install miniconda

git clone https://github.com/aeon0/d4lf
cd d4lf
conda env create -f environment.yml
conda activate d4lf
python src/main.py

The CI will fail if the linter would change any files. You can run linting with:

conda activate d4lf
black .

To ignore certain code parts from formatting

# fmt: off
# ...
# fmt: on

# fmt: skip
# ...

Setup VS Code by using the black formater extension. Also turn on "trim trailing whitespaces" is VS Code settings.

• Icon based of: CarbotAnimations
• Some of the OCR code is originally from @gleed. Good guy.
• Names and textures for matching from Blizzard