App reference

EXIF GPS extraction

Latitude, longitude and altitude are read from the photo metadata and stored on the scene. No manual entry required for geo-tagged cameras (Insta360, Ricoh Theta, GoPro MAX, etc.).

EXIF heading

If the camera embeds a compass heading (GPSImgDirection tag), Conchitour uses it to pre-orient the North reference of the scene.

Batch import

Drop an entire folder at once. Scenes are created in file-system order. You can reorder them afterward in the Scenes screen.

Duplicate detection

If you import the same file twice, Conchitour detects the duplicate by filename and warns you.

Supported formats

JPEG, PNG, WebP equirectangular (2:1 ratio recommended). Minimum 4000 × 2000 px for good quality in krpano.

Scene list (left panel)

All scenes in the project. Click a scene to load it into the viewer. Drag to reorder. Right-click to rename, duplicate, or delete.

360° viewer (center)

Live krpano-based viewer. Drag to orbit, scroll to zoom. Hotspots are visible and interactive directly in the editor.

Inspector (right panel)

Shows the selected scene's name, slug, GPS coordinates, heading, hotspot list, and content fields (title per language, description, alt text for SEO).

Add hotspot

Click "Add hotspot" then click any point in the viewer. A tooltip lets you pick the target scene. Drag the hotspot to reposition it. Hotspots are stored as pitch/yaw angles.

North calibration

Press N or click the Compass button to enter calibration mode. A red N badge appears. Drag the viewer until the badge sits over true North in the 360° image. Click Confirm North. Required for GPS-based auto-direction of hotspots.

Heading indicator

Shows the current camera heading relative to North. Used as reference for hotspot direction computation from GPS.

Leaflet map

OpenStreetMap tiles, standard zoom controls, satellite/street toggle. Each scene is represented by a numbered pin.

Drag-and-drop positioning

Drag any pin to the exact real-world location of the corresponding scene. Useful when photos have no GPS EXIF or when the GPS is imprecise.

Auto-compute hotspot directions

Once at least two adjacent scenes have GPS coordinates and their North heading calibrated, click "Auto-compute" to let Conchitour calculate the yaw angle for each navigation hotspot based on bearing between scenes.

Scene selection

Click a pin to select the corresponding scene and jump to it in the Scenes panel.

Project name

Internal name for the project. Used in the compiled output's page title and JSON manifest.

Copyright

Copyright notice embedded in the compiled tour. Appears in the viewer's info overlay and in the HTML meta tags.

Author / Studio

Your name or studio name, also embedded in the output.

Default language

The primary language of the tour. Content in the default language is always required; other languages are optional.

Tour slug

URL-safe identifier used as the root path of the compiled site. Change this only before the first deployment.

Global meta description

Shown in search results for the tour home page. 120-160 characters recommended.

Per-scene meta title

Each scene gets its own <title> tag in the compiled HTML. Edit inline in the SEO tab or let AI generate them from Modules.

Per-scene alt text

Alt attribute on the OG image for each scene. Improves accessibility and image search indexing.

Open Graph tags

og:title, og:description, og:image are generated per scene. The OG image is the equirectangular photo resized to 1200×630.

Canonical URLs

Each scene has a canonical URL to prevent duplicate content issues if the tour is embedded elsewhere.

Sitemap

Conchitour generates a sitemap.xml with all scene URLs at compile time.

Add language

Click + and select a language from the ISO 639-1 list (FR, EN, ES, DE, IT, PT, NL, JA, ZH, AR, etc.). Each language adds a column to all text fields.

AI auto-translation

Requires an AI API key in Modules (OpenAI, Claude, Gemini, DeepSeek or Mistral). Select a language and click "Auto-translate". The AI reads the source text and tour context (location, photo content) to produce natural translations, not just literal word-for-word output.

Manual editing

All translations can be edited manually in the Scenes inspector, field by field.

Language switcher in compiled tour

The compiled output includes a language switcher UI. Visitors can switch languages without reloading the 360° viewer.

RTL support

Right-to-left languages (Arabic, Hebrew) are supported. The compiled UI adapts its layout direction automatically.

VR mode

Adds a VR toggle button to the compiled viewer. Visitors with a VR headset (WebXR-compatible) can enter an immersive 360° view. Uses krpano's built-in WebXR renderer.

Gyroscope

On mobile devices, enables gyroscope-based navigation. Tilting the phone rotates the 360° view. Toggle in the viewer toolbar.

Feedback form

Embeds a small contact/feedback form in the compiled tour. Visitor responses are sent to your configured email address. No backend required (uses a formspree-style endpoint).

AI API key

Paste your OpenAI (GPT-4o), Claude, Gemini, DeepSeek or Mistral API key here. Used by the Languages screen for auto-translation and by the SEO screen for AI-generated meta content. The key is stored locally and never sent to Conchitour servers.

Logo

Upload your logo (PNG/SVG, transparent background recommended). Appears in the tour toolbar and the loading screen.

Accent color

Primary color used for hotspot rings, loading bar and UI accents in the compiled tour. Hex code input with a color picker.

Loading screen background

Color or image shown while the first scene loads. Defaults to dark navy.

Hotspot style

Choose between arrow (directional chevron), dot, or custom SVG for navigation hotspots.

Favicon

Icon shown in browser tab and bookmarks for the compiled tour. 512×512 PNG recommended.

Structural errors

Scenes with no hotspots (dead ends), hotspots pointing to deleted scenes, duplicate slugs, missing required content fields.

GPS warnings

Scenes without GPS coordinates (North calibration can't be auto-computed), scenes with GPS but no North heading set.

SEO score

Powered by AI (requires API key in Modules). Scores each scene out of 100 on title quality, description length, keyword relevance, and alt text. Shows improvement suggestions.

Language completeness

Flags any scene that has content in the default language but is missing translations in one or more active languages.

Image quality check

Warns if any scene photo is below 4000×2000 px (minimum recommended for krpano quality at full zoom).

Output folder

Choose where to save the compiled tour. A new timestamped subfolder is created each time so previous compilations are preserved.

Compile button

Runs the full pipeline: resize and convert scene images, generate krpano XML tour configuration, compile HTML/JS/CSS for each scene, generate sitemap, copy krpano viewer files and your license.

krpano files required

Copy your krpano license files (including krpanolicense.xml and the viewer JS) into assets/krpano/ inside the Conchitour app folder before compiling. Without them the viewer won't run.

License activation

Click "Activate License" and enter your key (format XXXX-XXXX-XXXX). Internet required for the first activation on a new machine. Once activated, compilation works offline.

Build log

A real-time log shows each compilation step. Errors stop the build and are highlighted in red with the affected scene name.

What is krpano?

krpano (krpano.com) is a professional 360° panorama viewer and virtual tour framework by Klaus Reinfeld. It is the industry-standard engine for high-quality web-based virtual tours. Conchitour uses krpano to render the 360° viewer, handle hotspot interaction, VR mode and gyroscope navigation in every compiled tour.

Why is a separate krpano license required?

Conchitour generates tours powered by the krpano engine (XML scenes, JS viewer, skin files). To legally host and distribute those tours, even on your own server, you need a valid krpano license. Without one, the exported tour shows a krpano watermark in the viewer.

Which krpano license do I need?

Most users need the krpano webmaster license (one-time fee) which covers embedding tours on any number of websites you personally own or manage. If you deliver compiled tours to clients who host them independently on their own domains, you need the protect+player license instead, which allows distributing encrypted krpano tours to third parties. See krpano.com/buy/ for current pricing and full license terms.

Where to buy

Purchase directly at krpano.com/buy/. After purchase you receive a license archive (.zip) containing krpanolicense.xml and the viewer files. Extract those into the assets/krpano/ folder inside the Conchitour installation directory.

How to install krpano files

Place your krpano license archive contents (krpanolicense.xml, viewer.js, and related files) into the assets/krpano/ folder inside the Conchitour app directory. The exact path is shown in Settings → krpano assets path. Once in place, the Compile screen detects them automatically.

Version compatibility

Conchitour targets krpano 1.22+. Older licenses will generally work, but using the latest krpano release is recommended for WebXR (VR) and mobile performance improvements.

Start preview server

Conchitour spins up a local HTTP server on port 4200 (configurable). Opens your default browser automatically.

Hot reload on recompile

After recompiling, refresh the browser tab to see changes. The server stays alive until you stop it.

Test all scenes

Navigate the tour exactly as visitors will. All hotspots, language switching, VR button and gyroscope work in preview mode.

QR code for mobile

Displays a QR code pointing to your local IP address so you can test on a real phone on the same Wi-Fi network.

UI language

The language of the Conchitour interface (EN / FR / ES). Independent from your tour's languages.

Theme

Dark mode (default) or light mode.

Auto-save interval

How often Conchitour auto-saves your project (default: every 2 minutes).

Preview server port

Default is 4200. Change if another service is already using that port.

krpano assets path

Override the default assets/krpano/ path if you store your krpano files elsewhere.

Update channel

Stable (default) or Beta. Beta gets new features earlier but may have rough edges.