animepic-utils 0.0.2 → 0.0.4

package/dist/image-utils.d.ts

@@ -71,5 +71,13 @@ export default class ImageUtils {
      * Adds the _p, _s, _g, or _c qualifier to images
      */
     static changeQualifiers: (folder: string, qualifier?: "p" | "s" | "g" | "c") => void;
+    /**
+     * Reverse searches the image to find danbooru post.
+     */
+    static reverseDanbooruSearch: (filepath: string, minSimilarity?: number) => Promise<any[]>;
+    /**
+     * Attempts to recover arbitrarily named posts from danbooru, if they exist.
+     */
+    static recoverFromDanbooru: (folder: string) => Promise<void>;
 }
 export {};

package/dist/image-utils.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -7,12 +40,14 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const sharp_1 = __importDefault(require("sharp"));
 const waifu2x_1 = __importDefault(require("waifu2x"));
+const cheerio = __importStar(require("cheerio"));
 class ImageUtils {
     /**
      * Fixes incorrect image extensions. It must be correct to preview on mac.
      */
     static fixFileExtensions = async (folder) => {
-        const files = fs_1.default.readdirSync(folder).filter((f) => f !== ".DS_Store");
+        const files = fs_1.default.readdirSync(folder).filter((f) => f !== ".DS_Store")
+            .sort(new Intl.Collator(undefined, { numeric: true, sensitivity: "base" }).compare);
         for (const file of files) {
             let filepath = path_1.default.join(folder, file);
             if (fs_1.default.lstatSync(filepath).isDirectory())
@@ -29,7 +64,8 @@ class ImageUtils {
      * Copies images to the destination (unchanged)
      */
     static copyImages = (sourceFolder, destFolder) => {
-        const files = fs_1.default.readdirSync(sourceFolder).filter((f) => f !== ".DS_Store");
+        const files = fs_1.default.readdirSync(sourceFolder).filter((f) => f !== ".DS_Store")
+            .sort(new Intl.Collator(undefined, { numeric: true, sensitivity: "base" }).compare);
         for (const file of files) {
             let src = path_1.default.join(sourceFolder, file);
             if (fs_1.default.lstatSync(src).isDirectory())
@@ -42,7 +78,8 @@ class ImageUtils {
      * Moves images to the destination
      */
     static moveImages = (sourceFolder, destFolder) => {
-        const files = fs_1.default.readdirSync(sourceFolder).filter((f) => f !== ".DS_Store");
+        const files = fs_1.default.readdirSync(sourceFolder).filter((f) => f !== ".DS_Store")
+            .sort(new Intl.Collator(undefined, { numeric: true, sensitivity: "base" }).compare);
         for (const file of files) {
             let src = path_1.default.join(sourceFolder, file);
             if (fs_1.default.lstatSync(src).isDirectory())
@@ -163,7 +200,8 @@ class ImageUtils {
      * Processes an image folder with a custom chain of operations.
      */
     static processImages = async (folder, ...operations) => {
-        const files = fs_1.default.readdirSync(folder).filter((f) => f !== ".DS_Store");
+        const files = fs_1.default.readdirSync(folder).filter((f) => f !== ".DS_Store")
+            .sort(new Intl.Collator(undefined, { numeric: true, sensitivity: "base" }).compare);
         let i = 1;
         for (const file of files) {
             console.log(`${i}/${files.length}  -> ${file}`);
@@ -239,7 +277,8 @@ class ImageUtils {
      * Adds the _p, _s, _g, or _c qualifier to images
      */
     static changeQualifiers = (folder, qualifier = "p") => {
-        const files = fs_1.default.readdirSync(folder).filter((f) => f !== ".DS_Store");
+        const files = fs_1.default.readdirSync(folder).filter((f) => f !== ".DS_Store")
+            .sort(new Intl.Collator(undefined, { numeric: true, sensitivity: "base" }).compare);
         for (const file of files) {
             const { name, ext } = path_1.default.parse(file);
             const match = name.match(/(_s|_p|_g|_c!?)(\d+)?$/);
@@ -253,5 +292,144 @@ class ImageUtils {
             fs_1.default.renameSync(src, dest);
         }
     };
+    /**
+     * Reverse searches the image to find danbooru post.
+     */
+    static reverseDanbooruSearch = async (filepath, minSimilarity = 75) => {
+        const buffer = new Uint8Array(fs_1.default.readFileSync(filepath)).buffer;
+        const form = new FormData();
+        form.append("file", new Blob([buffer], { type: "image/png" }));
+        const html = await fetch("https://iqdb.org/", { method: "POST", body: form }).then((r) => r.text());
+        const $ = cheerio.load(html);
+        let result = [];
+        let downloadLinks = [];
+        let promises = [];
+        const appendDanbooru = async (link) => {
+            const json = await fetch(`${link}.json`).then((r) => r.json());
+            result.push(json);
+        };
+        const appendZerochanDownload = async (link) => {
+            const json = await fetch(`${link}?json`).then((r) => r.json());
+            downloadLinks.push(json.full);
+        };
+        const appendGelbooruDownload = async (link) => {
+            let baseURL = `https://gelbooru.com/index.php?page=dapi&s=post&q=index&json=1&id=`;
+            const result = await fetch(`${baseURL}${link.match(/\d+/)?.[0]}`).then((r) => r.json());
+            downloadLinks.push(result.post[0]?.file_url);
+        };
+        const appendSafebooruDownload = async (link) => {
+            let baseURL = `https://safebooru.org//index.php?page=dapi&s=post&q=index&json=1&id=`;
+            const result = await fetch(`${baseURL}${link.match(/\d+/)?.[0]}`).then((r) => r.json());
+            downloadLinks.push(result[0]?.file_url);
+        };
+        const appendYandereDownload = async (link) => {
+            console.log(link.match(/\d+/)?.[0]);
+            const result = await fetch(`https://yande.re/post.json?tags=id:${link.match(/\d+/)?.[0]}`).then((r) => r.json());
+            downloadLinks.push(result[0]?.file_url);
+        };
+        const appendKonachanDownload = async (link) => {
+            const result = await fetch(`https://konachan.com/post.json?tags=id:${link.match(/\d+/)?.[0]}`).then((r) => r.json());
+            downloadLinks.push(result[0]?.file_url);
+        };
+        $("#pages > div").each((i, el) => {
+            let link = ($(el).find("a").first().attr("href") || "").replace(/^\/\//, "http://").replace("http://", "https://");
+            let link2 = ($(el).find("a").last().attr("href") || "").replace(/^\/\//, "http://").replace("http://", "https://");
+            const textTds = $(el).find("td").filter((_, td) => $(td).children("img").length === 0)
+                .map((_, td) => $(td).text().trim()).get();
+            const similarity = parseFloat(textTds.find(text => /% similarity$/.test(text)) || "");
+            if (similarity > minSimilarity) {
+                if (link.includes("danbooru.donmai.us"))
+                    promises.push(appendDanbooru(link));
+                if (link.includes("zerochan.net"))
+                    promises.push(appendZerochanDownload(link));
+                if (link2.includes("gelbooru.com"))
+                    promises.push(appendGelbooruDownload(link));
+                if (link2.includes("safebooru.org"))
+                    promises.push(appendSafebooruDownload(link));
+                if (link.includes("yande.re"))
+                    promises.push(appendYandereDownload(link));
+                if (link.includes("konachan.com"))
+                    promises.push(appendKonachanDownload(link));
+            }
+        });
+        await Promise.allSettled(promises);
+        if (result.length === 1) {
+            if (!result[0].file_url)
+                result[0].file_url = downloadLinks[0];
+        }
+        return result;
+    };
+    /**
+     * Attempts to recover arbitrarily named posts from danbooru, if they exist.
+     */
+    static recoverFromDanbooru = async (folder) => {
+        const original = path_1.default.join(folder, "original");
+        const pixiv = path_1.default.join(folder, "pixiv");
+        const twitter = path_1.default.join(folder, "twitter");
+        const comic = path_1.default.join(folder, "comic");
+        const unrecoverable = path_1.default.join(folder, "unrecoverable");
+        if (!fs_1.default.existsSync(original))
+            fs_1.default.mkdirSync(original);
+        this.moveImages(folder, original);
+        const files = fs_1.default.readdirSync(original).filter((f) => f !== ".DS_Store")
+            .sort(new Intl.Collator(undefined, { numeric: true, sensitivity: "base" }).compare);
+        for (const file of files) {
+            const pixivID = file.match(/\d+/)?.[0];
+            let result = [];
+            if (pixivID)
+                result = await fetch(`https://danbooru.donmai.us/posts.json?tags=pixiv_id%3A${pixivID}&limit=1000`).then((r) => r.json());
+            if (!result.length)
+                result = await this.reverseDanbooruSearch(path_1.default.join(original, file));
+            if (result.length) {
+                let isComic = false;
+                for (const json of result) {
+                    if (json.tag_string.includes("comic"))
+                        isComic = true;
+                }
+                for (const json of result) {
+                    let filename = path_1.default.basename(json.source);
+                    if (json.source.includes("twitter.com") || json.source.includes("x.com")) {
+                        filename = `twitter_${filename}.${json.file_ext}`;
+                    }
+                    const downloadLink = json.file_url;
+                    if (!downloadLink) {
+                        if (!fs_1.default.existsSync(unrecoverable))
+                            fs_1.default.mkdirSync(unrecoverable);
+                        let src = path_1.default.join(original, file);
+                        let dest = path_1.default.join(unrecoverable, file);
+                        fs_1.default.copyFileSync(src, dest);
+                    }
+                    else {
+                        const buffer = await fetch(downloadLink).then((r) => r.arrayBuffer());
+                        if (json.source.includes("twitter.com") || json.source.includes("x.com")) {
+                            if (!fs_1.default.existsSync(twitter))
+                                fs_1.default.mkdirSync(twitter);
+                            let dest = path_1.default.join(twitter, filename);
+                            fs_1.default.writeFileSync(dest, new Uint8Array(buffer));
+                        }
+                        else if (isComic) {
+                            if (!fs_1.default.existsSync(comic))
+                                fs_1.default.mkdirSync(comic);
+                            let dest = path_1.default.join(comic, filename);
+                            fs_1.default.writeFileSync(dest, new Uint8Array(buffer));
+                        }
+                        else {
+                            if (!fs_1.default.existsSync(pixiv))
+                                fs_1.default.mkdirSync(pixiv);
+                            let dest = path_1.default.join(pixiv, filename);
+                            fs_1.default.writeFileSync(dest, new Uint8Array(buffer));
+                        }
+                    }
+                }
+            }
+            else {
+                if (!fs_1.default.existsSync(unrecoverable))
+                    fs_1.default.mkdirSync(unrecoverable);
+                let src = path_1.default.join(original, file);
+                let dest = path_1.default.join(unrecoverable, file);
+                fs_1.default.copyFileSync(src, dest);
+            }
+        }
+    };
 }
 exports.default = ImageUtils;

package/dist/pics.js

@@ -6,6 +6,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 require("dotenv/config");
 const image_utils_1 = __importDefault(require("./image-utils"));
 const start = async () => {
-    console.log(image_utils_1.default.changeQualifiers("./downloads", "g"));
+    // await imageUtils.recoverFromDanbooru(process.env.FOLDER!)
+    await image_utils_1.default.moepicsProcess(process.env.FOLDER);
+    // imageUtils.changeQualifiers(process.env.FOLDER!, "c")
 };
 start();

package/image-utils.ts

@@ -2,6 +2,7 @@ import fs from "fs"
 import path from "path"
 import sharp from "sharp"
 import waifu2x, {Waifu2xOptions} from "waifu2x"
+import * as cheerio from "cheerio"
 
 type Formats = "jpg" | "png" | "webp" | "avif" | "jxl"
 
@@ -19,6 +20,7 @@ export default class ImageUtils {
      */
     public static fixFileExtensions = async (folder: string) => {
         const files = fs.readdirSync(folder).filter((f) => f !== ".DS_Store")
+        .sort(new Intl.Collator(undefined, {numeric: true, sensitivity: "base"}).compare)
         for (const file of files) {
             let filepath = path.join(folder, file)
             if (fs.lstatSync(filepath).isDirectory()) continue
@@ -36,6 +38,7 @@ export default class ImageUtils {
      */
     public static copyImages = (sourceFolder: string, destFolder: string) => {
         const files = fs.readdirSync(sourceFolder).filter((f) => f !== ".DS_Store")
+        .sort(new Intl.Collator(undefined, {numeric: true, sensitivity: "base"}).compare)
         for (const file of files) {
             let src = path.join(sourceFolder, file)
             if (fs.lstatSync(src).isDirectory()) continue
@@ -49,6 +52,7 @@ export default class ImageUtils {
      */
     public static moveImages = (sourceFolder: string, destFolder: string) => {
         const files = fs.readdirSync(sourceFolder).filter((f) => f !== ".DS_Store")
+        .sort(new Intl.Collator(undefined, {numeric: true, sensitivity: "base"}).compare)
         for (const file of files) {
             let src = path.join(sourceFolder, file)
             if (fs.lstatSync(src).isDirectory()) continue
@@ -178,6 +182,7 @@ export default class ImageUtils {
     public static processImages = async (folder: string, 
         ...operations: Array<(file: string) => Promise<string>>) => {
         const files = fs.readdirSync(folder).filter((f) => f !== ".DS_Store")
+        .sort(new Intl.Collator(undefined, {numeric: true, sensitivity: "base"}).compare)
         let i = 1
         for (const file of files) {
             console.log(`${i}/${files.length}  -> ${file}`)
@@ -274,6 +279,7 @@ export default class ImageUtils {
      */
     public static changeQualifiers = (folder: string, qualifier: "p" | "s" | "g" | "c" = "p") => {
         const files = fs.readdirSync(folder).filter((f) => f !== ".DS_Store")
+        .sort(new Intl.Collator(undefined, {numeric: true, sensitivity: "base"}).compare)
         for (const file of files) {
             const {name, ext} = path.parse(file)
 
@@ -290,4 +296,136 @@ export default class ImageUtils {
             fs.renameSync(src, dest)
         }
     }
+
+    /**
+     * Reverse searches the image to find danbooru post.
+     */
+    public static reverseDanbooruSearch = async (filepath: string, minSimilarity = 75) => {
+        const buffer = new Uint8Array(fs.readFileSync(filepath)).buffer
+
+        const form = new FormData()
+        form.append("file", new Blob([buffer], {type: "image/png"}))
+
+        const html = await fetch("https://iqdb.org/", {method: "POST", body: form}).then((r) => r.text())
+        const $ = cheerio.load(html)
+
+        let result = [] as any[]
+        let downloadLinks = [] as string[]
+        let promises = [] as Promise<void>[]
+
+        const appendDanbooru = async (link: string) => {
+            const json = await fetch(`${link}.json`).then((r) => r.json())
+            result.push(json)
+        }
+
+        const appendZerochanDownload = async (link: string) => {
+            const json = await fetch(`${link}?json`).then((r) => r.json())
+            downloadLinks.push(json.full)
+        }
+        const appendGelbooruDownload = async (link: string) => {
+            let baseURL = `https://gelbooru.com/index.php?page=dapi&s=post&q=index&json=1&id=`
+            const result = await fetch(`${baseURL}${link.match(/\d+/)?.[0]}`).then((r) => r.json())
+            downloadLinks.push(result.post[0]?.file_url)
+        }
+        const appendSafebooruDownload = async (link: string) => {
+            let baseURL = `https://safebooru.org//index.php?page=dapi&s=post&q=index&json=1&id=`
+            const result = await fetch(`${baseURL}${link.match(/\d+/)?.[0]}`).then((r) => r.json())
+            downloadLinks.push(result[0]?.file_url)
+        }
+        const appendYandereDownload = async (link: string) => {
+            console.log(link.match(/\d+/)?.[0])
+            const result = await fetch(`https://yande.re/post.json?tags=id:${link.match(/\d+/)?.[0]}`).then((r) => r.json())
+            downloadLinks.push(result[0]?.file_url)
+        }
+        const appendKonachanDownload = async (link: string) => {
+            const result = await fetch(`https://konachan.com/post.json?tags=id:${link.match(/\d+/)?.[0]}`).then((r) => r.json())
+            downloadLinks.push(result[0]?.file_url)
+        }
+
+        $("#pages > div").each((i, el) => {
+            let link = ($(el).find("a").first().attr("href") || "").replace(/^\/\//, "http://").replace("http://", "https://")
+            let link2 = ($(el).find("a").last().attr("href") || "").replace(/^\/\//, "http://").replace("http://", "https://")
+            const textTds = $(el).find("td").filter((_, td) => $(td).children("img").length === 0)
+                .map((_, td) => $(td).text().trim()).get()
+            const similarity = parseFloat(textTds.find(text => /% similarity$/.test(text)) || "")
+
+            if (similarity > minSimilarity) {
+                if (link.includes("danbooru.donmai.us")) promises.push(appendDanbooru(link))
+
+                if (link.includes("zerochan.net")) promises.push(appendZerochanDownload(link))
+                if (link2.includes("gelbooru.com")) promises.push(appendGelbooruDownload(link))
+                if (link2.includes("safebooru.org")) promises.push(appendSafebooruDownload(link))
+                if (link.includes("yande.re")) promises.push(appendYandereDownload(link))
+                if (link.includes("konachan.com")) promises.push(appendKonachanDownload(link))
+            }
+        })
+
+        await Promise.allSettled(promises)
+        if (result.length === 1) {
+            if (!result[0].file_url) result[0].file_url = downloadLinks[0]
+        }
+        return result
+    }
+
+    /**
+     * Attempts to recover arbitrarily named posts from danbooru, if they exist.
+     */
+    public static recoverFromDanbooru = async (folder: string) => {
+        const original = path.join(folder, "original")
+        const pixiv = path.join(folder, "pixiv")
+        const twitter = path.join(folder, "twitter")
+        const comic = path.join(folder, "comic")
+        const unrecoverable = path.join(folder, "unrecoverable")
+        if (!fs.existsSync(original)) fs.mkdirSync(original)
+
+        this.moveImages(folder, original)
+
+        const files = fs.readdirSync(original).filter((f) => f !== ".DS_Store")
+        .sort(new Intl.Collator(undefined, {numeric: true, sensitivity: "base"}).compare)
+        for (const file of files) {
+            const pixivID = file.match(/\d+/)?.[0]
+            let result = [] as any[]
+            if (pixivID) result = await fetch(`https://danbooru.donmai.us/posts.json?tags=pixiv_id%3A${pixivID}&limit=1000`).then((r) => r.json())
+            if (!result.length) result = await this.reverseDanbooruSearch(path.join(original, file))
+            if (result.length) {
+                let isComic = false
+                for (const json of result) {
+                    if (json.tag_string.includes("comic")) isComic = true
+                }
+                for (const json of result) {
+                    let filename = path.basename(json.source)
+                    if (json.source.includes("twitter.com") || json.source.includes("x.com")) {
+                        filename = `twitter_${filename}.${json.file_ext}`
+                    }
+                    const downloadLink = json.file_url
+                    if (!downloadLink) {
+                        if (!fs.existsSync(unrecoverable)) fs.mkdirSync(unrecoverable)
+                        let src = path.join(original, file)
+                        let dest = path.join(unrecoverable, file)
+                        fs.copyFileSync(src, dest)
+                    } else {
+                        const buffer = await fetch(downloadLink).then((r) => r.arrayBuffer())
+                        if (json.source.includes("twitter.com") || json.source.includes("x.com")) {
+                            if (!fs.existsSync(twitter)) fs.mkdirSync(twitter)
+                            let dest = path.join(twitter, filename)
+                            fs.writeFileSync(dest, new Uint8Array(buffer))
+                        } else if (isComic) {
+                            if (!fs.existsSync(comic)) fs.mkdirSync(comic)
+                            let dest = path.join(comic, filename)
+                            fs.writeFileSync(dest, new Uint8Array(buffer))
+                        } else {  
+                            if (!fs.existsSync(pixiv)) fs.mkdirSync(pixiv)
+                            let dest = path.join(pixiv, filename)
+                            fs.writeFileSync(dest, new Uint8Array(buffer))
+                        }
+                    }
+                }
+            } else {
+                if (!fs.existsSync(unrecoverable)) fs.mkdirSync(unrecoverable)
+                let src = path.join(original, file)
+                let dest = path.join(unrecoverable, file)
+                fs.copyFileSync(src, dest)
+            }
+        }
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "animepic-utils",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Node.js utils for processing anime images",
   "main": "dist/image-utils.js",
   "types": "dist/image-utils.d.ts",
@@ -9,7 +9,11 @@
     "clean": "del-cli ./dist",
     "prepublishOnly": "tsc"
   },
-  "keywords": ["anime", "image", "utils"],
+  "keywords": [
+    "anime",
+    "image",
+    "utils"
+  ],
   "author": "Moebytes",
   "license": "MIT",
   "devDependencies": {
@@ -19,6 +23,7 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
+    "cheerio": "^1.1.2",
     "sharp": "^0.34.4",
     "waifu2x": "^1.5.1"
   }

package/pics.ts

@@ -2,7 +2,9 @@ import "dotenv/config"
 import imageUtils from "./image-utils"
 
 const start = async () => {
-    console.log(imageUtils.changeQualifiers("./downloads", "g"))
+    // await imageUtils.recoverFromDanbooru(process.env.FOLDER!)
+    await imageUtils.moepicsProcess(process.env.FOLDER!)
+    // imageUtils.changeQualifiers(process.env.FOLDER!, "c")
 }
 
 start()

package/readme.md

@@ -1,4 +1,11 @@
-## Animepic Utils
+<div align="left">
+  <p>
+    <img src="https://github.com/Moebytes/animepic-utils/blob/main/title.png?raw=true" width="700" />
+  </p>
+  <p>
+    <a href="https://nodei.co/npm/animepic-utils/"><img src="https://nodei.co/npm/animepic-utils.png" /></a>
+  </p>
+</div>
 
 Some utilities for processing anime images. (However I guess it'll work for any images).
 
@@ -28,7 +35,17 @@ import imageUtils from "animepic-utils"
 await imageUtils.fixFileExtensions(folder)
 ```
 
-### Moepictures specific
+### Anime specific
+
+The function `recoverFromDanbooru` takes a folder of arbitrarily named images and attempts to recover 
+the original pixiv/twitter files from the largest mirror site, danbooru. Files which are unrecoverable 
+will be put in an "unrecoverable" folder, usually because it wasn't found on danbooru. 
+
+```ts
+import imageUtils from "animepic-utils"
+
+await imageUtils.recoverFromDanbooru(folder)
+```
 
 The function `moepicsProcess` takes a folder of anime images and will generate the compressed 
 and upscaled versions that are suitable to upload to my website, https://moepictures.moe. 
@@ -54,8 +71,9 @@ await imageUtils.changeQualifiers(folder, "g")
 
 These are the full list of qualifiers:
 
-- `_s` or none - Uploads images seperately without any grouping
+- `_s` or none - Uploads images seperately
 - `_p` - Joins images together into one post as variations
 - `_g` - Uploads images seperately but adds them to the same group
-- `_c` - Adds images as child posts to the first in a set (`_c0`)
+- `_g!` - Adds the image as a *variation* to the previous group post
+- `_c` - Adds images as child posts to the first in the set (`_c0`)
 - `_c!` - Adds the image as a *variation* to the previous child post