Tessellry User Manual

Version 1.5.0 · by Rekluz Labs

Tessellry (formerly Tile Harvest) is an Android app for taking grid images apart and putting photo grids together. Everything runs on your device. Nothing is uploaded, and no account is needed.

What you can do with it:

1. Getting Started

When you open Tessellry you will see two options: Split a Sheet and Create a Contact Sheet. A short tutorial appears on first launch. You can skip it at any time. Settings is available from the same screen.

Sharing into Tessellry: you can send images to Tessellry from your gallery or any other app using Android's Share menu. One image opens in Split a Sheet. Several images open in Create a Contact Sheet.

Saved work: Tessellry remembers your tile names and edge edits for each sheet. If you reopen the same sheet, your work is restored. Data stays on your device and is removed if you clear the app's data or uninstall.

Permissions: Tessellry uses Android's built-in pickers, so it only sees the images and folders you choose.

2. Split a Sheet

Step 1: Choose a detection mode

Switching modes after loading a sheet re-runs detection and discards any manual edits (Tessellry asks first).

Step 2: Load a sheet

Tap Sheet to pick an image, or Sample Sheet to try a built-in example. Samples are a good way to learn the controls.

Step 3: Choose a template

A template is a frame that each tile is placed into. Tap Template to choose one:

TemplateHas name label
Tessellry FrameNo
Picture Frame (default)No
Postage StampYes
Mahjong TileYes
Playing CardYes
Picture Frame LandscapeNo
Mahjong Tile LandscapeYes

You can also load your own template image. If its opening is in the wrong place, adjust it with Frame Opening in the Layout Adjuster.

Templates with a label area print each tile's name onto the exported tile.

Step 4: Review the results

Tessellry detects the tiles and then reads the title on each one using on-device text recognition (OCR). On the review screen you can:

Step 5: Fix problems (optional)

Edit Tile Edges lets you correct detection mistakes:

Layout Adjuster (Edit All) changes every tile at once. Swipe between tiles to preview the effect, then tap Apply to All Tiles.

ControlWhat it does
Artwork ScaleZoom the artwork inside the frame
Horizontal / Vertical ShiftMove the artwork
RotationRotate the artwork
Trim (Left, Right, Top, Bottom)Crop unwanted edges from the source, such as scan borders
Frame OpeningMove the template's window (applies to all tiles)
Reset Defaults / Reset OpeningUndo your changes

Tune adjusts a single tile. Use Previous Tile and Next Tile to move through the sheet. Tuned tiles show Tune • on the review screen.

A good workflow: use the Layout Adjuster to get most tiles right, then use Tune for the few that are still off.

Step 6: AI Upscale (optional)

Turn on AI Upscale to sharpen small or low-resolution tiles during export. Tessellry picks the right model automatically: one for graphics and illustrations (Tiles mode), another for photos of people (Faces mode).

Upscaling is slow and uses battery, so leave it off if your source is already sharp. It is not used for atlas exports.

3. Exporting Tiles

Tap Export Tiles and choose a destination:

File naming: files are named <prefix>_<name>.<ext>, where the name is the first 6 letters and numbers of the tile's name. For example, a tile named "Blue Dragon" becomes tileset2_bluedr.png. Tiles with no name become tile_1, tile_2, and so on. You can change the prefix in Settings.

If a file already exists, Tessellry asks whether to Overwrite, Rename, Delete existing, or Do Nothing. Tick Apply to all remaining conflicts to use your choice for the whole batch.

After exporting, tap Share to send the files or Gallery to check them.

Output formats (set in Settings):

FormatNotes
PNGLossless, keeps transparency. The safe default.
WEBPSmaller files, keeps transparency. Needs Android 11 or newer (falls back to PNG on older devices).
JPEGCompact, but transparent areas become white.
PDFOne page per tile, for printing.

4. Sprite Atlas Export

An atlas packs many sprites into one or more PNG images, with a JSON file that records where each sprite sits. Game engines load it as a single asset and look sprites up by name. If you are not making a game, you can skip this section.

What an atlas contains: the raw artwork only. The template frame, labels, and AI upscaling are not included. Pages are always PNG.

Atlas settings:

SettingOptionsDefaultPurpose
Padding0, 1, 2, 4 px2 pxSpace between sprites to prevent visible seams
Extrude edgesOn / OffOnRepeats edge pixels into the padding to prevent bleeding
Power of twoOn / OffOffRounds page sizes to 512, 1024, 2048, and so on, for engines that need it
Max size1024, 2048, 4096 px2048 pxLargest size of a single page

Output files:

Tessellry_20261103_1420_atlas.json
Tessellry_20261103_1420_atlas_0.png
Tessellry_20261103_1420_atlas_1.png

Keep the JSON and all PNG pages together in the same folder. If your tiles do not fit on one page, Tessellry creates more.

Sprite names: your tile names become the sprite names in the JSON. Spaces and symbols become underscores ("Hero Sprite!" becomes Hero_Sprite), duplicates get _2, _3, and blank names become tile_001, tile_002.

Engine compatibility: the JSON uses the TexturePacker/Phaser "JSON Hash" style. It works directly with Phaser 3 and PixiJS. Other engines such as Unity, Godot, and libGDX need a small importer script or plugin. Sprites are never rotated or trimmed, so conversion is straightforward.

Phaser 3 example:

this.load.atlas('tiles', 'atlas_0.png', 'atlas.json');
this.add.image(100, 100, 'tiles', 'Blue_Dragon');

If you see "Not enough memory to build the atlas," lower Max size.

5. Create a Contact Sheet

A contact sheet arranges many photos in one grid, useful for client proofs, print layouts, catalogs, and mood boards.

  1. Add Photos: select up to 56 photos. Use Add More to add further batches.
  2. Reorder: hold and drag a photo to move it. The grid fills left to right, top to bottom, and the printed numbers follow this order. Tap a photo to view it fullscreen.
  3. Canvas size: choose a preset (table below).
  4. Layout:
    • Show numbers under each photo: adds a number label to each photo, handy for proofing.
    • Margin: space around the edge of the sheet (0 to 6%, default 2%).
    • Gutter: space between photos (0 to 6%, default 1.2%).
  5. File name and format: choose PNG, WEBP, JPEG, or PDF. This is separate from the Split a Sheet format setting.
  6. Export Contact Sheet: pick a folder. When it finishes, tap View in Gallery to check it.
PresetSize (px)
Square3000 × 3000
8.5 × 11 (US Letter)2550 × 3300
A42480 × 3508
A51748 × 2480
B52079 × 2953
4 × 61800 × 1200
3 × 51500 × 900
Business Card1050 × 600

The grid size is chosen automatically to be roughly square. Photos are never cropped: each one is fitted inside its cell on a white background.

6. Settings

SettingOptions
LanguageSystem default, or choose from 21 languages
ThemeMahjong Tile, Mako Blue, Narra Green, Akachan's Glow, Temporatic Steel, RekluzLabs Gold (default)
Output FormatPNG, WEBP, JPEG, PDF
Output Tile Resolution128, 256, or 512 px (default). Applies to Files and ZIP exports.
Filename ConventionTurn on Use custom filename pattern to replace the tileset2 prefix with your own
AboutVersion, Privacy Policy, and contact link

Resolution guide: 128 px for small icons, 256 px for general game assets, 512 px for print or high-resolution screens. Tiles keep their shape and are never stretched to a square.

7. Troubleshooting

ProblemWhat to try
"No tiles detected"Switch between Tiles and Faces mode. Use a cleaner, straighter scan with good contrast between tiles and background.
Too many tiles detectedUntick the extras, or delete them in Edit Tile Edges.
A tile is cut offDrag its corners outward in Edit Tile Edges.
Artwork is off-centerUse Layout Adjuster for the whole sheet, or Tune for one tile.
Frame opening looks wrongAdjust Frame Opening in the Layout Adjuster, or tap Reset Opening.
Names are wrongEdit them in Review Names, or tap Re-run OCR.
Export is slowTurn off AI Upscale, lower the tile resolution, or export fewer tiles.
Seams in atlas spritesRaise Padding to 4 and turn on Extrude edges.
"No tiles fit within the maximum atlas size"Raise Max size.
Transparent areas turned whiteJPEG does not support transparency. Use PNG or WEBP.
WEBP not appliedYour device is below Android 11, so PNG was used.
Shared image did not openShare it again. Images over 64 MB cannot be received.

Tips for better results:

8. Privacy

Tessellry works entirely on your device. It has no internet permission, no account, no analytics, and no ads. Tile detection, text recognition, face detection, and AI upscaling all run locally. The full Privacy Policy is in Settings → About → Privacy Policy.

Questions? Contact Rekluz Labs at rekluzlabs@gmail.com.

9. Quick Reference

Split a Sheet: choose mode → load sheet → pick template → review names → fix edges or layout if needed → export (Files, ZIP, or Atlas).

Contact Sheet: add photos → drag to reorder → choose canvas → set margin, gutter, and numbers → choose format → export.

Defaults:

SettingDefault
Detection modeTiles
TemplatePicture Frame
Output formatPNG
Tile resolution512 px
Filename prefixtileset2
Atlas2 px padding, extrude on, power of two off, 2048 max
Contact sheetSquare, 2% margin, 1.2% gutter, numbers off

Limits: 56 photos per contact sheet, 30 saved sheets of names and edits, 64 MB per shared image.

Tessellry 1.5.0 · © 2026 Rekluz Labs