Skip to content

AurianJault/archivr

Repository files navigation

Build Status Quality Gate Status Coverage

Maintainability Rating Reliability Rating Security Rating

Built with

PHP JavaScript Bootstrap

ArchiVR

Create your own virtual 3D visit

About the project

Welcome to ArchiVR, a cutting-edge web application that allows you to craft immersive experiences from 360-degree images. Effortlessly transform your panoramic photos into interactive tours tailored to your specific needs.

Key Features

  • 360 Image Integration: Upload your panoramic images to create a 360-degree immersive experience.
  • Custom Maps: Add an interactive map to guide visitors through the virtual tour.
  • Environment Customization: Incorporate 3D elements to personalize the environment and make the experience truly unique.
  • Multi-Platform Compatibility: Generated virtual tours are compatible with Oculus, PC, and mobile devices, offering maximum flexibility for your users.

How It Works

  1. Import Your Images: Upload your panoramic images directly into the application.
  2. Customize Your Environment: Add 3D elements, a map, and adjust settings to create the desired atmosphere.
  3. Generate Your Virtual Tour: With a single click, obtain an HTML file ready to be deployed on Oculus, PC, or mobile.

Getting started

Clone the repository :

git clone https://codefirst.iut.uca.fr/git/archivr/archivr

Start app using php :

php -S 127.0.0.1:8000 -t ./archivr/src/

Optional

If you want to upload personal 3D models (.gltf), in your panorama, you have to update your php.ini (3D model files are too large for basic php config)

A script is available to update settings :

sudo ./3d-models-support.sh

If the script does not work, modify the following lines in your php.ini :

upload_max_filesize=20M
post_max_size=21M

To find your php.ini you can use :

php --ini

Authors

This project was developed by students from the IUT of Aubière (UCA), as part of a university project. The team members are:

For the futur

For those looking to modify the project, a thorough breakdown of its technical aspects is outlined in this synthesis (./Documentation/Synthesis.md), offering a comprehensive understanding of how each component works.

Acknowledgements

Thanks to ours professors for their guidance and feedback throughout the development of this project.

  • Sebastien SALVA (project tutor)

  • Audrey POUCLET (project management tutor)