mirrors/envision
1
0
Fork 0
mirror of https://gitlab.com/gabmus/envision.git synced 2025-04-20 03:24:52 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
620 commits 14 branches 10 tags 4.9 MiB
Find a file
Exact
Gabriele Musco 6694655690 feat: implemented basic update notification functionality
2024-09-02 07:17:27 +02:00
.forgejo/workflows chore: run codeberg ci only on main and on prs towards main 2024-08-03 11:36:35 +02:00
.gitlab/issue_templates chore: small fix in default issue template 2024-08-05 13:11:13 +02:00
build-aux feat: gnome project structure and accessory files 2023-06-18 11:34:04 +02:00
data feat: move start with gdbserver button to debug view headerbar 2024-02-04 14:00:04 +01:00
dist feat: function to check for updates 2024-09-02 07:17:27 +02:00
po feat: rename app to Envision 2023-09-09 11:23:42 +02:00
scripts feat: basalt support 2023-08-03 21:19:18 +00:00
src feat: implemented basic update notification functionality 2024-09-02 07:17:27 +02:00
test/files fix: wivrn config can have unrecognized fields, they will be ignored and reserialized 2024-07-26 11:03:27 +02:00
.gitignore feat: appimage build script 2023-07-07 06:51:42 +02:00
.gitlab-ci.yml chore: expire gitlab artifacts after 1 month (most recent artifacts will never expire) 2024-08-30 09:03:19 +02:00
Cargo.lock feat: async process based on tokio::process::Command 2024-08-24 11:34:21 +02:00
Cargo.toml feat: function to check for updates 2024-09-02 07:17:27 +02:00
LICENSE feat: license 2023-05-30 20:21:23 +02:00
meson.build feat: build appimage with default profile; devel status deduced by building a git tag or not 2024-08-30 08:49:47 +02:00
meson_options.txt feat: function to check for updates 2024-09-02 07:17:27 +02:00
README.md chore: move upstream repo references back to gitlab 2024-08-05 12:22:58 +02:00

README.md

Envision

IMPORTANT NOTES!

This is still highly experimental software, while it's unlikely that anything bad will happen, it's still unstable and there is no guarantee that it will work on your system, with your particular hardware. If you encounter any problems while using the app, make sure to open an issue.

Also consider that due to the unstable nature of the app, it's possible to encounter unexpected behavior that while in VR might cause motion sickness or physical injury. Be very careful while in VR using this app!

Orchestrator for the free XR stack.

Download Envision

  • You can download the latest AppImage snapshot.
  • Once downloaded, unzip the archive and you should find a file named Envision-x86_64.AppImage.
  • Make it executable
    • From your file manager: right click > properties > "executable as program", or under permissions enable "is executable" (this depends on your file manager)
    • From the terminal: chmod +x Envision-x86_64.AppImage
  • Double click the AppImage file to run it.

Build instructions (for package maintainers and advanced users only)

Dependencies

Arch

You can find the Arch dependencies in the PKGBUILD in dist/arch/PKGBUILD.

Debian/Ubuntu

You can find the Debian dependencies in the .gitlab-ci.yml file in this repository, in particular you can find the install command used by the CI in the appimage stage.

Building and running from source

git clone https://gitlab.com/gabmus/envision/
cd envision
meson setup build -Dprefix="$PWD/build/localprefix" -Dprofile=development
ninja -C build
ninja -C build install
./build/localprefix/bin/envision

Build AppImage

git clone https://gitlab.com/gabmus/envision
cd envision
./dist/appimage/build_appimage.sh

Common issues

NOSUID with systemd-homed

If you see this warning:

Your current prefix is inside a partition mounted with the nosuid option. This will prevent the Envision runtime from acquiring certain privileges and will cause noticeable stutter when running XR applications.

And you're using systemd-homed to manage your home partition, you need to disable it using homectl. To do so, log out, log in as root in a tty and run: homectl update <username> --nosuid=false.

Dependency checker erroneously reports missing dependencies

You can use the --skip-dependency-check option to disable dependency checking.

LVRA Community

We're a community dedicated to VR on Linux, we've got a wiki you might want to check out: LVRA Wiki. You can also chat with us.