← Back to AYNI

AYNI XR user manual

AYNI XR shows how our planet is changing: live and recorded environmental data on a globe you can turn in your hands. Use it in a web browser, in a Meta Quest headset, or in augmented reality on an Android phone or tablet. It is made by Pachamama Studios.

This manual explains every part of the app in plain language, for teachers, students, researchers and anyone presenting to a group.

Last updated: 6 October 2026.

Contents

  1. Getting started
  2. Finding data: the Browse panel
  3. Watching a dataset
  4. The Tools panel
  5. Reading values: pins and the graph
  6. Analyze: statistics, lines and boxes
  7. Comparing datasets on several globes
  8. Ayni Chatbot
  9. Playlists
  10. Khipus
  11. Lessons
  12. Your own data
  13. Sharing and downloading
  14. Meetings
  15. The Situation room
  16. Shared sessions and the AYNI XR marker
  17. VR on Meta Quest
  18. AR on Android phones and tablets
  19. Accounts and plans
  20. Privacy and your data
  21. Keyboard shortcuts
  22. Help, feedback and troubleshooting
  23. What works where

Getting started

Open vr.ayni.eu.com in a current browser: Chrome, Edge, Firefox or Safari on a computer, or Chrome on Android. Nothing needs installing.

Your free account

AYNI XR is free, with an account. The first time, the welcome page asks you to sign up or sign in, which is the same step:

You stay signed in on that browser for 30 days after your last visit.

Got a link from a teacher or presenter? Just open it. Joining a class, a room or a meeting needs no account. If someone shared a dataset link with you, sign in and the app opens that dataset.

The privacy questions

On your first visit the app asks two separate questions:

  1. "May this app report usage and error events so we can keep it working?"
  2. "May the app remember which datasets you open, on this device only, for Browse's Recent tab?"

You can change your answer at any time. See Privacy and your data.

What is on the screen

Where What it is
Top left Home (⌂) returns to the plain Earth and opens Browse. Show anchor turns this screen into a marker for shared AR (see Shared sessions). Share sends a link to the dataset on the globe, or to AYNI XR when none is loaded (see Sharing).
Top right Sign in (or your name), Help, and Enter AR / Enter VR on devices that support it. Under Help, Spin the globe (⟳) turns the globe slowly; while it spins, a slider beside it sets the speed, from a quarter to four times the normal speed. It keeps spinning until you press it again: dragging the globe only pauses it, and a new dataset or layout leaves it on. The stars behind the globe stand still while it spins. A Khipu step can start or stop the spin, at its own speed. A Khipu playing, or following someone else's globe in a shared session, holds it until they finish.
Bottom right Browse, Tools (the sliders icon) and Fullscreen. Under them, the playback controls when a dataset moves.
Bottom centre The date the globe is showing.
Bottom left The dataset's information panel, and Ask Ayni Chatbot.

On a computer, the Browse panel opens by itself. When Browse or Tools is open, the globe slides over to stay in the free space.

Moving the globe

Finding data: the Browse panel

Press Browse (bottom right) to open the list of datasets. Press ✕ or Browse again to close it.

The panel has five tabs:

The panel opens on the tab you used last.

Searching

Type what you are looking for in Search datasets…, in your own words. You don't need the catalogue's keywords:

A moment after you stop typing, more datasets about the same thing may appear under Related by meaning, even when they share no word with your search ("is the Arctic melting" finds sea ice). For this, the text of your search is sent to our server; it is not stored (see Privacy and your data).

You can also search by property:

If nothing matches, the app offers to ask Ayni Chatbot instead.

Filters

The filters are behind the Filters button beside the search results, so the list keeps its room. The number on the button is how many filters are on. Press it to open them, and click anywhere else (or press Esc) to close them. The first section, Kind & theme, is open:

More sections fold underneath:

Choices in one group mean "any of these"; choices in different groups must all match. Active filters show as small chips you can remove, and Clear filters removes them all. The search and filters are kept in the page address, so you can share a filtered list as a link.

Views and sorting

The small icons beside Filters switch the view. Every view shows the same datasets as the search and filters:

On a narrow phone only Cards and Map are offered.

The cards

Each card is one compact row: a picture, the title and two badges:

A lock on the package badge means the stream is in a package your plan does not include. The Science On a Sphere catalogue is free with your account; live streams are in the AYNI XR plans' packages. Loading a locked stream opens the plans instead, with a line saying which package it is in. In a meeting or a shared session you still see whatever the presenter shows: watching is covered by their plan.

Click a card to open it: its description, source, who made it, its time range, its frames and its keywords (click a keyword to search for it). Press Load to put the dataset on the globe.

The dataset menu

Every dataset has a small menu. To open it:

The menu offers:

The Add to playlist button in a loaded dataset's information panel opens the same menu.

Watching a dataset

A dataset that covers only part of the Earth, such as Spain or the Canary Islands, opens with the globe turned to its region and zoomed to fit it.

Playback

Datasets that move have controls at the bottom right:

Button What it does
⏮ Back to the start
⏪ / ⏩ One frame back or forward
▶ Play or pause
⏭ To the end
🔇 Sound on or off, where there is sound
CC Captions, where there are captions

Drag the bar underneath to move through time. Live streams have a date track instead: drag along it to pick a date. On a computer, rest the mouse on the track to see the date there before you click; on a phone or tablet the date shows while your finger drags. The dataset plays in a loop and pauses for 4 seconds on its last frame.

With a real-time stream on top (Tools → Layers → Real time), a yellow track appears above the green one, on the same dates (one per stream, stacked as on the globe: the newest on top). It is filled where the stream has data and hatched where it has none; while the date is in a hatched stretch, the stream is hidden on the globe and its marker is hollow. Each track is labelled with its dataset. Dragging along either track moves both. At the right of each yellow track's label, the eye hides that stream on the globe and shows it again (it keeps following the date, and its track dims while hidden), and the ✕ takes the stream off.

Left of each yellow track are two buttons:

The green track is labelled with the dataset, whether streams play over it or not. It has a lock in the grip's place and its own palette button, which changes the dataset's colours (the same as Tools → View) and its transparency: the Earth shows through it. At the right of its label:

In a meeting, the presenter's transparencies and eyes reach everyone, and only the presenter can change them. A Khipu step records them too.

On the date track, green fills up to the date shown and the thin lines mark dates (labelled where there is room). Coloured bands show stretches of the dataset that are not new measurements:

The date that shows when you point at the track says so too: "no data", "repeated frame" or "estimated". On a yellow track, "no data from this stream" marks the hatched part.

Dates and information

The value under the pointer

On a computer, move the mouse over the globe. A green box at the top centre of the globe shows where you are (it moves with the globe when Browse or Tools push it aside), for example 12.3° N, 45.6° W. On datasets that carry measured values it also shows the value there, for example 23.4 °C, or No data. Some datasets add what kind of value it is: IMERG precipitation says 0.8 mm/hr · rain or 0.1 mm/hr · snow. A dataset whose errors were measured (your own data, for now) shows the value with its ±, for example 12.35 ± 0.18 m s-1: 99 % of places are within that of the true value, and the value is rounded to what the ± allows. The pins and Analyze show the same ±. On phones and tablets use pins instead.

The legend and colours

The legend explains the colours. It sits at the bottom right of each globe; with two or four globes it rises above the information card, the chatbot's button and the playback controls when it would cover them. On datasets that carry values it is a live colour bar, with the values under it and the units to its right, the same one Tools → View shows, so it always matches the globe (IMERG precipitation shows two bars on one scale, rain and snow, because snow is drawn in its own colours); tap it (Tap to adjust colours) to open Tools → View, where the colours are set (see View). A dataset made of classes, such as land use, lists each class with its colour instead. Other datasets show the legend their publisher made, if there is one; tap it to enlarge it. On a dataset with reference lines (such as the Paris Agreement's 1.5 °C), each line is a dashed mark across the bar, named under it (see Reading values).

It stays in view. Opening Browse, Tools, Analyze, the Studio or a lesson slides the globe aside, but not the legend: it keeps its place on the screen and moves only as far as it must to stay beside the open panels, never under one or off the edge. A legend in its usual corner steps left beside the panels; one you have left in the middle of the screen stays where it is. The only way it leaves the screen is when you close it (below).

Close the legend and bring it back: the small ✕ on the legend's top edge closes it, and it flies into Tools → View, where it waits at the foot of the tab under Legend. You can also drag the legend onto the Tools panel or the Tools button to put it there. To bring it back, press ⇱ in its corner, or drag it out of the panel and let go where you want it on the globe (on a phone, drag it by ⇱). With two or four globes, all their legends go and come back together. Tools → More → Display → Legend does the same as a switch. The app remembers a closed legend on that browser.

Move or resize the legend: drag it anywhere on its globe, or drag its bottom-right corner to make it bigger (the text grows with it, which helps on a projector). A tap without dragging still does what it did before. Double-click the corner to put it back in its usual place and size. With the keyboard, the arrow keys move a selected legend and Ctrl with the arrows resizes it. Each globe remembers where you left its legend, on that browser.

Changing colours never changes the values the app reports.

Shapes drawn on the globe

Some datasets draw shapes on the globe themselves, instead of painting it: points, lines, areas and tracks. Earthquakes are the first. Each quake is a circle at the place it started: it grows as the playback date passes its time, then fades, slower for bigger quakes, and quakes of magnitude 6 and above send out ripples. The size gives the magnitude and the colour the depth. While playback is paused, or after you move the date, the globe shows all of that day's quakes at full size.

Earthquakes since 1960 work the same way, a year every second: each quake of magnitude 5 and above appears on the date it struck, quakes of magnitude 7 and above send out ripples, and those of 8 and above carry a small box with their magnitude and name, such as "M9.1 · 2011 Great Tohoku Earthquake, Japan". Paused, or after you move the date, the globe shows the whole year. The panel also gives the magnitude type, since older quakes were measured on different scales.

Tropical cyclones are tracks: each storm's path over the last 30 days, drawn up to the playback date and coloured by its Saffir-Simpson category at each point. A storm still being tracked has a disc at its position and, once it has a name, a small box beside the disc with its name and maximum sustained wind, such as "SIMON 250 km/h". The box takes the colour of the storm's category at that moment, so it changes as the storm strengthens or weakens. A depression without a name yet has a disc but no box. When a storm ends, its disc and box go, and its track stays until it is 30 days old.

For storms in the Atlantic and the eastern and central Pacific, the US National Hurricane Center's forecast cone is drawn as a pale area ahead of the storm, with a thin white line through it for the forecast track. Each cone is the one issued in that advisory and stays until the next one replaces it; it shows where the centre may go, not how far the wind reaches.

Tropical Cyclone Tracks since 1950 plays the storms of each year, a year every second: each track draws in as the storm moves, its disc and name box show while it is active, and the track fades about two months after the storm ends, so each season builds up and then clears.

Disaster alerts (GDACS) carry a box with a short name on Orange and Red alerts, such as "Eruption Taal", and live earthquakes of magnitude 6 and above carry their magnitude and place.

The Tools panel

Press Tools (the sliders icon, bottom right). On a computer the panel stays open beside the globe until you close it with ✕, Tools or Esc. It reopens on the tab you used last.

If your plan lets you host meetings, Start a meeting… is at the top (see Meetings).

Layers

Some datasets come with a layer already chosen; you can change it. Country borders are an overlay: streams that cover the whole Earth with colour get them automatically, and so does any stream that comes with borders listed, such as climate-zone maps or sea-level and sea-ice projections. The Sun and other worlds (the Moon, Mars, Io...) start bare: no borders, no other layer and no Earth underneath, though you can still add a layer yourself. You can choose them, or None, in the Overlay card.

Data

The Data tab is for reading values:

View

More

Your plan

The line at the foot of the panel shows your plan: Not signed in with Sign in, Plan: Free with See the plans, or your plan's name with Your plan.

Reading values: pins and the graph

Many live and recorded streams carry real measurements in their colours. On those, you can pin places and follow their values through time.

Reading values is part of the AYNI XR plans, from Plus up: pins and the graph, Measure, the value under the pointer and the value in the headset. Without one, the Data tab says so and offers See the plans. Plus reads values with two pins and their graph; Line, Box and the CSV downloads come with the Education, Research and other plans.

  1. Load a dataset, open Tools, and choose the Data tab.
  2. Press Pin on globe. Its box ticks and the counter shows how many pins are down (up to 6; 2 with Plus).
  3. Click (or tap) the globe where you want to measure. A coloured pin appears there.
  4. Drag a pin to move it.

Each pin has a row with its colour, its value with units, and its place. The value also shows beside the pin on the globe, in a small box edged in the pin's colour: up and to the right of a pin in the northern hemisphere, down and to the left of one in the southern, so it never covers the data at the pin. It follows the globe as it plays, and hides while the pin is round the back. The headset and the phone in AR show it the same way. × removes that pin. When you have finished pinning, press Pin on globe again to turn it off.

Rename a pin: click its name (the pencil beside it shows it can be changed), type a name of up to 32 characters, such as Lima or Buoy 4, and press Enter, or click elsewhere. Esc leaves it as it was, and an empty name gives the pin its own name back (Pin 2, Highest). The name is the pin's everywhere: in the list, on the graph, in the CSV, on the globe (in front of its value) and in the headset, on a phone in AR, in a Lab space and in a Khipu you record (as the pin's note). It stays when you move the pin.

The graph under the pins draws one line per pin across the dataset's whole time span, in the pin's colour, on a shared scale. It fills in as the dataset plays, and says how much has been read so far. Press play, or drag through the dates, to complete it faster. The thin strips under the graph show which frames each pin has read; a faint mark means that frame had no data at that place, such as land on an ocean dataset. Every frame a pin reads is kept: each time the dataset loops, the graph only adds the frames it had not read yet, and each value is read from the frame on the globe at that moment, so the line never changes shape between laps. On a long dataset, with more frames than the graph has points across, each point is the average of the frames read there, and the line gets more precise with every lap.

Reference lines. Some datasets come with a boundary that gives their values a meaning, drawn as a dashed line across the graph and named at its right end:

Under the graph, Reference lines turns them on and off, with each line named in full beside it (hold the pointer over a name for what it means). When a line is far from your pins' values, the graph keeps its scale for the data and the name says (above the graph) or (below the graph). While you compare with a baseline, the graph shows changes, so the lines are left out. The same switch is in Tools → View, and in the headset's View page; it hides the lines everywhere, on the graph and on the legend, and the app remembers it on that browser.

Statistics on the pins (Research and Situation Room plans): under the graph of a dataset with dates, Trend, Emergence and Correlation test the pins' series. Let the dataset play to the end first: a test on part of the window says so. On other plans the buttons carry a lock and open the plans.

The results are added to Download CSV with every number shown and the method of each.

A green line on the graph marks the date the globe is showing and moves as the dataset plays, so you can still see where you are once the graph is filled in. Point at the graph to see a dashed line with the date under it on its right (in the window over the globe, also each pin's value there), and Click to play from here on its left; click to play from that date. Near either edge the two swap sides or stack, so neither covers the other. On a touch screen, tap.

Pause, then point at the graph to read the past on the globe: while the dataset is paused, the value beside each pin on the globe follows the pointer, showing that pin's value at the date under it (with a dashed edge, since the globe's colours still show the paused frame). Move off the graph, or press play, and the pins show the frame on the globe again.

Take the graph out onto the globe to see it bigger:

The next time you take it out, it returns to the place and size you left it in, on that browser.

Download the values: Download CSV under the graph (or the ⤓ button in its window) saves the pins' values as a CSV file for a spreadsheet: one row per date of the dataset, one column per pin, with the dataset, the units and each pin's place at the top, then where the data came from (its credit, sources and licences, and a link back to the view; see Citing a view). The dates are in UTC and as precise as the dataset: 2075 for a yearly one, 2003-08 for a monthly one, the full date and time for an hourly one. A blank cell is a date the dataset has not played yet; no_data means it played and there was nothing measured there.

If the tab says the dataset is a picture, its colours carry no numbers, so pins cannot read it. Choose a live or recorded stream instead.

Analyze: statistics, lines and boxes

The Measure buttons in Tools → Data measure the frame on screen, on every dataset that carries values: the live and recorded streams and the catalogue's older value-carrying datasets. The results open in the Analyze panel.

Analyze in the bar at the bottom (beside Browse and Tools) opens the panel in one click, on the region last chosen beside Statistics, and closes it again. It is there on the plans with whole-region statistics (Research and Education) whenever the dataset on screen carries values.

On a computer Analyze is a side panel like Browse and Tools: it slides in from the edge, beside whichever of them is open, and the globe glides to the middle of the space left, with Help and the account button stepping aside. If the window is too narrow for all of them, the panel opened earliest closes.

The panel has five tabs under the region picker, so it never becomes one long column (the arrow keys move between them, and it opens on the tab you used last; Statistics in Tools always opens on Statistics, Line on Profiles):

Each result can be saved as a CSV file for a spreadsheet: Download CSV under the statistics (with the full distribution of values), Download the line as CSV under a line, Download the profile as CSV under By latitude. Each file says what it is of (the dataset, the region, the units) and is named after it, for example ayni-stats-zone-tropics-…-2026-10-04.csv. Its first rows also say where the data came from: the dataset's id, the frame's date and time, a link that reopens the view, the data's credit, its sources and their licences, and a ready-made citation. Cite this view under the results opens the citation (see Citing a view).

The line over time (Hovmöller diagram)

With a Research or Situation Room plan, Line over time (Hovmöller) under the line in the Profiles tab records how the values along your line change as the dataset plays. There is nothing to start: once the line is drawn, each frame the globe shows becomes a row, the way pins fill their graph. Play the dataset (or move through it) and the diagram fills in; frames that play too fast to be read stay empty until the next time round.

Comparing with a baseline

With a Research or Situation Room plan, Hold as baseline in the Baseline tab keeps this frame's numbers. Play or move to another frame, or open another dataset in the same units on the same grid, and every statistic shows how much it changed (for example +0.097 °C vs baseline). The By latitude chart draws the baseline as a dashed line and names the band that changed most.

The change on the globe. Under the baseline, On the globe draws the change over the whole dataset, on the globe itself:

A period as the baseline (a climatology). At the top of the Baseline tab, choose A period instead of One frame to compare with the average of many years, the way climate scientists do. It works on the streams that have a time axis of frames.

Statistics over a whole region (the globe, a band of latitude, a continent, what you can see) come with the Research and Education plans. With the other plans (Situation Room, Plus, Media, Venue), Measure has Line and Box: draw a box and the panel gives its full statistics. The Analyze downloads come with every plan except Education, which has the pins' Download CSV.

The area over a threshold

With a Research or Situation Room plan, Area over a threshold at the bottom of the Statistics tab measures how much of the region is above (or below) a value: how much of the ocean is warmer than 28 °C, how much of a country is under smoke above the unhealthy line. Choose Above or Below and type the value; the box suggests the region's 90th percentile on the frame on screen.

Comparing two datasets

With a Research or Situation Room plan, the Compare tab subtracts B from the dataset on the globe (A), place by place, on the same date. Under Compare with, B is A real-time overlay that carries values (chosen in Tools → Layers → Real time) or Another globe when two or four globes are on screen. This is the map papers show for a model against observations, one emissions scenario against another (for example sea ice under SSP5-8.5 minus SSP1-2.6), or a forecast against what happened.

Recording a research session

With a Research or Situation Room plan, Tools → Data → Record this session keeps a record of your work: what you looked at, in order, with every number you read and every file you exported. It is the record behind a figure, kept with a study or sent with a paper. Nothing is recorded until you switch it on; while it records, a red Recording mark shows at the top of the screen. Press it, or Records…, to open the Research record panel. Other plans with the data tools see the button with a lock, which opens the plans.

Lab space: sharing with your lab

With a Lab or Department plan (or a Situation Room team, or a custom licence with the data and research tools on several seats), Tools → Data → Open Lab space shares work between everyone who holds a seat of the same licence. Researcher (one seat), Plus and the other plans with the data tools see the button with a lock, which opens the plans.

Comparing datasets on several globes

In Tools → View → Layout, choose two globes (side by side or stacked) or four. Or, on any dataset card in Browse, open the ⋯ menu and choose Open beside: the dataset opens on a second globe next to the one shown.

Each globe has a row at its top-left corner:

What follows from that:

An output window for a projector

Tools → More → Open an output window opens a second browser window with the globes alone: their number rows, legends and the date, and no buttons. Drag it to the projector or the second screen and press F11 for full screen. Everything you do in the first window shows there: the dataset, playback, turning, the layers, several globes and their date rules, a Khipu's captions. The browser may ask you to allow pop-ups the first time.

In a meeting the output window joins the meeting as one more follower, so it shows what everyone sees, drivers' globes included.

A sphere output (Science On a Sphere)

Tools → More → Open a sphere output (2:1) opens a window that shows the main globe as one flat picture of the whole Earth, twice as wide as it is tall (2048 × 1024): the format Science On a Sphere and other spherical displays play. It has the globe's own colours, borders and layers, and the pins from the Data tab, and it follows the first window as an output window does: the dataset, the date and playback. Capture that window on the sphere's computer (for example with a capture or streaming tool) and play it on the sphere. Turning the globe does not change it: the sphere shows the whole Earth. For a 4096 × 2048 picture, change sphere=2048 to sphere=4096 in that window's address. In a meeting's output the pins are not shown.

Ayni Chatbot

Ayni Chatbot is the app's guide: ask it to find data, to take you somewhere, or what the globe shows. It comes with the AYNI XR plans: sign in with a plan that includes it.

With a Research or Situation Room plan it also uses the research tools, with the same numbers as the panels and every caution they give:

On other plans it says in one sentence that these are part of the Research plans.

It answers by text only. In a meeting, guests do not see it.

Playlists

Playlists are your own sequences of datasets:

Khipus

A Khipu (an AYNI Khipu, a .kpu file) records what is shown on the globe, step by step: a story with its datasets, views, dates, captions, pictures and links; a lesson; or the record of a session. The name comes from the Andean khipu; see About.

Lessons

The lessons, in Browse's Khipus tab, are AYNI's lessons for grades 6 to 12, built on the NGSS standards. They come with the Education plans (Teacher, School and District). Signed out, or on another plan, the tab says so and links to the plans.

AYNI lessons are © Pachamama Studios B.V. under CC BY-NC-SA 4.0. They are not for commercial use, and not for use in promotion by any company or organisation, without permission. A lesson you adapt keeps that licence and its credit.

Your own data

With a Researcher or Lab plan, the My data tab in Browse turns your own files into datasets on the globe that only you can see (and, on a Lab plan, the rest of your lab). They never appear in the catalogue or in search. My data appears once own data is switched on for the site; until then the tab and Account → Passkeys are not shown.

Sharing and downloading

Citing a view

For a paper, a report or a slide, Cite this view writes down exactly what is on the globe. It is in the information panel, under Data credit, and in the Analyze panel, under the results. It works on every plan.

A figure and a methods paragraph

With a Research or Situation Room plan, Figure and Methods sit under the tabs of the Analyze panel. Both open one window, and opening it pauses playback, so everything in it describes one frame. With other plans the two buttons show a lock that opens the plans.

Everything in one file: the bundle

With a Research or Situation Room plan, Bundle (.zip) beside Figure and Methods saves what a reader needs to check your numbers and open your view again, in one zip. Playback pauses first, so every part describes one frame.

Meetings

A meeting is a session that one presenter drives while everyone else watches and takes part from their own screen: computers, phones and tablets, in the room or far away. Joining never needs an account.

Hosting a meeting

Hosting needs a signed-in account with a plan that includes meetings (see Accounts and plans). A meeting holds as many people as the plan says, up to 500; once it is full, nobody else gets in until someone leaves. In a meeting of more than 50, the presenter's camera reaches each person within a few seconds of going live (up to 20 seconds at 500), so that everyone does not connect in the same instant. A game takes up to 50 players; past that, the others follow the board.

  1. Open Tools and press Start a meeting…, then Create meeting.
  2. Invite people with the link:
    • Email, Gmail, Outlook, WhatsApp, Share… or Copy link;
    • or show the QR code on a projector for phones to scan;
    • or read out the code under the link (for example K7QXP M2RT9): people type it on the AYNI XR home page.
  3. Optionally invite a moderator with their own link.
  4. Press Start presenting.

A meeting and its links last 8 hours. Until you arrive, participants wait in a lobby.

Joining

Open the link or scan the QR code. Or go to vr.ayni.eu.com, and under Or type the class or meeting code type the code you were given (spaces and dashes do not matter) and press Join. If no class or meeting with that code is open, the page says so. You see what the presenter shows. You cannot change it; the controls are hidden. Add your name if you like: only the presenter sees it.

In a class (a meeting started with an Education plan), you also get Tools with the Data tab, on your own device and with no account: read values under the pointer, drop up to six pins of your own, see their graph and download it as CSV, and measure with Line and Box. Your pins are yours alone and are not kept: they go when the meeting ends. When the teacher starts a class, the meeting panel says so.

Camera and microphone

The presenter can press Go live: camera and mic, with buttons to mute, turn the camera off, change devices or stop. Participants see the presenter in a small window: tap it to hear. Sound only saves data.

Doing things together

The presenter presses Start an activity. The window that opens can be dragged by its title (or moved with the arrow keys from its ⠿ grip) off whatever the presenter wants to show; choosing another kind of activity empties the question box.

Every activity can have a time limit with a clock everyone sees. Without a limit, the clock counts up.

Your name. On arriving, each participant is offered a small card, Your name (optional; Not now skips it). Their pill at the top (You: Ana, or Add your name) changes it later. The presenter and moderators see the name next to the participant's answers until the meeting ends; without one, a participant is Guest 3 (their number in the meeting). It works the same in a browser, on a phone and over the camera in phone AR. A headset asks for it on the page, before entering VR.

Answers kept for the meeting. Each participant's answers stay theirs for the whole meeting: a reload or a dropped connection loses nothing, and an answer is never counted twice. My answers lists one's own. Nothing leaves the meeting, and all of it is deleted when it ends.

People. The presenter and the moderators have People (n): everyone in the meeting, with raised hands, who has a globe and whose microphone is on. From there they can:

The Answers tab lists the meeting's activities. Press one to see each person's answer (a place with how far it was, an option, or the pins they dropped). A poll shows only its totals.

While a participant has the globe, the presenter can Take over for a moment (the participant's microphone goes off, and they are told the globe will come back) and Hand back when done.

Participants can Raise your hand. The presenter or a moderator can Give the globe to them and Take back later.

Ending. The presenter's End meeting (asked once more) ends the meeting for everyone: everyone sees "The meeting has ended", everything the meeting kept is deleted, and its links stop working. Everyone else has Leave, which closes the meeting for them only; they can come back with the same link while it lasts. Close on that last card opens AYNI XR again without the meeting.

Games in a meeting

With an Education plan (Teacher, School or District), a meeting can play games. The presenter presses Games, beside Start an activity:

In Wayra and Team Earth each table plays at its own pace: the presenter presses Start at every table and watches each table's progress; the board ranks the tables, since a table plays together.

Choose the answer time (and, for Where on Earth?, the number of rounds), then Start the game. Everyone else joins by themselves:

Someone whose connection drops comes back with the same name, table and points, in the same browser tab. Someone who arrives during a round plays from the next one. Nothing about the game is kept after the meeting.

After a trivia or Where on Earth? game, the final board offers Download as a Khipu and, on plans that keep Khipus, Save to my account: a story with one step per round, showing its question, the right answer and what the room answered in totals (never names or points). A trivia game kept this way can be played as trivia again.

In a headset, a player sees the game in the Khipu panel beside the globe: a trivia round's answers are its buttons, and a Where on Earth? round is answered by tapping the globe. Wayra and Team Earth are played on a phone or a computer. On a phone in AR, the game panel shows over the camera.

Several globes in a meeting

When the presenter shows two or four globes (see Comparing datasets on several globes), everyone in the meeting sees the same globes, each with the presenter's dataset and date rule. Beside each raised hand the presenter also finds Give globe 2 (3, 4): that participant then drives that globe from their own screen, and everyone sees it. A driver can turn their globe, give it a dataset through its chip (Browse opens loading into that globe only) and set its date rule; the main globe, the clock and the other globes stay the presenter's. While any globe is driven, turning one globe no longer turns the others. The globe's row says who drives it. The presenter sees the globes handed out under the activity bar, with Take back on each; a driver has Give it back. A globe goes back by itself when its driver leaves.

In a class, the meeting lends four globes to everyone in it, so a teacher on an Education plan can hand out globes 2, 3 and 4.

A driver can also speak to the meeting: press Microphone on: everyone hears you (the words beside it say what that means, and the browser asks for the microphone), then Mute or Stop. Only sound is sent, never a driver's camera. Everyone else sees Drivers speaking with a chip per globe, muted until they press Listen to the drivers. A driver's microphone stops with Stop, when they give the globe back, when the presenter takes it back, or when they leave.

Save as Khipu keeps what the room was shown (not the audio or video) as a Khipu: the datasets, the views you rested on, each question with its totals, and the pins with their notes, never anyone's name. Download (.zip) saves it, Save to my account keeps it on plans that keep Khipus, and Play it to the room replays it in the Khipu player while the room follows (see Khipus).

Limits to know

The Situation room

With a Situation Room plan, Tools → Situation room opens the room's panel beside the globe. It is made for a civil-protection or operations room: what is happening now, how old each piece of data is, a board for the room's screens, and briefings that are kept as a record. Everyone who holds a seat of the licence shares the same room.

The clock at the top gives the time in UTC and in your local time.

How old the data is

Each globe's stream is listed with how old its data is:

The line above the list sums it up.

The board

Show the situation puts the board's first view on the globes: rain, fire, smoke and wind on four globes over Europe. Each globe shows its own stream's newest frame, so a daily stream is not left behind by an hourly one.

Play the board plays all its views in turn, as the room's screens do: the situation now, disaster alerts, earthquakes, then the next days' rain, fire danger and smoke. Change the board opens it in the Khipu editor: move the camera to your region, add or remove views, change how long each one stays, then press Save as the room's board. The screens show the new board from their next round. Back to the standard board undoes your changes.

Wall displays

A wall display is any browser on a screen in the room. It needs no account and takes no seat.

  1. On the screen's browser, open vr.ayni.eu.com/?wall=1. It shows a code like KQ7-M2X.
  2. In the panel, under Wall displays, type the code and a name for the screen (for example "Main wall"), and press Pair.
  3. The screen starts the board within a few seconds and plays it again and again, with the screen's name, the clock, each view's title and how old each globe's data is. Nothing on it can be pressed.

The screen stays on (it asks the browser to keep the display awake), keeps playing the last board if the network drops (it then shows "Offline"), and reloads itself every three hours to pick up new data. A code lasts ten minutes; a room pairs up to four screens. Unpair stops a screen at once: it shows a new code.

To show a briefing on the screens, present it as a meeting (below) and press Show this meeting on the walls in the panel of the page that presents it. The screens join the meeting at their next step and go back to the board when you press Take the meeting off the walls or the meeting ends.

Giving a briefing

  1. Under Briefing, choose The 72-hour briefing (or the board).
  2. Tick Put my name on the record if the record should say who gave the briefing. Without it, the record has no names.
  3. Press Start the briefing. It plays in the Khipu panel: each step has notes for you (open by default; the room does not see them) and names the next step. Move on with Next.
  4. The last step, Decision, has a box: write what was decided.
  5. Press Finish the briefing in the Situation room panel.

While it plays, the panel shows Recording the briefing. The record keeps each step you showed, with the date of the frame on every globe and how old it was then, a picture of each globe, and the decision. Then:

Start a meeting for it invites officials who are not in the room; they join free, without an account. While you present the meeting, the own layers you show on your globe are shown to everyone in it too; hide one (untick it under Your layers) and it leaves their globes within half a minute. When the meeting ends, they can no longer read them. Second screen opens the globes alone in another window, for the projector, while you keep your notes.

Your layers

Add your own sites, areas or routes, such as shelters, hospitals, flood zones or evacuation routes, as a GeoJSON, KML or KMZ file (Add a layer). Each layer gets a colour, and its features' names are written on the globe when you zoom in. Over your layers the globe zooms closer than usual. Tick a layer to show or hide it on this computer. Layers are private to your licence and its screens. Only each feature's name and description are kept from the file. A room keeps up to ten layers of 1.5 MB each.

Limits to know

Shared sessions and the AYNI XR marker

A shared session is an open room for friends or a class: everyone who joins follows the person with an account who has been there longest. It holds up to 5 people when it is opened from a free account, and up to 40 from a presenting plan. Someone who joins through the link without an account only watches, as a meeting's audience does, and never leads.

To start one, press Show anchor (top left). The screen shows the AYNI XR marker and a QR code. Others scan the QR code to join.

The marker puts the same globe in the same place for everyone in AR, on Android phones:

  1. Lay the marker flat, on a screen at full brightness or on paper at least 10 cm wide.
  2. In AR, press Scan marker.
  3. Put the dot in the middle of your screen on the marker, and move slowly.
  4. When it says Aligned, the globe floats just above the marker. The green outline should sit on the marker's edge; if it does not, scan again.

Marker alignment is new and is still being refined.

VR on Meta Quest

  1. Open the site in the Quest browser. Loading a dataset first is optional: you can choose one in the headset.
  2. Press Enter AR (or Enter VR). The globe appears in front of you at eye height. Hints over the controllers name the buttons, and fade after a few uses.
Control What it does
Trigger and drag on the globe Turn the globe (flick to spin it)
A or X, aiming at the globe Drop a pin there
Both triggers Pull apart or together to zoom, twist to turn
Grip on the globe Carry it somewhere else
Grip held away from the globe Leave VR
Thumbstick Zoom; over a list, scroll it

The dock under the globe has three rows:

Browse has Catalog and Recent, the same kind and theme filters as the browser, and a search you type on the keyboard drawn on the panel. The list scrolls: push the thumbstick while you point at it, drag it with the trigger, or drag its scroll bar. A lock means the stream is not in your plan.

Layers has up to two overlays (each white, black or as published) and the real-time streams, as Tools → Layers does. Long lists scroll the same way. With Real time open, the streams playing are listed at the top, top first as they are drawn, each with an eye (hide it on the globe, and show it again) and a ✕ (take it off). Point at a stream's ⠿, hold the trigger and move up or down to change the order. Its palette button opens the stream's colours: pick a palette, and use − and + to move its minimum and maximum, and Transparency with its own − and + (10 % a press; a stream whose colours cannot change shows only this). Done goes back. Under the streams (and with none playing), the dataset's line (green, with a lock) has its palette button (it opens View, with the dataset's colours and transparency), its eye (hide it, and show it again) and its ✕ (close it and every stream). View has the dataset's Transparency beside Reset colours.

View has the palettes and Invert palette. Colour limits are set in the browser.

Data: aim at a place on the globe and press A (or X on the left controller) to drop a pin there, up to six. Each pin shows its value on a label that leans toward you, so it does not cover the data around it. The panel lists the pins with the graph. Mark highest & lowest and Clear all work as in the browser. The pencil on a pin's row renames it: type the name on the keys drawn on the panel (a word starts with a capital by itself) and press Done, or Cancel; an empty name gives it its own back. A pin you named shows its name in front of its value on the globe, in the headset and in the browser alike.

The legend stands beside the globe on the left. Its ✕ closes it: it flies into the side panel and waits at the foot of View, where Beside the globe puts it back (and Park it here closes it from there). On a dataset that carries values, the value under the ray shows beside the dot where the ray meets the globe, with its place.

A Khipu or a lesson that is playing (see Khipus) has a panel to the left of the globe, above the legend: its title, the step, what the step says, and Previous, Play/Pause, Next (Finish on the last step) and ✕. Pictures, clips and links are not shown in the headset: the panel says how many there are, to see in the browser. A step's quiz has its answers as buttons: press one, and the right one is marked. The step's pins stand on the globe with their notes, beside your own. In a meeting, the presenter's step shows in the same panel, without buttons.

The dock and the panels follow the globe: they stay beside it when you move it, zoom it or walk round it.

Placing the globe in your room (passthrough): press the place button beside the dock, aim at a surface and pull the trigger, then look up or down to set the height and pull the trigger again.

What you change in the headset (the dataset, layers, colours, pins) is there in the browser when you leave, and the browser globe turns to the side you were looking at.

AR on Android phones and tablets

Open the site in Chrome on an Android device with Google Play Services for AR, and press AR (top right). The first time, a short page says what to expect; press Start AR.

Over the camera picture:

  1. Placing: press Place. "Step 1 of 2 — aim at a surface", then Place; "Step 2 of 2 — tilt to set height": tilt the phone and press Place again.
  2. Turning: drag one finger sideways to spin the globe, up or down to tilt it.
  3. Size: use the slider on the right edge. Two-finger gestures are not used, so you cannot change the size by accident.

Browse is the same panel as in the browser, with search, tabs, filters and playlists. Layers, Data and View are the Tools tabs. In Data, press Pin on globe, close the sheet, and tap the globe to drop a pin; its value shows beside it on the globe.

A Khipu or a lesson that is playing shows its panel over the camera, under the legend, with the same buttons as in the browser.

What you change in AR (the dataset, layers, colours, pins) stays when you leave.

iPhones and iPads cannot enter AR, but they can join rooms and meetings in the normal view.

The Studio: videos of the globe (Media plans)

With a Media Desk or Newsroom plan, the Studio button in the bar (next to Browse) opens a panel for making a video of what you see. It opens at the right edge like Browse and Tools, and the globe moves aside to stay in the middle of the space left. Rendering videos is not open yet; you can frame and save shots and see their price today.

Accounts and plans

What is free: with a free account, the whole Science On a Sphere catalogue and shared sessions with friends. Joining a room or a meeting through its link needs no account at all, so students never need one.

Signing in

Press Sign in (top right). Your first sign-in creates your account.

You stay signed in for 30 days after your last visit. Sign out and Delete account are in the same menu. Deleting your account (and with it your own data) first asks you to confirm it is you: with a passkey, or an eight-digit code sent to your address.

Plans

Plans and pricing (in the account menu, or See the plans) shows the plans for each kind of user. The same plans and prices are also on a page anyone can open without an account: vr.ayni.eu.com/pricing (en español).

The plans cover:

Each card lists what the plan includes. Your plan shows the same for your licence in use, and any extras added to it (for example statistics over any region, or four globes).

Plus, Teacher, School, Researcher and Lab can be bought online where online payment is open (below). Every plan can also be bought by invoice: press Request an invoice (on an online card, Or request an invoice) or Ask for a quote, fill in the form, and the licence key is emailed when the invoice is paid.

Buying a plan online

  1. Open Plans and pricing and the tab for you: Everyone (Plus), Education (Teacher, School) or Research (Researcher, Lab).
  2. Plus: under Choose packages, tick one package, or All packages (two or three are sold as all four), then choose Yearly or Monthly; yearly costs about a third less. The other plans are yearly. Teacher and School: tick packages to add live data on top, or none. Researcher and Lab include every package.
  3. The big price is before VAT; the line under it is what you pay in your country, with VAT. A business with an EU VAT number can add it in the checkout.
  4. Press Buy. If you are not signed in, sign in first: the plan goes on your account.
  5. Press Continue to payment. Paddle, our reseller, opens its checkout over the page and takes the payment; your receipt comes from Paddle.
  6. The plan is on your account a moment later, in use, with no key to type: open Your plan to see it. If you already had a key for the same plan, the bought licence takes its place; a seat someone else gave you (a school's, a lab's) stays beside it.
  7. School and Lab: in Your plan press Show the key to share and give the key to the people the plan covers; each signs in and enters it under Your licence key (below).

The subscription renews by itself every month or year until you cancel it. Your plan shows it: the plan, its packages, and when it renews.

Your licence key

Open Your plan, type the key (AYNI-XXXXX-XXXXX-XXXXX-XXXXX) and press Activate. The licence stays on your account, so it works on any device where you sign in.

Several licences

One account can hold up to five licences: for example your own Plus and a Teacher seat your school gave you. Each takes one seat of its own licence. You work with one of them at a time, the licence in use.

Privacy and your data

The full policy is at vr.ayni.eu.com/privacy. The terms of use are at vr.ayni.eu.com/terms (en español).

Keyboard shortcuts

Key What it does
Space Play or pause
← / → One frame back or forward
Home / End To the start or the end
Esc Close the open panel
Enter Send a chatbot message
Arrow keys in the Tools tabs Move between tabs

Help, feedback and troubleshooting

What works where

Computer Android phone or tablet iPhone or iPad Meta Quest
Browse and watch Yes Yes Yes Yes
Value under the pointer Yes Use pins Use pins At the controller's ray
Pins and graph Yes Yes (also in AR) Yes Yes
Layers and colours Yes Yes (also in AR) Yes Yes
Analyze: line, box, statistics Yes Yes Yes No
Your own data: upload, review, share, sources Yes Yes Yes No
Several globes Yes As many as the screen allows As many as the screen allows Shown in an arc (the tools work on the main globe)
Ayni Chatbot Yes Yes Yes No
Khipus Yes Yes (also in AR) Yes Yes (the steps and buttons; pictures and links outside the headset)
Host a meeting Yes Yes Yes No
Join a meeting Yes Yes (also in AR) Yes Follows playback
AR No Yes No Yes (passthrough)
Shared AR marker No Yes No Not yet