commit

Known.txt

@@ -1,197 +1,14 @@
-Ada
+Hanabi intrusive
-Aeris
+Hanzo
-Alina
-Amara
-Anya
-Aria
-Artemis
-Ashe
-Astrid
-Asuka
-Athena
-Azura
-Belladonna
-Bianca
-C.C.
-Calla
-Camilla
-Cassia
-Celeste
-Chika
-Clara
-Delilah
-Dia
-Diana
-Eira
-Elara
-Eli
-Elise
-Elma
-Ember
-Erza
-Esme
-Evelyn
-Evie
-Fiora
-Freya
-Gasai
-Greta
-Hanayo
-Hancock
-Haruhi
-Hatsume
-Hawkeye
 Hinata
-Holo
+Jett
-Homura
-Ichigo
-Illya
-Inara
-Ino
-Isla
-Isolde
-Ivy
-Jeanne
-Jinx
-Jiro
-Juniper
-Juvia
-Kaelin
-Kagome
-Kagura
-Kaida
-Kairi
-Kali
-Kana
-Kanao
-Kanna
-Kiera
-Kikyo
-Kirari
-Korra
-Kotori
-Kurisu
-Kushina
-Kyoko
-Lan Fan
-Leona
-Levy
-Lilith
-Liora
-Lira
-Lisanna
-Lucia
-Lucoa
-Lucy
-Luna
-Lust
-Lyra
-Madoka
-Maia
 Makima
-Makise
+Rangiku - Page
-Makomo
-Mami
-Mari
-Marin
-Mary
-Mavis
-Mayuri
-Medusa
-Mei
-Merlin
-Mikasa
-Milly
-Mina
-Mion
-Mira
-Mirabel
-Misato
-Mitsuri
-Momo
-Morgana
-Nadia
-Nami
-Naomi
-Nelliel
-Nerissa
-Neve
-Nezuko
-Noelle
-Nova
-Nozomi
-Nunnally
-Nyx
-Ochaco
-Odette
-Ophelia
-Orihime
-Orla
-Perona
-Phoebe
-Raven
-Rei
 Reyna
-Rhea
+Sage
-Rika
+Yor
-Rin
-Rin Tohsaka
-Rinoa
-Ritsuko
-Riza
-Robin
-Rosalie
-Rowan
-Ruby
-Rukia
-Rumi
-Saber
-Sable
-Sakura
-Sakura Matou
-Sango
-Sansa
-Satoko
-Sayaka
-Scáthach
-Selene
-Seline
-Serena
-Shinobu
-Shion
-Shirley
-Sierra
-Skye
-Sophie
-Soraya
-Sylvia
-Talia
-Tamayo
-Tamsin
-Tashigi
-Tatiana
-Temari
-Thalia
-Tifa
-Toga
-Tohru
-Tsunade
-Umi
-Valeria
-Viola
-Violet
-Vivi
-Wendy
-Winry
-Wynne
-Yara
-Yazawa
 Yoruichi
-Yoshiko
+killjoy
-Yuki Nagato
+neon
-Yumeko
+power
-Yuna
+viper
-Yuno
-Zara
-Zelda
-Zero Two

readme.md

@@ -96,3 +96,52 @@ A feature-rich GUI application built with PyQt5 to download content from [Kemono
 
 ```bash
 pip install PyQt5 requests Pillow
+
+```
+
+This How it work
+📥 START DOWNLOAD
+│
+├── 🔍 Check Filter Settings
+│   ├── Character Filter (if any)
+│   └── Skip Words (posts/files)
+│
+├── 📂 Determine Folder Structure
+│   ├── Is "Separate Folders by Name/Title" Enabled?
+│   │   ├── YES:
+│   │   │   ├── Check Known Character List
+│   │   │   │   ├── If match in post title → use as folder name
+│   │   │   │   └── If no match → use post title (cleaned)
+│   │   │   └── Also check for fallback to creator name or "Misc"
+│   │   └── NO:
+│   │       └── Save all files to selected root folder
+│   │
+│   └── Is "Subfolder per Post" Enabled?
+│       └── YES: Append post ID or cleaned post title under base folder
+│
+├── 📑 File Filtering & Pre-Checks
+│   ├── Skip ZIP / RAR
+│   ├── File type check: Image / Video / Link
+│   └── Check for duplicates (hash or name)
+│
+├── 📘 Manga Mode Enabled?
+│   ├── YES:
+│   │   ├── Is Rename-to-Post-Title Toggle ON?
+│   │   │   ├── YES:
+│   │   │   │   ├── One image per post → Rename to: `<PostTitle>_001.jpg`
+│   │   │   │   ├── Multi-image post → Attempt sort by number or keep original
+│   │   │   │   └── Add log entry for files that kept original name
+│   │   │   └── NO:
+│   │   │       └── Keep all original filenames
+│   │   └── Sequence posts by upload date (oldest = page 1)
+│   │
+│   └── NO:
+│       └── Use default or filtered file name, skip renaming logic
+│
+├── ⏬ Download File(s)
+│   ├── Apply multithreading (if enabled)
+│   └── Retry logic for network failures
+│
+└── 📜 Log & Post Processing Summary
+    ├── Save summary per post (Downloaded/Skipped)
+    └── If Manga Mode: show renaming log for clarity