Skip to content
BranchesTags

Latest commit

 

History

146 Commits

Folders and files

NameName
Last commit message
Last commit date
clip_tokenizer
clip_tokenizer
 
 
core
core
 
 
docs
docs
 
 
screenshots
screenshots
 
 
ui
ui
 
 
.gitignore
.gitignore
 
 
Albedolizer.spec
Albedolizer.spec
 
 
CHANGELOG.md
CHANGELOG.md
 
 
LICENSE
LICENSE
 
 
LICENSE-LUTwithBGrid.txt
LICENSE-LUTwithBGrid.txt
 
 
NotoSansSC-VariableFont_wght.ttf
NotoSansSC-VariableFont_wght.ttf
 
 
README.md
README.md
 
 
THIRD_PARTY_NOTICES.md
THIRD_PARTY_NOTICES.md
 
 
blur_env.py
blur_env.py
 
 
check_types.py
check_types.py
 
 
clip_model.py
clip_model.py
 
 
config.py
config.py
 
 
env.png
env.png
 
 
env_blur.png
env_blur.png
 
 
icon.ico
icon.ico
 
 
icon.png
icon.png
 
 
image_processor.py
image_processor.py
 
 
installer.iss
installer.iss
 
 
lut_model.py
lut_model.py
 
 
lutwithbgrid_fivek.onnx
lutwithbgrid_fivek.onnx
 
 
main.py
main.py
 
 
main.spec
main.spec
 
 
manual.html
manual.html
 
 
pbr_generator.py
pbr_generator.py
 
 
realism.py
realism.py
 
 
requirements.txt
requirements.txt
 
 
settings.py
settings.py
 
 
translations.py
translations.py
 
 
viewer.py
viewer.py
 
 
viewer.spec
viewer.spec
 
 

Repository files navigation

Albedolizer

PBR Albedo Checker & Optimizer — a tool for checking, correcting, and generating PBR maps from Albedo textures.

Version Platform License Python

🇷🇺 Русская версия ниже

What is it

Albedolizer is a tool for 3D artists, game designers, and anyone working with PBR textures. It checks Albedo maps against standards, automatically corrects color via an AI model, generates a full set of PBR maps, packs them for a target engine, and lets you preview the result in a built-in 3D viewer.

Add-ons

Albedolizer is also available right inside Blender, Unity and Godot — same engine, same result, free.

Albedolizer-Blender

Free Blender add-on that generates 7 PBR maps from Albedo textures directly in the N-Panel. AI correction, 50 presets, seamless, batch, auto-wired Principled BSDF nodes, engine packing.

Albedolizer-Unity

Free Unity Editor add-on that generates PBR maps and auto-creates URP/Lit materials with proper channel packing (R=Metallic, G=AO, A=Smoothness). Supports HDRP / Unreal / Godot packing.

Albedolizer-Godot

Free Godot Editor add-on that generates PBR maps and auto-creates StandardMaterial3D with proper channel packing (R=Metallic, G=AO, A=Smoothness).

Screenshots

Main UI

What's new in v1.7.6-beta

Chinese localization

  • Full Simplified Chinese UI (中文) — every button, tab, header, dialog, and log message translated
  • Segmented language switcher in header — RU | EN | 中文 chips, active one highlighted
  • Auto-detect system language on first launch — ru / zh / en picked from Windows UI locale
  • Fallback to English if the saved language is unknown or invalid
  • Chinese manual — full HTML guide now in RU / EN / 中文
  • NotoSansSC font bundled for correct CJK rendering, with system fallback

Batch processing fixes

  • Critical fix: double-clicking Batch / PBR Batch / Compress Batch no longer spawns parallel runs and corrupts output files. Added batch_running, compress_batch_running, pbr_batch_running flags.
  • Memory leak fix: worker pool instead of asyncio.gather — only N coroutines alive at once, not len(files)
  • Memory leak fix: explicit del + gc.collect() after each file, in a finally block
  • Memory leak fix: LUTwithBGridModel is now a singleton, loaded once per session, not per file
  • Log panel optimization: no more full ListView rebuild on every line — only appends/removes one ft.Text
  • Thread pool capped at 4 workers + cv2.setNumThreads(1) — keeps CPU and RAM stable on big batches

Changed

  • config.py cleaned up — dead "emoji" field removed from TEXTURE_PROFILES and PROFILE_CATEGORIES
  • All 50 presets and 7 categories now have Chinese translations
  • System requirements updated — 16 GB RAM minimum, 32 GB recommended

Features

Albedo Analysis

  • Dark and light pixel check against standards for each texture type
  • Problem zone visualization (heatmap)
  • Detailed statistics: min / max / avg / median / percentiles
  • Soap removal — adaptive unsharp mask that fixes blurry patches after AI correction or upscaling

AI Auto-Correction

  • Three methods: Autolevels (XCiT model), LUTwithBGrid (ECCV 2024, ONNX), or Math (CLAHE + soft-clip)
  • Switch models in the sidebar — pick what works best for your texture
  • Material auto-detection — CLIP-based classifier (ViT-B/32) automatically picks the right preset from 50 options
  • Fallback dialog if AI result doesn't pass validation
  • Saturation boost — fix washed-out colors after AI correction

PBR Map Generation

  • Height — height map
  • Normal — normals (Sobel-based)
  • AO — ambient occlusion
  • Roughness — surface roughness (procedural or custom map, 4-signal advanced)
  • Metallic — metalness (black / white / custom map / color pick)
  • ORM — packed map (AO in R, Roughness in G, Metallic in B)
  • Edge — edge map (Sobel via OpenCV)
  • Per-map bit depth — each map in its own 8/16-bit PNG

Engine Export

  • Unity HDRP Mask Map — R=Metallic, G=AO, B=Detail Mask, A=Smoothness
  • Unity URP MetallicSmoothness — R=Metallic, G=AO, A=Smoothness
  • Unreal ORM — R=AO, G=Roughness, B=Metallic
  • Godot ORM — R=AO, G=Roughness, B=Metallic
  • Normal map format — OpenGL (Y+) / DirectX (Y-) with green channel flip
  • Detail Mask for HDRP — white (1.0) / edge map / custom loaded from disk
  • Channel preview — R / G / B / A / RGB / RGBA
  • Source: current PBR result or a folder with *_albedo.png, *_normal.png, *_ao.png, etc.

Realism Filter

  • Procedural photorealism — adds camera-like imperfection to albedo textures
  • Grain — fine and coarse noise layers
  • Detail — adaptive high-pass overlay for micro-detail
  • Variation — large-scale color/brightness patches + subtle vignette
  • Tileable noise — noise pattern can be tiled without visible seams
  • Presets — Soft / Medium / Hard one-click

Built-in 3D Viewer

  • Real-time PBR preview via OpenGL (viewer.exe)
  • 4 shapes: Sphere / Cylinder / Cube / Plane
  • Substance-style lighting — key + fill + rim, ACES tone mapping, exposure slider
  • Tiling panel — click X/Y buttons in the window to change texture scale (1×1 to 16×16)
  • Rotate with LMB, zoom with mouse wheel
  • Powered by Moderngl + GLFW + ImGui
  • HDRI environment lighting with blurred reflections
  • Viewer UI language follows the app language

Built-in Manual

  • Full HTML manual with screenshots and annotations
  • Russian / English / Chinese — switch inside the manual (RU / EN / 中文 buttons, remembers your choice)
  • Opens in your browser from the Info → Manual button

50 Texture Presets in 7 Categories

Metal · Nature · Mineral · Synthetic · Fabric · Special · Fauna

Batch Processing

  • Process folders or file lists
  • Two modes: AI correction or compression
  • Threads slider — control parallelism (1–8)
  • Progress bar with ETA

Themes & Modes

  • Dark and light theme with one-click toggle
  • Simple / Advanced modes — one-click workflow or full control
  • Tiling checker (3×3 preview) to spot seams

Interface

  • Russian / English / Chinese with auto-detection
  • Interactive preview with zoom (0.5x–8x)
  • Global hotkeys — Ctrl+O, Ctrl+S, Ctrl+R, Ctrl+Z, Space, Enter
  • Last opened folder is remembered across sessions
  • Settings persistence — all key options saved to config.json

Installation

Installer (recommended)

  1. Download Albedolizer_Setup_v1.7.6-beta.exe from the latest release
  2. Run the installer — it places everything in Program Files\Albedolizer
  3. Launch from Start Menu or Desktop shortcut

System Requirements

Parameter Minimum Recommended
OS Windows 10 (64-bit) Windows 11 (64-bit)
RAM 16 GB 32 GB
CPU 4 cores 8+ cores
GPU not required NVIDIA for 3D viewer
Disk 2 GB free SSD, 5+ GB

Important about memory:

  • 16 GB — comfortable work with textures up to 4K, single-file processing.
  • 32 GB — batch processing of 8K textures, parallel threads, AI models.
  • 8 GB — the app will start, but processing 4K/8K textures may cause freezes and MemoryError. Not recommended.

From source

git clone https://github.com/invisiblelevel/Albedolizer.git
cd Albedolizer
pip install -r requirements.txt
python main.py

Usage

Single file processing

  1. Pick a texture type on the right (e.g. Wood)
  2. Click Open and select an Albedo texture
  3. Click Check — you'll see stats and heatmap
  4. If FAIL → Auto-Correct (AI + fallback)
  5. Save the result
  6. Original / Result — toggle preview between original and corrected

PBR generation + 3D preview

  1. PBR tab
  2. Load Albedo
  3. Pick a preset (sliders auto-tune)
  4. Adjust sliders if needed
  5. Optional: Metal → By color → pick on Albedo
  6. Generate → 7 maps
  7. Switch between maps with buttons on top — right panel changes per map
  8. 3D Preview — opens the OpenGL viewer
  9. Save all — creates a <name>_pbr/ folder

Engine Export

  1. Engine tab
  2. From current PBR (uses your last generated maps) or Load from folder
  3. Pick engine: Unity HDRP / URP / Unreal / Godot
  4. Pick normal map format: OpenGL (Y+) or DirectX (Y-)
  5. For HDRP — pick Detail Mask: white / edge / custom
  6. Pack — see the packed map in the preview
  7. Switch channels: R / G / B / A / RGB / RGBA
  8. Save all — creates <name>_<engine>_<gl|dx>/

Realism filter

  1. Realism tab
  2. Open — load a texture
  3. Click preset: Soft / Medium / Hard
  4. Or adjust three sliders manually: grain, detail, variation
  5. Apply — see the result in the preview
  6. Save the result

Batch processing

  1. Batch tab
  2. Select folder or Select files
  3. Choose correction method (Autolevels / LUTwithBGrid / Math) on the right
  4. Set threads count (1–8)
  5. Run processing
  6. Output goes to _corrected folder next to sources

Compression

  1. Compress tab
  2. Open for single file, or Select folder for batch
  3. Choose 8-bit or 16-bit PNG on the right
  4. Compress or Compress folder
  5. Output to _compressed folder next to sources
  6. After save — see size delta: 12.4 MB → 8.1 MB (−4.3 MB, −34.7%)

Manual

Click Info in the header → Manual tab.

Tech Stack

Credits

  • LUTwithBGrid (ECCV 2024) — Wontae Kim, Nam Ik Cho — Apache 2.0
  • GIMP tile-seamless (1997) — Tim Rowley — GPL (algorithm ported)
  • Lucide — icon set (ISC License)
  • Noto Sans SC — Chinese font (SIL Open Font License)

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you'd like to change.

License

MIT — free to use, including in commercial projects.

Author: INV.LVL
Version: 1.7.6-beta
Date: 2026



Albedolizer

PBR Albedo Checker & Optimizer — утилита для проверки, коррекции и генерации PBR-карт из Albedo-текстур.

Что это

Albedolizer — инструмент для 3D-художников, геймдизайнеров и всех, кто работает с PBR-текстурами. Он проверяет Albedo-карты на соответствие стандартам, автоматически корректирует цвет через AI-модель, генерирует полный набор PBR-карт, упаковывает их под конкретный движок и позволяет посмотреть результат во встроенном 3D-вьюере.

Аддоны

Albedolizer также доступен прямо внутри Blender, Unity и Godot — тот же движок, тот же результат, бесплатно.

Albedolizer-Blender

Бесплатный Blender-аддон, который генерирует 7 PBR-карт из Albedo прямо в N-панели. AI-коррекция, 50 пресетов, seamless, batch, автосборка нод к Principled BSDF, упаковка под движки.

Albedolizer-Unity

Бесплатный Unity Editor-аддон, который генерирует PBR-карты и автосоздаёт URP/Lit материалы с правильной упаковкой каналов (R=Metallic, G=AO, A=Smoothness). Поддержка HDRP / Unreal / Godot.

Albedolizer-Godot

Бесплатный Godot Editor-аддон, который генерирует PBR-карты и автосоздаёт StandardMaterial3D с правильной упаковкой каналов (R=Metallic, G=AO, A=Smoothness).

Что нового в v1.7.6-beta

Китайская локализация

  • Полный перевод UI на упрощённый китайский (中文) — все кнопки, вкладки, хедер, диалоги и лог
  • Сегментированный переключатель языка в хедере — чипы RU | EN | 中文, активный подсвечен
  • Автоопределение языка системы при первом запуске — ru / zh / en из локали Windows
  • Fallback на английский при неизвестном языке в конфиге
  • Китайский мануал — полный HTML-гайд теперь на RU / EN / 中文
  • Шрифт NotoSansSC встроен для корректного отображения CJK, с fallback на системный

Фиксы батч-обработки

  • Критичный фикс: двойной клик по Batch / PBR Batch / Compress Batch больше не запускает параллельные процессы и не ломает файлы. Добавлены флаги batch_running, compress_batch_running, pbr_batch_running.
  • Фикс утечки памяти: пул воркеров вместо asyncio.gather — одновременно живёт N корутин, а не len(files)
  • Фикс утечки памяти: явное del + gc.collect() после каждого файла в блоке finally
  • Фикс утечки памяти: LUTwithBGridModel теперь singleton, грузится один раз за сессию, а не на каждый файл
  • Оптимизация лог-панели: больше нет полной перерисовки ListView на каждую строку — только добавление/удаление одного ft.Text
  • Thread pool ограничен 4 воркерами + cv2.setNumThreads(1) — CPU и RAM стабильны на больших батчах

Изменено

  • config.py очищен — мёртвое поле "emoji" убрано из TEXTURE_PROFILES и PROFILE_CATEGORIES
  • Все 50 пресетов и 7 категорий получили китайский перевод
  • Системные требования обновлены — 16 ГБ минимум, 32 ГБ рекомендуется

Возможности

Анализ Albedo

  • Проверка тёмных и светлых пикселей по стандартам для каждого типа текстуры
  • Визуализация проблемных зон (heatmap)
  • Детальная статистика: min / max / avg / median / перцентили
  • Устранение «мыла» — адаптивный unsharp mask, чинит размытые участки после AI-коррекции

AI-автокоррекция

  • Три метода: Autolevels (модель XCiT), LUTwithBGrid (ECCV 2024, ONNX) или Math (CLAHE + soft-clip)
  • Переключай модели в сайдбаре — выбирай что лучше для твоей текстуры
  • Автоопределение материала — CLIP-классификатор (ViT-B/32) сам подбирает пресет из 50 доступных
  • Диалог выбора если AI не прошёл валидацию
  • Насыщенность — фикс блеклых цветов после AI-коррекции

Генерация PBR-карт

  • Height — карта высот
  • Normal — нормали (на основе Sobel)
  • AO — ambient occlusion
  • Roughness — шероховатость (процедурная или своя карта, 4-сигнальный advanced)
  • Metallic — металличность (чёрная / белая / своя карта / по цвету)
  • ORM — упакованная карта (AO в R, Roughness в G, Metallic в B)
  • Edge — карта граней (Sobel через OpenCV)
  • Per-map битность — каждая карта в своей 8/16-bit PNG

Экспорт для движков

  • Unity HDRP Mask Map — R=Metallic, G=AO, B=Detail Mask, A=Smoothness
  • Unity URP MetallicSmoothness — R=Metallic, G=AO, A=Smoothness
  • Unreal ORM — R=AO, G=Roughness, B=Metallic
  • Godot ORM — R=AO, G=Roughness, B=Metallic
  • Формат Normal — OpenGL (Y+) / DirectX (Y-) с инверсией зелёного канала
  • Detail Mask для HDRP — белая (1.0) / edge-карта / своя с диска
  • Просмотр каналов — R / G / B / A / RGB / RGBA
  • Источник: текущий PBR-результат или папка с *_albedo.png, *_normal.png, *_ao.png и т.д.

Фильтр реализма

  • Процедурный фотореализм — добавляет текстуре «неидеальность» как на фото
  • Grain — мелкое и крупное зерно
  • Detail — адаптивный high-pass для микро-деталей
  • Variation — крупные пятна цвета/яркости + лёгкая виньетка
  • Тайлящийся шум — паттерн не создаёт видимых швов при тайлинге
  • Пресеты — Мягкий / Средний / Жёсткий в один клик

Встроенный 3D-вьюер

  • Просмотр PBR в реальном времени через OpenGL (viewer.exe)
  • 4 формы: Sphere / Cylinder / Cube / Plane
  • Освещение как в Substance — key + fill + rim, ACES tone mapping, слайдер экспозиции
  • Панель тайлинга — кнопки X/Y прямо в окне, масштаб от 1×1 до 16×16
  • Вращение ЛКМ, зум колесом
  • На базе Moderngl + GLFW + ImGui
  • HDRI-освещение с размытыми отражениями
  • Язык панели следует за языком приложения

Встроенный мануал

  • Полный HTML-мануал со скринами и разметкой
  • Русский / English / 中文 — переключение внутри мануала (кнопки RU / EN / 中文, выбор запоминается)
  • Открывается из Info → Мануал

50 пресетов текстур в 7 категориях

Металл · Природа · Минерал · Синтетика · Ткани · Спецэффекты · Фауна

Пакетная обработка

  • Обработка папок или списка файлов
  • Два режима: AI-коррекция или сжатие
  • Слайдер потоков — управление параллелизмом (1–8)
  • Прогресс-бар с ETA

Темы и режимы

  • Тёмная и светлая тема одной кнопкой
  • Simple / Advanced режимы — workflow в одну кнопку или полный контроль
  • Тайлинг-чекер (3×3) для поиска швов

Интерфейс

  • Русский / English / 中文 с автоопределением системы
  • Интерактивное превью с зумом (0.5x–8x)
  • Глобальные хоткеи — Ctrl+O, Ctrl+S, Ctrl+R, Ctrl+Z, Space, Enter
  • Запоминается последняя открытая папка между сессиями
  • Сохранение настроек — все ключевые опции в config.json

Установка

Инсталлер (рекомендуется)

  1. Скачай Albedolizer_Setup_v1.7.6-beta.exe из последнего релиза
  2. Запусти установщик — всё встанет в Program Files\Albedolizer
  3. Запускай из меню Пуск или ярлыка на рабочем столе

Системные требования

Параметр Минимум Рекомендуется
ОС Windows 10 (64-bit) Windows 11 (64-bit)
ОЗУ 16 ГБ 32 ГБ
CPU 4 ядра 8+ ядер
GPU не требуется NVIDIA для 3D-вьюера
Диск 2 ГБ свободно SSD, 5+ ГБ

Важно про память:

  • 16 ГБ — комфортная работа с текстурами до 4K, одиночная обработка.
  • 32 ГБ — батч-обработка 8K-текстур, параллельные потоки, AI-модели.
  • 8 ГБ — приложение запустится, но при обработке 4K/8K-текстур возможны зависания и ошибки MemoryError. Не рекомендуется.

Из исходников

git clone https://github.com/invisiblelevel/Albedolizer.git
cd Albedolizer
pip install -r requirements.txt
python main.py

Как пользоваться

Одиночная обработка

  1. Выбери тип текстуры справа (например, Дерево)
  2. Нажми Open и выбери Albedo-текстуру
  3. Нажми Check — увидишь статистику и heatmap
  4. Если FAIL → Auto-Correct (AI + fallback)
  5. Save результат
  6. Оригинал / Результат — переключение превью

PBR-генерация + 3D-превью

  1. Вкладка PBR
  2. Load Albedo
  3. Выбери пресет (слайдеры настроятся автоматически)
  4. При необходимости подкрути параметры
  5. Опционально: Metal → By color → ткни в Albedo
  6. Generate → 7 карт
  7. Переключайся между картами — правая панель меняется под карту
  8. 3D Preview — открывает OpenGL-вьюер
  9. Save all — создастся папка <имя>_pbr/

Экспорт для движков

  1. Вкладка Engine
  2. From current PBR (берёт последние сгенерированные карты) или Load from folder
  3. Выбери движок: Unity HDRP / URP / Unreal / Godot
  4. Выбери формат Normal: OpenGL (Y+) или DirectX (Y-)
  5. Для HDRP — выбери Detail Mask: white / edge / custom
  6. Pack — увидишь упакованную карту в превью
  7. Переключай каналы: R / G / B / A / RGB / RGBA
  8. Save all — создастся папка <имя>_<движок>_<gl|dx>/

Фильтр реализма

  1. Вкладка Realism
  2. Open — загрузи текстуру
  3. Кликни пресет: Мягкий / Средний / Жёсткий
  4. Или крути три слайдера вручную: Grain, Detail, Variation
  5. Apply — результат в превью
  6. Save результат

Пакетная обработка

  1. Вкладка Batch
  2. Select folder или Select files
  3. Выбери метод коррекции справа (Autolevels / LUTwithBGrid / Math)
  4. Задай потоки (1–8)
  5. Run processing
  6. Результат в папке _corrected рядом с исходниками

Сжатие

  1. Вкладка Compress
  2. Open для одного файла или Select folder для пакета
  3. Выбери 8-bit или 16-bit PNG справа
  4. Compress или Compress folder
  5. Результат в папке _compressed рядом с исходниками
  6. После сохранения — размер до/после: 12.4 MB → 8.1 MB (−4.3 MB, −34.7%)

Мануал

Нажми Info в хедере → вкладка Manual.

Технологии

  • Flet — кроссплатформенный UI на Python
  • NumPy — математика и работа с массивами
  • Pillow — работа с изображениями
  • OpenCV — Sobel-фильтры, HSV-манипуляции
  • Moderngl + GLFW + imgui-bundle — 3D-вьюер с внутриоконными контролами
  • ONNX Runtime — инференс CLIP и LUTwithBGrid
  • Transformers + Tokenizers — CLIP-токенайзер
  • Autolevels (XCiT-tiny) — AI-модель цветокоррекции

Благодарности

  • LUTwithBGrid (ECCV 2024) — Wontae Kim, Nam Ik Cho — Apache 2.0
  • GIMP tile-seamless (1997) — Tim Rowley — GPL (алгоритм портирован)
  • Lucide — набор иконок (ISC License)
  • Noto Sans SC — китайский шрифт (SIL Open Font License)

Вклад

Pull requests приветствуются. Для крупных изменений сначала откройте issue для обсуждения.

Лицензия

MIT — используйте свободно, в том числе в коммерческих проектах.

Автор: INV.LVL
Версия: 1.7.6-beta
Дата: 2026

About

PBR Albedo Checker & Optimizer — AI color correction + PBR map generation

Topics

aialbedoalbedo-mapsblendergamedevopencvpbrpbr-texturespbr-texturingtexturetexture-compressiontexture-mappingtexture-synthesistexture-toolstexturesunityunrealunreal-engine

Resources

Readme
Activity

Stars

5 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages