imgbrd-grabber

imgbrd-grabber is a powerful tool for downloading and managing images from multiple boorus and imageboards. Key capabilities include:

• Browsing: Multi-tab searches, results from multiple imageboards in one tab, tag auto-completion, tag blacklisting, and proxy support.
• Downloading: Bulk downloading, single image downloads via MD5 or ID, and a Command Line Interface (CLI).
• Customization: Adding custom imageboards, authentication for login-walled sources, and CSS theme support.
• Organization: Custom filename patterns, favorite/view-later tags, and support for saving directly to local boorus (e.g., Szurubooru, MyImouto, Gelbooru, Shimmie).

Grabber collects anonymous telemetry to inform development priorities. The following data points are sent, but no search queries, downloads, or personal content are ever transmitted:

• Screen resolution: Used to optimize UI layout and high-DPI support.
• Country and language: Used to prioritize translation efforts for the software and documentation.
• Operating system: Used to guide platform-specific testing and feature support.
• Grabber's version: Used to track version adoption and the usage of nightly builds.
• Startup event: Used to estimate active user counts and usage patterns.

The src directory contains the source code for all Grabber components. The project is built using CMake.

Main Projects:

• lib: The core library containing Grabber's logic.
• gui: The source code for the main Grabber graphical user interface.
• sites: Contains the individual plugins for each supported Grabber source.

Other Projects:

• cmake: CMake plugins used during the build process.
• cli: A command-line interface executable.
• crash-reporter: An executable designed to run when the GUI crashes.
• dist: Files used for packaging Grabber binaries.
• languages: Translation files for the GUI.

Tests:

• tests: Unit tests.
• e2e: End-to-end tests that utilize the CLI.

Monitors allow you to automatically download new images or receive notifications when new images appear for a specific search.

Important behavior notes:

• Incremental only: Monitors perform incremental checks. They only look for images uploaded since the last time the monitor ran. They do not perform full checks of the entire search history.
• Batch vs. Monitor: If you need to download all existing images for a search, use a batch download first. You can then set up a monitor to capture any images uploaded after the batch download completes.

If searched tags are missing from the local list, you can manually trigger a large download to update the tag list. Note that this is resource-intensive for the server.

Example command to download a large batch of tags to a file:

./grabber -c -s "danbooru.donmai.us" -i 1000 -m 250000 --tags-format "%tag" --tags-min 10 --return-pure-tags > tags.txt

To host a local Gelbooru instance, you need a local web server environment. On Windows, use WampServer.

1. Download WampServer from SourceForge.
2. Install it to a directory that does not require admin rights (e.g., C:\wamp).
3. Follow the installer prompts (default browser and email settings are acceptable).
4. Verify installation by checking for the green 'W' icon in the system tray and visiting http://localhost/.

To use imgbrd-grabber as a portable application (e.g., from a USB drive) without installation, you must consolidate the executable files and the settings into a single directory.

Follow these steps:

1. Locate your executable files (typically in C:/Program Files/Grabber).
2. Locate your settings folder (typically in C:/Users/%USERNAME%/AppData/Local/Bionus/Grabber or C:/Users/%USERNAME%/Grabber for older versions).
3. Copy the contents of both folders into a single new directory of your choice.

When searching for content from E-Hentai, you can use specific syntax to filter results:

• Basic Tag Search: Use space-separated tags (e.g., tag1 tag2) to find content matching multiple tags.
• Category Filtering: Use the cats:NUMBER syntax to filter by the f_cats URL parameter. The default value is 0 if no category is specified.

You can customize the Grabber UI by adding new Qt themes using CSS.

To add a theme:

1. Locate your Grabber configuration directory.
2. Navigate to the themes directory within it.
3. Create a new folder named after your theme.
4. Create a style.css file inside that folder and add your CSS rules.

Grabber uses Qt stylesheets for UI customization. For detailed syntax and available selectors, refer to the Qt stylesheet reference.

When using the Gelbooru (0.2) source in imgbrd-grabber, you can utilize specific search syntax supported by Gelbooru. For detailed information on available operators and syntax rules, refer to the official Gelbooru wiki.

https://gelbooru.com/index.php?page=wiki&s=view&id=26263