Galkontinuum is a userscript which enables slideshow-style browsing of search results on the Booru family of sites.
It targets galleries running Gelbooru 0.2.x, Danbooru 2.x, Danbooru 1.x and compatible forks such as e621 and Moebooru.
Check dist/manifest.json for the current list of supported sites.
Each post's thumbnail element will now have two buttons placed over it as shown below. The upper button is the usual link to the post's page. The lower button loads this post in the media panel (described in the next section), without leaving the current page.
The media panel appears below the thumbnail list and provides controls to navigate through the sequence of results for the current search.
Navigation is across the entire result set — not limited to the current page.
- Toggle notes overlay
- Previous post
- Toggle scale mode (fit-to-screen / full-size)
- Next post
- Close media panel and return to thumbnail
- Unused
- Unused
- Link to post page
- Unused
- Toggle help/about panel
- Previous post
- Focus content (only appears over videos)
- Next post
- Release focus
When content is focused, hotkeys are disabled and overlay controls are hidden.
Notes appear as a set of transparent rectangles over the media. Hovering or tapping on them will reveal the caption.
Note areas scale proportionally | Caption tooltips stick to bottom edge |
---|---|
Key | Action |
---|---|
⇦ |
Previous post |
⇨ |
Next post |
esc |
Release focus / close media panel |
num0 |
Toggle scale mode (fit-to-screen / full-size) |
Viewing any post in the media panel will cause its corresponding page to be added/renewed in the browser's history.
For example, viewing post #1803204 on e621 will add
https://e621.net/post/show/1803204
to history.
Usability is good on Android running Firefox 68.0 (with Greasemonkey). Other environments are yet to be tested.
Rule34.xxx | Safebooru | e621 |
---|---|---|
- Firefox 56 or newer.
- Chrome 60 or newer.
Support for other browsers may be considered if requested.
-
Install a userscript manager such as Greasemonkey or Tampermonkey.
-
Visit dist/galkontinuum.user.js. You should be presented with an installation prompt.
Be aware that the script will not update automatically when installed this way.
-
Download the files dist/galkontinuum.user.js and dist/manifest.json into a new directory.
-
Visit
chrome://extensions
. -
Enable the Developer mode option and choose Load unpacked.
- Select the directory containing the downloaded files.
-
Navigating through results is only possible if they are ordered by ID (ascending or descending). Note that on Moebooru-based sites, the default order is by timestamp, not by ID — you can enable navigation by appending
order:id_desc
to your search terms. -
On Gelbooru-based sites, posts added within the last few minutes may fail to load due to the search database being out of sync with the main database.
-
On Danbooru-based sites, restricted posts might not be excluded when navigating through results, despite being hidden in the thumbnail list on the page. These will most likely fail to load. Working-around this issue is non-trival due to inadequacies in the
/post/index
API. -
On Danbooru-based sites, navigation may be hindered or impossible when the maximum number of search terms is used. For example, searches on e621 containing more than 6 terms will result in an error message stating "You can only search up to 6 tags at once". Therefore, when 6 search terms are used, navigation in one or both directions may fail due to inadequacies in the
/post/index
API requiring an additional tags to be inserted. -
Markup is not supported in note text.
-
On Danbooru-based sites, a maximum of 1000 notes will be shown on any single post. Currently the only post known to have over 1000 notes is #951241 on Danbooru.
-
Posts with an ID less than zero or greater than 2147483647 will not be recognised. It is unknown whether there are any boorus with IDs outside this range.