This script automates the process of adding volumes in Kapowarr and includes an interactive user interface for managing searches. Below is a detailed explanation of how to customize and use the script.
Customization
Modify the Base URL:
The variable kapowarr_url at the beginning of the script specifies the base URL of your Kapowarr instance. Update it to match your server’s URL.
Example:
const kapowarr_url = "https://your-kapowarr-instance.com";
This ensures that all actions performed by the script are directed to the correct instance.
Toggle Marvel-Only Mode:
The variable marvel_only determines whether the search includes the suffix &p=Marvel.
Set it to true to restrict searches to Marvel volumes.
Set it to false to remove this restriction.
Example:
const marvel_only = false; // Allows generic searches without the Marvel filter
Update the URL Matching:
The @match directive ensures the script runs on the correct pages of your Kapowarr instance. Modify it to match the /add* page of your server.
Example:
// @match https://your-kapowarr-instance.com/add*
OR
// @match https://your-kapowarr-instance.com/*
User Interface
The script includes an interactive interface that appears in the bottom-right corner of the screen. This interface allows you to manage and execute searches seamlessly. Here's how to use it:
Enter Searches:
Use the provided text box to enter your searches. Enter one search query per line.
Save Searches:
After entering your searches, click the Save button. This will update the list of searches displayed below.
Interactive Search List:
The list of searches allows you to:
Activate/Deactivate: Use the checkboxes next to each search to activate or deactivate them. Only active searches will be executed.
Set the Current Search: Click on a search in the list to make it the current search. It will be highlighted in blue.
Navigate Searches:
Use the Next → button to move to the next active search. The script will automatically execute the selected search.
How the Automation Works
When you click on a search result (a button with the search-entry class), the script waits for the form to load, then:
Checks the Start search for missing volume checkbox.
Selects the Normal Volume option in the dropdown menu.
Clicks the Add Volume button.
After completing the form, the script automatically transitions to the next search in the list and executes it.
This script is designed to simplify and streamline volume management in Kapowarr while offering full customization and user-friendly search management. Happy automating! 😊
