Live Filtering - eliranwong/UniqueBible GitHub Wiki

Live filtering allows dynamically filtering the study window with regex patterns to only show verses that match the pattern.

Note: UBA currently only starts with one predefined filter. See the section "Example filter data" for filters that you can add.

Example usage

Do a search for savior by running "SEARCHALL:::KJV:::savior". This will list all the verses in the KJV with the word "savior" in it.

Open the live filter window.

Check the box for "Jesus" in the live filter window. It will now only show verses in the study window that has "Jesus", "Christ", or "messiah" in it.

Click on the "Add" button to add another filter. Enter "Lord" in the filter and "lord|king" in the pattern.

When you now check the "Jesus" and "Lord" filters, it will only show verses that match both of the selected filters.

Import filter file

You can import a filter file that defines multiple filters by clicking the "Import" button in the bottom right of the live filters window. Each line contains one filter entry and it would have the following format:

<filter name>:::<regex pattern>

Regex

The key element in the filtering is the regex pattern. It is up to your imagination on creating a regex pattern. If you come up with a good one, share it in the discussions area!

There are a lot of sites that explain about regex patterns. For example, see Regex cheat sheet for patterns you can search by.

You can enter any regex pattern that is up to 1000 characters.

Regex pattern matching is case-insensitive. For case-sensitive matching, surround it with single quotes (eg 'LORD|GOD').

The regex pattern is doing a pattern search between the <div> tags (which all verses in search results are contained in). So it is matching against HTML code and not just the rendered text. This can cause issues if you search for words such as "mouse", "click", "color". One way to fix this is to add a space to it: " mouse", " click", " color".

If you need to specify a \ character, you'll need to escape it with \\.

Example filters

Jesus Christ:::jesus|christ|messiah
Prayer:::pray|supplication|petition|request

Filtering by OT and NT books:

Books - OT:::<ref.*>Gen.*</ref>|<ref.*>Exod.*</ref>|<ref.*>Lev.*</ref>|<ref.*>Num.*</ref>|<ref.*>Deut.*</ref>|<ref.*>Josh.*</ref>|<ref.*>Judg.*</ref>|<ref.*>Ruth.*</ref>|<ref.*>1Sam.*</ref>|<ref.*>2Sam.*</ref>|<ref.*>1Kgs.*</ref>|<ref.*>2Kgs.*</ref>|<ref.*>1Chr.*</ref>|<ref.*>2Chr.*</ref>|<ref.*>Ezra.*</ref>|<ref.*>Neh.*</ref>|<ref.*>Esth.*</ref>|<ref.*>Job.*</ref>|<ref.*>Ps.*</ref>|<ref.*>Prov.*</ref>|<ref.*>Eccl.*</ref>|<ref.*>Song.*</ref>|<ref.*>Isa.*</ref>|<ref.*>Jer.*</ref>|<ref.*>Lam.*</ref>|<ref.*>Ezek.*</ref>|<ref.*>Dan.*</ref>|<ref.*>Hos.*</ref>|<ref.*>Joel.*</ref>|<ref.*>Amos.*</ref>|<ref.*>Obad.*</ref>|<ref.*>Jonah.*</ref>|<ref.*>Mic.*</ref>|<ref.*>Nah.*</ref>|<ref.*>Hab.*</ref>|<ref.*>Zeph.*</ref>|<ref.*>Hag.*</ref>|<ref.*>Zech.*</ref>|<ref.*>Mal.*</ref>
Books - NT:::<ref.*>Matt .*</ref>|<ref.*>Mark .*</ref>|<ref.*>Luke .*</ref>|<ref.*>John .*</ref>|<ref.*>Acts .*</ref>|<ref.*>Rom .*</ref>|<ref.*>1Cor .*</ref>|<ref.*>2Cor .*</ref>|<ref.*>Gal .*</ref>|<ref.*>Eph .*</ref>|<ref.*>Phil .*</ref>|<ref.*>Col .*</ref>|<ref.*>1Thess .*</ref>|<ref.*>2Thess .*</ref>|<ref.*>1Tim .*</ref>|<ref.*>2Tim .*</ref>|<ref.*>Titus .*</ref>|<ref.*>Phlm .*</ref>|<ref.*>Heb .*</ref>|<ref.*>Jas .*</ref>|<ref.*>1Pet .*</ref>|<ref.*>2Pet .*</ref>|<ref.*>1John .*</ref>|<ref.*>2John .*</ref>|<ref.*>3John .*</ref>|<ref.*>Jude .*</ref>|<ref.*>Rev .*</ref>

Filtering by a Strong's number:

Strongs Greek:::G\\d
Strongs Hebrew:::H\\d

Filtering by case-sensitive match:

LORD:::'GOD|LORD'
⚠️ **GitHub.com Fallback** ⚠️