pixelmaxxxing

Türkçe

pixelmaxxxing, bir görseli düzenlenebilir mozaik parçalara dönüştüren Electron tabanlı bir masaüstü uygulamasıdır. Renk seçimi, benzer tonları eşleme, toplu renk değiştirme, piksel öteleme ve SVG dışa aktarma işlemlerini tek ekranda toplar.

Güncel özellikler

Görsel yükleme ve anlık önizleme
Görsel ölçüsünü en x boy px olarak gösterme
Mozaiği satır / sütun veya parça eni / parça boyu ile ayarlama
Kare ve yuvarlak mozaik şekli
Yatay ve dikey parça aralığını ayrı ayrı ayarlama
Her mozaik parçaya Gauss blur uygulama
Birbirinden farklı ve canlı renklerden otomatik palet çıkarma
Önizlemeden mozaik tıklayarak rengi palete elle ekleme
Tekli seçim, çoklu seçim ve sürükleyerek alan seçimi
Shift ile seçime ekleme
Alt ile seçimden çıkarma
Tek seçilen veya elle seçilen mozaiklerden benzer tonları Renk yakınlığı ile bulma
Seçim önizlemesini açıp kapatma
Seçilen mozaikleri yeni bir renge topluca dönüştürme
Piksel öteleme ile seçili mozaikleri sağa, sola, yukarı veya aşağı adım adım kopyalayarak taşıma
Ctrl + Z ile seçim işlemlerini geri alma
Canvas için transparan, beyaz, siyah veya özel arkaplan rengi seçme
Seçilen arkaplan rengini SVG export içinde de koruma
Yakınlaşma, uzaklaşma ve ekrana sığdırma odaklı önizleme
SVG olarak vektörel çıktı alma
Windows için paketlenebilir setup ve portable exe üretme

Ayrıntılı kullanım kılavuzu

Görsel Seç alanından bir görsel yükle.
Üst barda görselin gerçek boyutunu px olarak kontrol et.
Mozaik bölümünde çalışma şeklini belirle:
- daha düzenli bölme için Satır / Sütun
- daha fiziksel kontrol için Parça eni / Parça boyu
Gerekirse Parça şekli, Sağ-sol aralığı, Yukarı-aşağı aralığı ve Gauss blur değerlerini değiştir.
Bulunan renkler alanında otomatik çıkarılan renklerden birini seç veya doğrudan önizlemede bir mozaik parçaya tıkla.
Seçim bölümündeki Renk yakınlığı çubuğunu oynatarak o tona benzeyen diğer mozaikleri dahil et.
İstersen Benzerlerini Seç ile mevcut seçimden yeni bir benzerlik taraması yap.
Yeni renk alanından bir renk belirleyip Seçileni Değiştir ile toplu renk değişimi uygula.
Piksel öteleme bölümünde yön ve adım sayısı vererek seçili mozaikleri kopyalayarak sağa, sola, yukarı veya aşağı taşı.
Canvas altındaki kare kutulardan arkaplanı seç:
- transparan
- beyaz
- siyah
- özel renk
+, - ve Sıfırla ile önizleme yakınlığını ayarla.
Yenile ile seçim konturlarını ve geçici önizleme izlerini temizle.
SVG olarak çıktısını al ile sonucu vektörel olarak dışa aktar.

Kısayollar

Shift + tık / sürükle: seçime ekler
Alt + tık / sürükle: seçimden çıkarır
Ctrl + Z: seçim geri alır

Geliştirme

npm.cmd install
npm.cmd start

Windows paketleme

npm.cmd run dist:win

English

pixelmaxxxing is an Electron desktop app that turns an image into editable mosaic tiles. It combines color picking, similar-color matching, bulk recoloring, pixel shifting, and SVG export in a single workspace.

Current features

Load an image and preview it instantly
Show the image size as width x height px
Control the mosaic by rows / columns or tile width / tile height
Square and round tile shapes
Separate horizontal and vertical tile spacing
Gaussian blur per tile
Automatically extract a varied, vivid color palette
Add colors manually by clicking tiles on the preview
Single selection, multi-selection, and drag-area selection
Shift to add to the current selection
Alt to subtract from the selection
Use Color similarity to expand a single or manual selection to matching tones
Toggle selection preview on or off
Replace selected tiles with a new color
Apply Pixel shift to copy selected tiles left, right, up, or down by step count
Add editable text and emoji layers, then process selected layers into the image one at a time
Undo selection actions with Ctrl + Z
Choose transparent, white, black, or custom canvas background
Keep the selected background color in SVG export
Zoom in, zoom out, and fit-focused preview behavior
Export the result as vector SVG
Build Windows setup and portable exe packages

Detailed usage guide

Load an image with Select Image.
Check the real image dimensions in px on the top bar.
In the Mosaic section, choose how you want to build the grid:
- use Rows / Columns for a structured layout
- use Tile width / Tile height for direct size control
Adjust Tile shape, horizontal gap, vertical gap, and Gaussian blur if needed.
Select one of the automatically extracted colors from Found colors, or click a tile directly in the preview.
Use the Color similarity slider to include tiles close to that tone.
Use Select Similar to refresh or expand the current match set from your current selection.
Pick a value in New color and use Replace Selection to recolor the selected tiles in one step.
In Pixel shift, choose a direction and step count to copy selected tiles left, right, up, or down.
Use Add Text to create editable text layers. Select a layer to move, edit, or process it into the image.
Use the square background swatches below the canvas to switch between:
- transparent
- white
- black
- custom color
Use +, -, and Reset to manage preview zoom.
Use Refresh to clear temporary selection overlays and preview traces.
Use Export as SVG to save the result as a vector file.

Shortcuts

Shift + click / drag: add to selection
Alt + click / drag: subtract from selection
Ctrl + Z: undo selection changes

Development

npm.cmd install
npm.cmd start

Windows packaging

npm.cmd run dist:win

Release folders

Web deploy: release/web
Windows portable: release/windows/pixelmaxxxing-portable-latest.exe
Itch/setup: release/itch/pixelmaxxxing-setup-latest.exe
GitHub: https://github.com/aliguzel996/pixelmaxxxing
Release API: https://api.github.com/repos/aliguzel996/pixelmaxxxing/releases/latest

Français

pixelmaxxxing est une application de bureau Electron qui transforme une image en mosaïque modifiable. Elle réunit dans une seule interface la sélection de couleurs, la recherche de tons similaires, le recoloriage en masse, le décalage de pixels et l’export SVG.

Fonctionnalités actuelles

Charger une image avec aperçu immédiat
Afficher la taille de l’image en largeur x hauteur px
Régler la mosaïque par lignes / colonnes ou largeur / hauteur des cellules
Formes de cellules carrées et rondes
Espacement horizontal et vertical séparé
Flou gaussien appliqué à chaque cellule
Extraction automatique d’une palette variée et vive
Ajout manuel de couleurs en cliquant sur les cellules dans l’aperçu
Sélection simple, multiple et par zone glissée
Shift pour ajouter à la sélection
Alt pour retirer de la sélection
Utiliser la proximité de couleur pour étendre une sélection à des tons proches
Activer ou désactiver l’aperçu de sélection
Remplacer toutes les cellules sélectionnées par une nouvelle couleur
Appliquer un décalage de pixels vers la gauche, la droite, le haut ou le bas
Annuler les actions de sélection avec Ctrl + Z
Choisir un fond transparent, blanc, noir ou personnalisé
Conserver ce fond dans l’export SVG
Zoom avant, zoom arrière et aperçu ajusté à l’écran
Export vectoriel en SVG
Génération de packages Windows setup et portable exe

Guide d’utilisation détaillé

Charge l’image avec Görsel Seç / Select Image.
Vérifie les dimensions réelles de l’image en px dans la barre supérieure.
Dans la section Mosaïque, choisis ton mode de travail :
- lignes / colonnes pour une structure régulière
- largeur / hauteur des cellules pour un contrôle direct
Ajuste la forme, les espacements horizontal et vertical, ainsi que le flou gaussien si nécessaire.
Sélectionne une couleur dans Couleurs trouvées ou clique directement sur une cellule dans l’aperçu.
Utilise le curseur de proximité de couleur pour inclure les cellules proches du ton choisi.
Utilise Sélectionner les similaires pour recalculer ou élargir la sélection actuelle.
Choisis une nouvelle couleur, puis applique le remplacement sur la sélection.
Dans Décalage de pixels, définis une direction et un nombre de pas pour copier les cellules sélectionnées.
Utilise les carrés de fond sous le canvas pour passer entre :
- transparent
- blanc
- noir
- couleur personnalisée
Utilise +, - et Reset pour régler le zoom.
Utilise Refresh pour nettoyer les contours temporaires et l’aperçu.
Utilise Export as SVG pour enregistrer le résultat en vecteur.

Raccourcis

Shift + clic / glisser : ajouter à la sélection
Alt + clic / glisser : retirer de la sélection
Ctrl + Z : annuler la sélection

Développement

npm.cmd install
npm.cmd start

Packaging Windows

npm.cmd run dist:win

Deutsch

pixelmaxxxing ist eine Electron-Desktop-App, die ein Bild in bearbeitbare Mosaik-Kacheln umwandelt. Farbauswahl, Ähnlichkeitssuche, Massen-Umfärbung, Pixel-Verschiebung und SVG-Export laufen in einer einzigen Oberfläche zusammen.

Aktuelle Funktionen

Bild laden mit sofortiger Vorschau
Bildgröße als Breite x Höhe px anzeigen
Mosaik über Zeilen / Spalten oder Kachelbreite / Kachelhöhe steuern
Quadratische und runde Kachelformen
Getrennter horizontaler und vertikaler Abstand
Gaußscher Weichzeichner pro Kachel
Automatische Extraktion einer vielfältigen, kräftigen Farbpalette
Farben manuell hinzufügen, indem Kacheln in der Vorschau angeklickt werden
Einzel-, Mehrfach- und Bereichsauswahl
Shift, um zur Auswahl hinzuzufügen
Alt, um aus der Auswahl zu entfernen
Mit Farbähnlichkeit ähnliche Töne aus einer Auswahl ermitteln
Auswahlvorschau ein- und ausschalten
Ausgewählte Kacheln gesammelt umfärben
Pixelverschiebung nach links, rechts, oben oder unten mit Schrittanzahl
Auswahlaktionen mit Ctrl + Z rückgängig machen
Transparenter, weißer, schwarzer oder eigener Canvas-Hintergrund
Gewählten Hintergrund auch im SVG-Export behalten
Zoomen und an den verfügbaren Bereich angepasste Vorschau
Export als Vektor-SVG
Erzeugung von Windows-Setup- und Portable-EXE-Paketen

Detaillierte Anleitung

Lade ein Bild über Bild auswählen.
Prüfe in der oberen Leiste die echte Bildgröße in px.
Wähle im Bereich Mosaik, wie das Raster aufgebaut werden soll:
- Zeilen / Spalten für eine feste Struktur
- Kachelbreite / Kachelhöhe für direkte Größenkontrolle
Passe Form, horizontalen Abstand, vertikalen Abstand und Gauß-Blur bei Bedarf an.
Wähle eine Farbe aus Gefundene Farben oder klicke direkt eine Kachel in der Vorschau an.
Nutze den Regler Farbähnlichkeit, um ähnliche Kacheln zur Auswahl hinzuzunehmen.
Mit Ähnliche auswählen kannst du die aktuelle Auswahl erweitern oder neu berechnen.
Wähle unter Neue Farbe einen Zielton und färbe die Auswahl gesammelt um.
Im Bereich Pixelverschiebung kannst du Richtung und Schrittanzahl festlegen, um ausgewählte Kacheln zu kopieren.
Unter dem Canvas kannst du den Hintergrund umschalten:
- transparent
- weiß
- schwarz
- benutzerdefinierte Farbe
Verwende +, - und Reset, um den Zoom zu steuern.
Verwende Refresh, um temporäre Konturen und Vorschau-Spuren zu entfernen.
Exportiere das Ergebnis mit Export as SVG als Vektordatei.

Tastenkürzel

Shift + Klick / Ziehen: zur Auswahl hinzufügen
Alt + Klick / Ziehen: aus Auswahl entfernen
Ctrl + Z: Auswahl rückgängig machen

Entwicklung

npm.cmd install
npm.cmd start

Windows-Paketierung

npm.cmd run dist:win

Русский

pixelmaxxxing — это настольное приложение на Electron, которое превращает изображение в редактируемую мозаику. В одном интерфейсе собраны выбор цветов, поиск похожих оттенков, массовая перекраска, смещение пикселей и экспорт в SVG.

Актуальные возможности

Загрузка изображения с мгновенным предпросмотром
Отображение размера изображения как ширина x высота px
Управление мозаикой через строки / столбцы или ширину / высоту плитки
Квадратная и круглая форма плиток
Отдельная настройка горизонтальных и вертикальных промежутков
Размытие по Гауссу для каждой плитки
Автоматическое извлечение разнообразной и яркой палитры
Ручное добавление цветов кликом по плиткам в предпросмотре
Одиночное выделение, множественное выделение и выделение областью
Shift для добавления к выделению
Alt для исключения из выделения
Использование цветовой близости для поиска похожих оттенков
Включение и выключение предпросмотра выделения
Замена выделенных плиток новым цветом
Смещение пикселей влево, вправо, вверх или вниз на заданное число шагов
Отмена действий выделения через Ctrl + Z
Прозрачный, белый, черный или пользовательский фон холста
Сохранение выбранного фона в SVG-экспорте
Масштабирование и удобный предпросмотр в пределах экрана
Векторный экспорт в SVG
Сборка Windows-пакетов setup и portable exe

Подробное руководство

Загрузите изображение через Select Image.
Проверьте реальные размеры изображения в px в верхней панели.
В разделе Mosaic выберите способ построения сетки:
- строки / столбцы для строгой структуры
- ширина / высота плитки для прямого контроля размера
При необходимости настройте форму, горизонтальные и вертикальные промежутки, а также Gaussian blur.
Выберите цвет из блока найденных цветов или кликните по плитке прямо в предпросмотре.
Используйте ползунок цветовой близости, чтобы добавить похожие плитки.
Кнопка Select Similar позволяет пересчитать или расширить текущее выделение.
Выберите новый цвет и примените массовую замену для выделения.
В блоке Pixel shift задайте направление и количество шагов, чтобы копировать выделенные плитки.
Ниже canvas можно выбрать фон:
- прозрачный
- белый
- черный
- пользовательский цвет
Используйте +, - и Reset для управления масштабом.
Используйте Refresh, чтобы очистить временные контуры и следы предпросмотра.
Используйте Export as SVG, чтобы сохранить результат как векторный файл.

Горячие клавиши

Shift + клик / перетаскивание: добавить к выделению
Alt + клик / перетаскивание: убрать из выделения
Ctrl + Z: отменить изменение выделения

Разработка

npm.cmd install
npm.cmd start

Сборка для Windows

npm.cmd run dist:win

Name		Name	Last commit message	Last commit date
.github/workflows		.github/workflows
assets		assets
metadata		metadata
pixelmaxxxing		pixelmaxxxing
release/web		release/web
web-build		web-build
.gitattributes		.gitattributes
.gitignore		.gitignore
AI.md		AI.md
CHANGELOG.md		CHANGELOG.md
README.md		README.md
app.manifest.json		app.manifest.json
favicon.svg		favicon.svg
index.html		index.html
llms.txt		llms.txt
main.js		main.js
package-lock.json		package-lock.json
package.json		package.json
preload.js		preload.js
renderer.js		renderer.js
style.css		style.css

Latest commit

History

Folders and files

Repository files navigation