The script replace the normal search bar with new one whit autocomplete of tags.

I often use the search bar and write the complete definition of the tag each time is boring. To make faster and easier I made a script that allows me search the tag through the site api.

Here is the script: [github.com] https://github.com/ciccabanana/e-hentai-hel...-helper.user.js
There is some documentation: [github.com] https://github.com/ciccabanana/e-hentai-helper-suite/
For any issue: [github.com] https://github.com/ciccabanana/e-hentai-helper-suite/issues

Preview gif:


Features

• Compatible with Tampermonkey, Greasemonkey and Violentmonkey
• Autocomplete of tags using site API
• Delayed API request during typing and caching for avoid server restriction
• Possibility of save favorites tags as bookmarks
• Support the Exclusion `-` and the OR `~` operator See the ehwiki
  Supprot all qualifiers (tag, weak, title, uploader, uploaduid, gid, comment, favnote) (see below ↓ #Qualifiers)
• Fast autocomplete using category index (ignore case) (see below #Namespaces)
• Colored tags by qualifier or namespace (Color inspired by website colors of class i.e. color of class Doujinshi is used for female tags ecc...)
• Settings interface (see below ↓ #settings-ui-preview)
• Keyboard and mouse shortcut
• Fast loading, the script will load alongside the website
• No duplicate allowed.
• Works both in front page and favorites search bar.
• Works on both e-hentai and sadpanda.

Cache
This feature allows the program to save user's inputs and corresponding server responses by creating a cache. If the user re-enters the same input, the response is delivered more quickly from the cache, without needing to query the API again.
Users have the option to clear all cached data at any time or to remove only the data that is older than a specified number of days, with the ability to choose the number of days themselves.


Bookmarks
This feature allows users to save their favorite tags and access them quickly from a dropdown menu that appears beneath the search bar when it gains focus. Users can easily add or remove favorites either through the settings or directly while searching for a tag by clicking on the bookmark icon or using the Ctrl+B keyboard shortcut.
Favorites can be saved with full details, including Namespace, Qualifiers, Exclusion operators (-), and OR operators (~). The feature supports a maximum of 50 favorite tags, with the top 25 being displayed in the dropdown menu for quick access.
Users can also reorder their favorites through the settings using a simple drag-and-drop interface.


Namespaces: (For more info See the ehwiki)

• a: => artist
• c: => character
• co: => cosplayer
• f: => female
• g: => group
• l: => language
• m: => male
• x: OR mix: => mixed
• o: other
• p: => parody
• r: => reclass
• mis: => temp

Qualifiers: (For more info See the ehwiki)
⚠️ N.B. Only the qualifier "tag" and "weak" have the autocomplete feature.

• tg: => tag
• wk: => weak
• tt: OR ti: => title
• up: => uploader
• upd: => uploaduid
• gd: => gid
• m: => comment
• fv: OR fav: => favnote

Settings:


Shortcut:

• Dropdown
  • ↑ ↓ - Navigate the list
  • Ctrl+B - Add/Remove bookmarks
• Tag
  • Middle click on a tag will remove the tag
  • Left click will rotate between operator. Normal → Exclusion (-) → OR (~) → Normal

FQA:

• Q: Why a not an hardcoded cache or favorites?
  • A: Because if a user edit the code, for insert his favorites, the next update of the script will probably overwrite the changes done from the user. (It depends on with userscript managers the user use)

ToDo

• Settings interface Done
• Possibility of user to personalize tags color Done
• Support for Qualifiers "tag:" / "weak:" / "title:" / "uploader:" / "uploaduid:" / "gid:" / "comment:" / "favnote:" Done
• The possibility of change the keyboard shortcut
• An option for enable an automatic clear of expired data in the cache (If users request this feature)
• Compatibility to work in the insertion of new tags on the gallery page (Under evaluation)

Known bugs

• ...

Thanks to

• [github.com] yairEO For making Tagify, foundation on which I built this userscript
• [github.com] SortableJS For making the script that allow to reorder the bookmarks

This post has been edited by ciccabanana: Aug 18 2024, 23:24