Sorts your download based on copyright/characters/skins (or other depending on choice)
Here is the complete text, preserving your rewrite exactly and inserting the explanation about the Auto button/Aliases where it fits best (right after "How it works").
TLDR: Fixes your download folder structure. handles skins, aliases, and crossovers automatically.
Full description:
I made this because I was tired of manually organizing my folders. I wanted it to sort files properly into folders like Overwatch/Tracer/img.png or Overwatch/Tracer/Adventurer/img.png without me doing it manually every time.
How it works:
When you click on a post, you'll see a new panel in the sidebar with a download button, some 2D/3D toggles, and a gear icon for settings. The script tries to check for 3d tags but sometimes it isn't tagged so the buttons will be highlighted, simply click on 2d if it's a 2d image tagged as 3d and click on 3d if a 3d image isn't tagged. If it's properly tagged the big button does it for you. The script remembers what you download, and if you delete it you can simply redownload (a dialogue will ask to be sure, userscripts cannot read disk).
Grouping Aliases (The "Auto" Button):
The goal of this tool is to put all aliases under one umbrella to stay organized. For example, if you are looking at Christine Watson from Being A Wife, she might have tags like christine_watson and christine_watson_(being_a_wife). You don't want split folders for that.
In the Settings (Rules tab), the Auto button tries to guess the Copyright and Character for you. You can map multiple tags to that single entry, ensuring they all save to the same clean folder.
1. Folder structure examples here is exactly how it saves files on your pc depending on the tags.
Downloads / Overwatch / Mercy / image.jpgDownloads / Overwatch / Mercy / Witch / image.jpgDownloads / Overwatch / Mercy / Witch & Black Cat / image.jpgDownloads / Marvel & Overwatch / Mercy & Scarlet Witch / image.jpgDownloads / Luna Snow / image.jpg2. Skins & variations You can separate skins. like if you want to save V from Cyberpunk generally, but have specific subfolders for Valerie or Vincent. I uploaded some pictures to go along with this section.
nyl_mercy), click it.Overwatch / Mercy / Nyl instead of just Mercy.3. filename patterns
you can change how the actual file is named using these variables:
%artist%, %character%, %copyright%, %id%, %md5%, %ext%
examples (using a fake MD5: a1b2c3d4...):
My setup (Artist + MD5):
Pattern: %artist% - %md5%.%ext%
Result: Sakimichan - a1b2c3d4....jpg
Detailed (All info):
Pattern: %copyright% - %character% by %artist% (%id%)
Result: Overwatch - Mercy by Sakimichan (123456).jpg
Simple (Just ID):
Pattern: %id%
Result: 123456.jpg
4. ignored lists in the settings, there are lists for ignored series/characters. this is important because people tag stuff like "Blizzard Entertainment" or "Unknown Character". the script ignores those so it can find the real series.
5. general settings (structure modes) in the first tab, you can change the folder layout. here is how the options look:
Full (Default):
keeps the universe folder.
Downloads / Overwatch / Mercy / image.jpg
Nested:
removes the universe folder, just keeps the character.
Downloads / Mercy / image.jpg
Flat:
removes all folders, just puts the character name in the filename (or a single folder). useful if you hate deep directories.
Downloads / Mercy / image.jpg
Separate 2D/3D:
if you turn this to "Split", it sorts by art type first.
Downloads / 3D / Overwatch / Mercy / image.jpg
Downloads / 2D / Overwatch / Mercy / image.jpg