A userscript for rule34.xxx. It adds a feed of the artists you follow, collections, search inside your favorites, a reworked search panel and post page, a download manager, statistics and themes, and it tidies the site's own pages. It runs in your browser on the site's pages, keeps all its data on your computer and has no server.
Screenshots here are taken on a local test page with grey boxes in place of pictures.
- What it adds
- Install
- Settings
- Themes
- Your data
- What the script does not do
- Every feature in detail
- FAQ
- Changelog
- Developer documentation
A short tour. Each item is described in full, with what it asks the site for and how to switch it off, in docs/features.md.
The site's long menu becomes three zones: Posts, Feed, Collections, Following, Favorites on the left, the site's other sections under More, and Statistics, My Account and RuleDesk (settings) as icons on the right. The header and the sidebar stay in place while you scroll. A number beside Feed says how many new posts are waiting.
Follow an artist, a character or a copyright with the button next to its tag. Feed is one grid with the posts of everyone you follow, newest first, with NEW marks and "Mark all seen". Following lists them as cards with a cover, a post count and a "new" mark; filter, sort, group, unfollow several at once.
- Custom: posts you pick, with the "+" on a thumbnail or a post, or several at once with "Select posts". Reordered by dragging. A post opened from one gets previous / next arrows through the collection
- Dynamic: a saved search. "Save as collection" in the search panel; "Check for new" tells which of them got new posts
Under the site's search field: the tags of the query as chips (click to exclude, cross to remove), Images / Videos, sort order, minimum score, AI posts on or off, Reset, "Save as collection", "Select posts".
The site cannot search favorites. After one Sync favorites, the Favorites page gets a column of filters beside the grid, as on Posts: search by tags (tag, -tag, ta*g, ( a ~ b )) with suggestions from your own favorites as you type, Images / Videos, endless scroll, Shuffle, Random post, and Select to remove several or add them to a collection.
Favorite, Collections, Vote, "I came", Original and Download as buttons; details and comments in two tabs; the site's own actions in one list. A click on a picture opens a zoom viewer. GIFs play on the page. The video player keeps volume and speed, toggles on a click and can fit the height or the width.
A favorite star and "+" on thumbnails, three sizes, infinite scroll, dimming of posts you opened, hiding of blacklisted posts, optional video preview on hover, a "GIF" label, folding tag groups in the sidebar, the wiki text of a tag on its "?".
Saves the original files of a custom collection, a whole search, picked posts or all your favorites into a folder in your browser's downloads, with a name you choose (rule34-<id> by default). A corner panel shows progress, Pause, Resume, Cancel. It needs your own API key from the site's account options page; a single post's Download button does not.
Counts of what you keep, the top tags of your favorites, and the numbers of your site profile, on one screen.
Forum: marks for new and updated topics, "New for me", "Mark all as read". Artists and Tags: Follow and "Save as collection" in each row. Upload: a drop zone with a preview, a tag count against the site's minimum, repeated tags dropped.
- Install Tampermonkey (recommended) or Violentmonkey.
- Open this link and confirm the installation: https://raw.githubusercontent.com/KazeKaze93/RuleDesk/main/dist/ruledesk-web.user.js
- In Tampermonkey open Dashboard → Settings → Security → Content Script API and choose UserScripts API Dynamic. Without it the site's original look flashes on every page load and pages open slower.
Updates arrive through the script manager from the same link. After an update reload the site's page: an open page keeps running the old version.
Header menu → the gear (RuleDesk). The sections are listed on the left, with a search over them.
| Section | What is there |
|---|---|
| Appearance | Theme and grid size; for the Custom theme a background picture |
| Header … Collections | A switch for each page feature, by the part of the site it changes. One switch over them, "Enable page tweaks", turns all of them off |
| Favorites | Favorite buttons in the grid; Sync favorites and Full resync |
| Downloads | Your API key and the file name of saved files |
| Blacklist | The site's tag blacklist for this browser |
| Data | Export and import of everything the script stores; when the last backup was made |
To get the untouched site back: Appearance → Site theme → Site default, and Page → turn off Enable page tweaks.
| Theme | What it is |
|---|---|
| Light, Dark | The script's own themes. The whole site is restyled. This is where the script looks the way it was designed |
| Custom | Light or Dark with your background picture |
| Site default, Site dark | The site's own look. The script restyles nothing of the site there; its additions are drawn in the site's colours and can look out of place beside the site's plain controls. Light, Dark or Custom is recommended |
- Collections, followed tags, marks and settings live in the script manager's storage, in this browser only. Nothing is sent anywhere
- Data → Export saves one JSON file; Import restores it (Merge adds to what you have, Replace overwrites). This is the only way to move to another browser
- The blacklist and the site theme are the site's own cookies and are not in the export. Neither is the API key
- The one request made without an action of yours is the counter beside Feed: the first page of the feed, at most once in 15 minutes. It has its own switch in the settings (RuleDesk)
- Otherwise the script reads the pages you open and makes a request only when you do something that needs one: favorite a post, sync favorites, start a download, type in a tag field, scroll for the next page, open a feed that spans several searches, press Refresh or Check for new, open Statistics (it reads your profile page, at most once in 15 minutes), click the "?" of a tag. Requests go one at a time with a pause
These come from the site, or from what a userscript is, and are not bugs.
- No background updates. Covers, counts and "new" marks change when you open a page or press Refresh / Check for new. The site refuses frequent requests
- No sync between browsers or devices. There is no server; use Export and Import
- It cannot show what the site does not give. No post dates in the grid, no avatars, no exact count for a search of several tags (shown as "12,516+")
- It does not touch your account. Login cookies are not read, account settings are not changed
- Files can only be saved into the browser's download folder
- "Too many requests". Refresh, Check for new and favorites sync stop at the first such answer from the site; wait a minute and start again
- A cover or a count for a followed tag or a collection appears after its page was opened once, or after Refresh
- When the site changes its pages, a feature on the changed page can stop working until the script is updated. The site itself keeps working
The full list is in docs/features.md; the technical one, with numbers, in docs/site.md.





