Skip to content

Explore overte#69

Open
zedwick wants to merge 59 commits intooverte-org:masterfrom
zedwick:explore_overte
Open

Explore overte#69
zedwick wants to merge 59 commits intooverte-org:masterfrom
zedwick:explore_overte

Conversation

@zedwick
Copy link
Copy Markdown
Contributor

@zedwick zedwick commented Jan 30, 2026

Updates the Explore section to better reflect the current features and design of Overte.

  • Reword and update terminology to better reflect Overte's
  • Update to match the current Overte experience
  • Expand documentation to cover more features
  • Document interacting, modifying and saving werables
  • Improve clarity around some features
  • Remove references to macOS
  • Remove references to Android
  • Simplify Windows OS instructions by linking to Microsoft support articles
  • Update controls reference
  • Add Ada's Body Poser app as an example of an installable app
  • Replace Vircadia references
  • Update in-game UI screenshots
  • Add image of placed portals
  • Some pages have been converted from markdown to reStructuredText where I felt it would make it easier for the changes I intended to make.

I do not have access to VR myself, so for much of the VR-specific parts I had to read code, changelogs and interview people who have had experience with it on Overte. I may have gotten something wrong here, so would especially appreciate if someone with access to VR could double-check it works as stated.

Similarly for Windows, I do not have access to Windows but tried to confirm those parts the best I could. If someone with Windows could double check them for me I would appreciate that.

to something a little more recent; from 2025 rather than 2022.
* Encourage users to use push-to-talk
* Re-arrange settings table to match the order seen in the audio settings tablet window
* Add missing audio settings to table
* Cyberspace!
* OpenVR and OpenXR support
* Add missing control settings
* Update some terminaology
Also correct table issue in vr-controls
* Expand list of files which make up an avatar
* Rewrite introduction to emphasise how choosing an avatar empowers the user to express themself
* Provide more detail on where to host an avatar, without emphasising individual brands
* Mention all compatible model files
* Document grabbing wearables
* Document modifying wearables, including that modifications will be saved when favourited
* Document favouriting avatars with wearables
* Corrected information about updating apps
* Some tweaking to wording and expanded explanation
* Removed section on the no-longer-available Text to Speech app
* Include screenshots for the current Places app
* cover filtering, bookmarks, portals and home
* Remove erroneous orphaned row of Graphic Settings table
zedwick added 2 commits March 23, 2026 16:52
* Include context menu button
* Use Roboto font to match upcoming UI change
* Change fonts to Roboto to match upcoming UI change
@zedwick zedwick marked this pull request as ready for review March 23, 2026 20:49
@zedwick
Copy link
Copy Markdown
Contributor Author

zedwick commented Mar 23, 2026

I think I'll leave the system requirements alone, and let them be updated/removed in a separate PR.

Copy link
Copy Markdown
Member

@JulianGro JulianGro left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am only half-way done with the review, but I thought I should show what I have already.

Comment thread source/explore/get-started/adjust-settings.rst Outdated
Comment thread source/explore/get-started/adjust-settings.rst Outdated
Comment thread source/explore/get-started/adjust-settings.rst
Comment thread source/explore/get-started/adjust-settings.rst
Comment thread source/explore/get-started/adjust-settings.rst Outdated
Comment thread source/explore/get-started/install.rst
Comment thread source/explore/get-started/install.rst Outdated
Comment thread source/explore/get-started/setup-audio.rst Outdated
Comment thread source/explore/get-started/setup-audio.rst Outdated
Comment thread source/explore/get-started/setup-audio.rst Outdated
Copy link
Copy Markdown
Member

@JulianGro JulianGro left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some small things and nitpicks.

As mentioned in the comments, with the American English versus British English differences, I think it makes sense to just stay with American English as to not mix the two of them. American English is probably a better choice for an international audience anyway, because it has easier spelling and fewer exceptions.

Comment thread source/explore/get-started/_images/controls-vive.png
Comment thread source/explore/get-started/vr-controls.rst Outdated
Comment thread source/explore/get-started/vr-controls.rst Outdated
Comment thread source/explore/get-started/vr-controls.rst Outdated
Comment thread source/explore/personalize/install-apps.rst Outdated
Comment thread source/explore/personalize/add-wearables.rst Outdated
Comment thread source/explore/personalize/add-wearables.rst Outdated
Comment thread source/explore/personalize/add-wearables.rst Outdated
Comment thread source/explore/personalize/add-wearables.rst Outdated
Comment thread source/explore/get-started/desktop.rst
zedwick and others added 11 commits May 5, 2026 17:35
Co-authored-by: Julian Groß  <julian.g@posteo.de>
Co-authored-by: Julian Groß  <julian.g@posteo.de>
Co-authored-by: Julian Groß  <julian.g@posteo.de>
…n some contexts.

* I have left it as simply "Interface" or "Interface window" where I thought it contextually made sense.
* Also made controls instructions generic by removing specific reference to VR controller devices where it wasn't necessary.
* Mono audio input can be spatialised in Overte, where-as stereo cannot be
Comment on lines 41 to 51
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Using Bluetooth Headsets
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You can use bluetooth headsets, such as AirPods with Overte. However, note that there are limitations to using them, and they may not work in all environments. If using WiFi, ensure you’re using a 5Ghz WiFi connection. On a 2.4Ghz connection, you may experience audio breakup and occasional disconnects.

Unfortunately, bluetooth audio devices do not currently support stereo input. Therefore, you have two options:
You have two options:

* Use the bluetooth headset as an output device only, and use another microphone for input. This allows you to take advantage of the stereo audio.
* Use the bluetooth headset's built-in microphone. In this case, other users will only experience mono sound coming from you, rather than the normal stereo audio.
* Use the bluetooth headset as an output device only, and use another microphone for input. This may allow you to use a higher quality microphone than the one built in to your headset.
* Use the bluetooth headset's built-in microphone.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change

Do we want to just get rid of this entire section?
I never heard about Wi-Fi interfering with Bluetooth. In fact, on pretty much every holiday, I use 2.4GHz Wi-Fi and Bluetooth earbuds at least once and never had audio issues there.

The two microphone options seem like a weird thing to put into the documentation. It turned into an elaborate way of saying "You can choose which microphone you want Overte to use".

There is a legitimate reason for using bluetooth headphones only for audio output and not input, and that is that bluetooth headphones generally need to switch into a really low fidelity mode in such case.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There is a legitimate reason for using bluetooth headphones only for audio output and not input, and that is that bluetooth headphones generally need to switch into a really low fidelity mode in such case.

You know, the whole "You lose stereo" angle makes a lot more sense if it was supposed to be about Bluetooth's headset profile only supporting mono output, where-as a2dp would support stereo output but no mic input. Perhaps the details got lost along the way somewhere.

That is exactly what happened. I checked the git blame for that line...

Use the bluetooth headset's built-in microphone. In this case, you will only experience mono sound, rather than Vircadia's stereo audio.

Became

Use the bluetooth headset's built-in microphone. In this case, other users will only experience mono sound coming from you, rather than the normal stereo audio.

I think it make sense to warn users they would miss out on stereo/spatialised audio when using bluetooth headsets make sense. I'll try reverting it back to when it made sense.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

With regards to interference, it is possible as they share the 2.4ghz spectrum but having read up on it a little it seems both try to mitigate the problem by trying to detect interference and then avoiding those frequencies for a while (but it's a bit more complicated than that). I would assume interference noticeably impacting Bluetooth connections is possible, and really depends on how much interference/activity is happening.

Perhaps it is less of a problem now, but I'm not sure works on my holiday™ is enough proof it is no longer a problem. I think we should leave that part in for now, unless we do decide to remove the rest of this section.

@zedwick zedwick requested a review from JulianGro May 9, 2026 00:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants