Jandig is an open source platform for extended reality. Our goal is to give a way for artists share their artworks in a simple and free way.
See for yourself in the 1 minute video below (make sure subtitles are on).
Jandig uses image pattern detection to detect augmented reality markers through the camera of a device and render a content (currently a GIF ou video) on the device screen, giving the impression that your device is like a virtual window that you are looking at.
Jandig is a Progressive Web App, which means you can open in any device with a browser and a camera. You can also add Jandig to your homescreen and it will run like a native app on your device.
We are a small team based in Brazil :D talk to us on Telegram. Here's a list of some of the contributors for the development:
- @pablodiegoss (Twitter)
- @hvalois (Twitter, Instagram)
- @rodrigocam (Twitter)
- @vjpixel (Twitter, Instagram)
- @anacforcelli
- @MatheusBlanco
- @hockpond
- @devsalula
- @shayanealcantara
- @victoralvesgomide
- @manuengsf
- @darmsDD
- @luccaepp (Twitter)
- @Heloisecs (Twitter)
- @rhuancpq (Twitter)
- @LeoSGomes (Twitter, Instagram)
- @kisobral (Instagram)
- @thiagohersan
We are looking for artists (illustrators, 3d modellers, animators, and others) to create great content and help us testing the platform, people to translate our website from Portuguese to English (and vice versa), and developers to help us with the platform, please contact us via the Telegram channel or an issue on GitHub!
You can find interviews and references to Jandig in the press here.
To contribute to Jandig, it would be awesome if you read Contributing and our Code of conduct. After a good read you are ready to move foward!
We use docker and docker compose to ensure a consistent development environment and to make the deploy process as painless as possible, so all you need on your development tools to run Jandig is Docker or UV
Docker has good documentation on their website for installing docker for different operating systems like Ubuntu and Debian. To install docker-compose choose your operating system here.
On Windows, we recommend you use WSL2 and follow the linux.
To run Jandig all you need to do is:
- Clone this repo
- Navigate to the repository folder
- Run docker-compose
- Voila!
git clone https://github.com/memeLab/Jandig
cd Jandig
docker compose up --watch
If you get any error saying permission denied
try run the command with sudo or fix your docker environment by doing the linux post installation steps to avoid sudo.
sudo docker compose up --watch
Jandig server will run at localhost. To test modifications you just need to run a web browser and access http://localhost/. If you don't want to use docker or needs to update CSS files which are quite messy with Gunicorn + MinIO, you can use UV directly to run Django's development server.
DJANGO_READ_DOT_ENV_FILE=True uv run python src/manage.py runserver
If you want to test on a mobile device, you will need a https connection for AR detection, so we recommend ngrok to generate an https link for you.
sudo snap install ngrok
ngrok http 8000
ngrok will prompt 3 links:
Select the one with https
at beginning.
To run Jandig all you need to do is:
- Install WSL2, Git and Docker
- Clone this repository
- Navigate to the repository folder using WSL2
- Run docker compose
- Voila!
git clone https://github.com/memeLab/Jandig
cd Jandig
docker compose up --watch
The Jandig platform count with a High-Fidelity Prototype which aims the development and documentation of improvements related to usability. To acess and contribute with the prototype, follow the instructions in Prototype Documentation.