what is pannellum fr?

mpetroff/pannellum — explained in plain English

Analysis updated 2026-06-26

★ 4,790JavaScriptAudience · developerComplexity · 2/5LicenseSetup · easy

what do people make with this?

VIBE 1

Embed a 360-degree property or venue tour photo into a real-estate or events website

VIBE 2

Display interactive panoramic photography in a portfolio or travel blog

VIBE 3

Link multiple panorama scenes together with hotspots to create a virtual walkthrough

VIBE 4

Load very large high-resolution panoramas efficiently using tiled multi-resolution mode

what's the stack?

JavaScriptHTMLCSSWebGLPythonJSONiframe

how it stacks up fr

	mpetroff/pannellum	studio-42/elfinder	scratchfoundation/scratch-gui
Stars	4,790	4,787	4,784
Language	JavaScript	JavaScript	JavaScript
Setup difficulty	easy	moderate	moderate
Complexity	2/5	3/5	3/5
Audience	developer	developer	developer

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Upload pannellum.htm and your panorama image to any web server, then embed with a single iframe tag. Multi-resolution tiling requires Python, Pillow, and Nona from the Hugin suite.

Open source under a permissive free license, you can use, modify, and embed it in your own projects freely.

in plain english

Pannellum is a web-based panorama viewer that lets you display 360-degree photos on any website. It runs entirely in the browser using standard web technologies, with no plugins or extra software required by the person viewing the page. The finished file is only about 21 kilobytes when compressed, so it loads quickly and can be dropped into any page by adding a single iframe tag. The most common use case is embedding a panorama into a webpage. You upload the panorama image and the viewer file to your web server, then copy a short snippet of HTML generated by the included configuration tool. For more control, the viewer accepts a JSON configuration file that lets you set the starting position, field of view, hotspots for linking between scenes, and other display options. A JavaScript API is also available for developers who want the viewer to respond to other elements on the page. For large panoramas where a single full-resolution image would be too slow to load, the project includes a Python script that slices the image into tiles at multiple zoom levels. This multi-resolution mode loads only the tiles the viewer actually needs to display, which keeps things fast even for very large images. The tiling script requires a separate tool called Nona, available as part of the Hugin panorama stitching software, along with a couple of Python image libraries. The viewer works in any modern desktop browser including Firefox, Chrome, Safari, and Edge. Mobile browsers and web application frameworks are not officially tested or supported. The project is open source under a free license, and its documentation and live examples are hosted at pannellum.org.

prompts (copy fr)

prompt 1

I have a 360-degree equirectangular JPEG and want to embed it in my HTML page using Pannellum. Show me the minimal iframe snippet and JSON config to set initial yaw to 90 degrees and add a hotspot at pitch 0 yaw 45 linking to a second scene.

prompt 2

Using the Pannellum JavaScript API, write code that creates a viewer on a div with id panorama, loads a config from panorama.json, and adds a button that resets the view to default pitch and yaw when clicked.

prompt 3

I have a 200-megapixel equirectangular panorama and want to use Pannellum multi-resolution tiled mode. Walk me through running the Python tiling script with Nona from Hugin, the output folder structure expected, and the JSON config fields needed.

prompt 4

Write a Pannellum JSON configuration for a virtual tour with three scenes, a lobby, a hallway, and a room, each linked to the others via hotspots, with custom tooltip text and autoLoad set to true.

Frequently asked questions