forked from archive/hydruscompanion
Hydrus browser extension
- JavaScript 48%
- HTML 30.9%
- CSS 21.1%
| themes | ||
| background.js | ||
| common.js | ||
| content.js | ||
| cubism4.min.js | ||
| global.css | ||
| help_advanced.html | ||
| help_basic.html | ||
| help_changelog.html | ||
| help_license.html | ||
| help_reference.html | ||
| icon200.png | ||
| LICENSE.txt | ||
| live2dcubismcore.min.js | ||
| manifest.json | ||
| offscreen.html | ||
| offscreen.js | ||
| options.html | ||
| options.js | ||
| options_and_help_page.css | ||
| pixi.min.js | ||
| popup.html | ||
| popup.js | ||
| README.md | ||
| sakura.css | ||
| sakura.js | ||
| snowstorm.js | ||
| theming.js | ||
| unsafe-eval.min.js | ||
| utilities.html | ||
| utilities.js | ||
Hydrus Companion
Browser extension for Hydrus / Hydownloader
Main features
- Highly configurable
- Displays page status on toolbar icon (see below for more info)
- Context menus for sending current page/link/image to Hydrus, optionally with tags (predefined or user input) and to specific target page
- Looking up images on IQDB and/or SauceNao and automatically sending results to Hydrus
- Sending current tab, all tabs, tabs to the left/right, tabs matching URL/title filter to Hydrus
- Send links to Hydrus by hovering + pressing shortcut
- Send all links from selection to Hydrus
- 100% user-defined, highly customizable menu and shortcut system
- Highlight links/images already in Hydrus
- Look up images on various reverse image search sites
- Supports using multiple Hydrus clients and switching between them
Installation
Download the latest version of the extension from the releases page
Basic setup - connecting the extension to Hydrus
- Enable the client API in Hydrus under services > manage services > client api: the 'run the client api?' needs to be ticked
- Navigate to your client API under services > review services
- Click add > manually on the client API
- Tick all the boxes (or at least the 'add urls for processing' permission for basic functionality)
- Copy the API access key into Hydrus Companion's options page and save it
Note on menu configuration
The default menu configuration mainly serves as an example. It is not intended to be used as is. You should review and customize it as you see fit. See the documentation included with the extension for details.
Shortcuts
Shortcuts are not configured in Hydrus Companion's options page, but in the browser-wide extension shortcut page. Use the gear menu on the Extensions page and select the 'Manage Extension Shortcuts' item.
Page status info
Various status messages may appear on the toolbar icon:
- No status text: no connection to Hydrus or the current tab has invalid URL
- ???: Hydrus does not recognize this URL
- Post: Hydrus recognizes this URL as a post page
- File: Hydrus recognizes this URL as a file URL
- Gall: Hydrus recognizes this URL as a gallery page
- Watch: Hydrus recognizes this URL as a watcher page
- Checkmark with green background: there are one or more files in your Hydrus with this URL ("you already have this")
- X with red background: there are one or more deleted files in your Hydrus with this URL ("you deleted this")
- Checkmark and X with yellow background: there are both deleted and non-deleted files with this URL in your Hydrus (can happen with e.g. pixiv posts with multiple images, where you keep some but also delete some images from the same post)
License
GPLv3+.