[GH-ISSUE #1406] FR: taking the rule engine to the next level #897

Open
opened 2026-03-02 11:53:34 +03:00 by kerem · 3 comments
Owner

Originally created by @thiswillbeyourgithub on GitHub (May 14, 2025).
Original GitHub issue: https://github.com/karakeep-app/karakeep/issues/1406

Describe the feature you'd like

Regarding links/text bookmarks: I'm suggesting the following new rule engine features:

To the "Whenever" section:
New:

  • An asset was added/removed to the bookmark
  • A highlight was added/removed to the bookmark

Enhancements:

  • Favourite -> A bookmark's Favourite status has changed
    • add the options "added to/removed from favourite"
    • same for archive
  • A bookmark is added to this list -> A bookmark is added to a list
    • and include an "Any list" option at the top (akin to wildcards)
  • This tag was added to a bookmark -> A tag was added to a bookmark
    • and add options "Any tag", "Any human tag", "Any AI tag"
    • Same for removing a tag

To the "If" section:

  • "contains archive": whether this bookmark has an "Archive" content (not sure if bookmarks can actually be missing this)
  • condition on the actual text content (i.e. the reader view content, which is the thing you can add highlights to)
    • matches regex
    • character count + greater/smaller than + int
    • word count greater/smaller than + int
    • line count greater/smaller than + int
  • same but for the raw html content (i.e. I think "archive" is not always available, hence the "contains archive")
  • "contains video": whether the bookmark contains a video
    • video length
    • video title
    • contains subtitle or not
  • "contains screenshot": whether the bookmark contains a screenshot

To the actions:

  • prepend/append to the reader view + some html
  • create new list/sublist/smartlist

Additionally:

  • I think the "Whenever" should be renamed "triggers" to make them easy to find in the code, documentation, api and discussion

Describe the benefits this would bring to existing Karakeep users

To me the most important is the rules pertaining to the textual content of bookmarks, as it would allow adding tags that dynamically adjust to the reading time of the article.
Also it's empowering users.

Can the goal of this request already be achieved via other means?

Not really, the rule engine has great potential but cannot for now do complex things

Have you searched for an existing open/closed issue?

  • I have searched for existing issues and none cover my fundamental request

Additional context

I would also be nice to add a "estimated reading time has changed" when #1079 is done

Originally created by @thiswillbeyourgithub on GitHub (May 14, 2025). Original GitHub issue: https://github.com/karakeep-app/karakeep/issues/1406 ### Describe the feature you'd like Regarding links/text bookmarks: I'm suggesting the following new rule engine features: To the "Whenever" section: New: - An asset was added/removed to the bookmark - A highlight was added/removed to the bookmark Enhancements: - Favourite -> A bookmark's Favourite status has changed - add the options "added to/removed from favourite" - same for archive - A bookmark is added to this list -> A bookmark is added to **a** list - and include an "Any list" option at the top (akin to wildcards) - This tag was added to a bookmark -> A tag was added to a bookmark - and add options "Any tag", "Any human tag", "Any AI tag" - Same for removing a tag To the "If" section: - "contains archive": whether this bookmark has an "Archive" content (not sure if bookmarks can actually be missing this) - condition on the actual text content (i.e. the reader view content, which is the thing you can add highlights to) - matches regex - character count + greater/smaller than + int - word count greater/smaller than + int - line count greater/smaller than + int - same but for the raw html content (i.e. I think "archive" is not always available, hence the "contains archive") - "contains video": whether the bookmark contains a video - video length - video title - contains subtitle or not - "contains screenshot": whether the bookmark contains a screenshot To the actions: - prepend/append to the reader view + some html - create new list/sublist/smartlist Additionally: - I think the "Whenever" should be renamed "triggers" to make them easy to find in the code, documentation, api and discussion ### Describe the benefits this would bring to existing Karakeep users To me the most important is the rules pertaining to the textual content of bookmarks, as it would allow adding tags that dynamically adjust to the reading time of the article. Also it's empowering users. ### Can the goal of this request already be achieved via other means? Not really, the rule engine has great potential but cannot for now do complex things ### Have you searched for an existing open/closed issue? - [x] I have searched for existing issues and none cover my fundamental request ### Additional context I would also be nice to add a "estimated reading time has changed" when #1079 is done
Author
Owner

@Fmstrat commented on GitHub (Jun 24, 2025):

Seconding the raw archive HTML content. A good example of this is I have a list called Lemmy. I'd like to know of the HTML content contains "join-lemmy.org" and if so, add it to the Lemmy list.

<!-- gh-comment-id:2999794836 --> @Fmstrat commented on GitHub (Jun 24, 2025): Seconding the raw archive HTML content. A good example of this is I have a list called Lemmy. I'd like to know of the HTML content contains "join-lemmy.org" and if so, add it to the Lemmy list.
Author
Owner

@hamidtech commented on GitHub (Nov 30, 2025):

I really enjoyed the video rules section.
I hope it becomes available soon!

<!-- gh-comment-id:3592229099 --> @hamidtech commented on GitHub (Nov 30, 2025): I really enjoyed the video rules section. I hope it becomes available soon!
Author
Owner

@thiswillbeyourgithub commented on GitHub (Dec 29, 2025):

As per issue 1423 : if #2302 gets merged we need to be able to track the reading progress in the rule engine.

<!-- gh-comment-id:3696517163 --> @thiswillbeyourgithub commented on GitHub (Dec 29, 2025): As per [issue 1423](https://github.com/karakeep-app/karakeep/issues/1423#issuecomment-3694306637) : if #2302 gets merged we need to be able to track the reading progress in the rule engine.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/karakeep#897
No description provided.