Troubleshooting
Most problems come with a warning and a one-click fix inside PanoRyse. When they do not, start here.
Stitching
A frame is "not connected" or left out
No verified match joins that frame to the others. Open Modify > Points, pick the frame and a neighbour, and add three or four control points by hand; then stitch again. For plain sky or water, use Pre-stitch Check > Arrange frames to drag the frame to its rough place: it stays there, labelled "placed by hand". PanoRyse never forces a frame into place with a guess.
My photos are treated as separate photos, or as several panoramas
PanoRyse decided they do not overlap enough. Click the kind chip on the top bar and choose Panorama or Stitch them all anyway, or use Edit > Stitch as Panorama. Check the overlap: 25 to 35 % between neighbours works best.
I can see a seam, a colour step or a ghost
Open Review stitch in the Stitch inspector. The Stitch Check lists seams, exposure steps, ghosting and misregistration; press Show to find it and Fix to correct it. For moving people or cars, paint a red exclude mask on the frame you do not want them from (Mask tab).
Close objects do not line up (parallax)
The Stitch Check reports "Likely parallax" with fixes: mask the near object, move the seam, use the local mesh warp (APAP) for that overlap, or shoot again from the lens's no-parallax point. Viewpoint correction (Scenic Pro) helps on flat floors and nadirs.
The horizon is tilted or wavy
Turn on Auto-level, or ask AI Assist to "level the horizon". Add vertical line points (t1) on building edges and horizontal line points (t2) on the horizon for full control.
Speed and memory
The viewer feels slow
Choose a smaller preview (1080p or 2.5K). The export is still rendered at full size. On a computer without a graphics card the software renderer is slower; see GPU and renderer.
A very large set uses a lot of memory
PanoRyse loads large sets as proxies automatically. Close other heavy programs while stitching, and export gigapixel panoramas to the tiled TIFF, which renders from the originals in pieces.
Night and astro
Plate solving fails
- The field needs at least eight clear stars.
- Fields under about 6 degrees (telescopes, long lenses) need the deep star catalogue pack and an approximate centre; see data packs.
- Heavily processed or synthetic images may not match the real sky.
Auto colour makes no change to the star colours
Colour calibration needs unsaturated stars to measure. On a strongly stretched JPEG there may be too few; the status line says so. Neutralising the background and the black point still work.
Star separation leaves traces or takes nebula
Remove the sky gradient first, then separate. Use the refine brushes to add missed stars or protect nebula knots. Try the other engine: Classic is best on small, sharp stars; Learned on smooth, well-sampled data.
The darks or flats were sorted as the wrong type
Open Info > Frames & Calibration, hover the frame to see why it got its type, and pick the right type in its drop-down (or tick several and use Mark as).
Lightroom plug-in
| Problem | What to do |
|---|---|
| "PanoRyse was not found" | Set the program in File > Plug-in Manager > PanoRyse. |
| "These photos could not be sent" | The originals are offline: reconnect the drive, or choose the rendered TIFFs. |
| The panorama's colours differ from Lightroom's | Local adjustments and some newer settings stay in Lightroom. Send rendered TIFFs to keep every edit. |
| Nothing comes back after closing PanoRyse | Closing without sending tells Lightroom the round trip was cancelled. Run the command again. |
Licences
A Pro tool shows a licence badge
That tool belongs to a Pro segment. Start the segment's 14-day trial or load your licence file in Settings > Licences & 14-Day Trial. Projects with Pro edits always open and show those edits.
My licence file is refused
Load the file exactly as you received it; the signed line must not be changed. If it is still refused, contact us at [email protected] with the licence ID (never send your whole file in public).
If PanoRyse closes unexpectedly
Start it again and click Restore Session on the banner. Then send a report from Settings > Bug Reporting, Diagnostics & Technical Support, or write to [email protected] with what you were doing.