An open-source tool designed for fact-checkers, investigative journalists, and Open Source Intelligence (OSINT) practitioners. It enables users to reconstruct spatial contexts of images and videos by projecting them onto 3D environments.
Platform Overview • Installation
Vantage is open source, licensed under the MIT License.
- Install and run Docker Desktop if you haven't already.
- Clone the repository:
git clone https://github.com/thometnanni/vantage.git
cd vantage
- Rename the
.env.examplefile to.env
mv .env.example .env
- Build and start the container:
docker compose up
- Access the platform at: http://localhost:4000 .
If you prefer to run Vantage directly using Mix (suitable for development):
Ensure you have the following installed:
- Elixir: Download Elixir
- Node.js: Download Node.js
- npm: Download npm
- ffmpeg: Download ffmpeg
- Clone the repository:
git clone https://github.com/thometnanni/vantage.git cd vantage
- Setup dependencies:
cd assets
npm install
cd ..
mix setup
- Start the server
mix phx.server
or with IEx:
iex -S mix phx.server
- Access the platform at: http://localhost:4000 .
To generate a 3D model and map of a given location, use the Vantage Scene Setup tool.
This lets you select a coordinate, generate a 3D model, and then import it into Vantage. Alternatevely, you can import any glTF file.
To reconstruct a scene:
- Generate a 3D scene using the Vantage Scene Setup tool.
- Import the model and map into Vantage.
- Align images and videos by matching their perspectives with real-world camera positions.
- Use the first-person view to position media:
- W: Move forward
- A: Move left
- S: Move backward
- D: Move right
- F: Move down
- R: Move up
- Q: Rotate camera counterclockwise (around Z-axis)
- E: Rotate camera clockwise (around Z-axis)
- Use the first-person view to position media:
- Use the mouse wheel to adjust the camera's field of view (FOV) for zooming in or out.
- Use the timeline to organize and analyze events as they unfold.