seamless

Offline tools for tileable (seamless) images: procedural binary-letter tiles and photo-to-tile batch conversion.

Setup

pip install -r requirements.txt

Binary pattern (black background, white 8-bit binary per letter)

Writes a PNG tile that repeats without seams (fixed grid of monospace cells).

python scripts/generate_binary_seamless.py --out output/pattern.png --preview
python scripts/generate_binary_seamless.py --text "HELLO" --width 512 --height 512 --out output/tile.png --preview --preview-3

Useful flags: --fg, --bg (RGB or #hex), --no-crisp, --scale-2x-nearest, --preview-3.

Images in in/ to seamless tiles in out/

Drop PNG/JPEG/WebP (etc.) under in/, then:

python scripts/batch_img2seamless.py --preview
python scripts/batch_img2seamless.py --overlap 0.2 --in in --out out -r

Outputs *_seamless.png; with --preview, also *_seamless_preview2x2.png. Uses img2texture (gradient blend at edges; higher --overlap shrinks the tile but hides seams better).

Folders

• in/ — source images for the batch script (contents are gitignored; .gitkeep keeps the folder).
• out/ — batch outputs (same).
• output/ — default path for the binary script if you use --out output/....