Filter Management

The Filter system allows you to block or replace songs. You can create filters that apply to specific parsers or all parsers at once.

To access: Settings (in popup) → Manage Filters

Filter Types

Block Filters

Prevent songs from being displayed. When a song matches your filter criteria, it will be ignored.

Replace Filters

Modify song information before sending to Discord. You can change the artist name, title, or both when a song matches your criteria.

---

Creating a Filter

Step 1: Open the Filter Form

• Click the "+ Add New Filter" button
• The form will expand, showing all available options

Step 2: Choose Filter Mode

• Block – Prevents matching songs from being displayed
• Replace – Modifies song information before sending to Discord

Step 3: Add Song Entries

• Enter the Artist and/or Title you want to filter
• Leave either field empty to match any value (wildcard)
• For Replace mode, specify the replacement artist/title
• Click "Add Entry" to add multiple songs to the same filter

Quick Fill Option: Click "Fill with Current Song" to automatically populate the form with the currently playing song.

Step 4: Select Parsers

• Choose which parsers this filter applies to by toggling the switches
• Enable "Applies to All Parsers" to apply the filter universally
• When "All Parsers" is enabled, individual parser selections are disabled

Step 5: Save the Filter

• Click "Save" to create your filter
• Click "Cancel" to discard changes

---

Quick Block Current Song

For faster blocking, use the "Block Current Song" button at the top of the filter section:

• Instantly blocks the currently playing song
• The song is automatically added to an existing block filter for that parser, or creates a new one if needed
• No need to open the filter form

---

Filter Matching Rules

Rule	Behavior	Example
Wildcard matching	Leave artist or title empty to match any value	Empty artist = matches any artist
Case insensitive	Matching ignores case	"Artist Name" matches "artist name" and "ARTIST NAME"
Exact matching	Filters match exact strings, not partial	To block "Song (Remix)", you must specify the full title including "(Remix)"