Skip to content

Latest commit

 

History

History
117 lines (91 loc) · 6.23 KB

README.md

File metadata and controls

117 lines (91 loc) · 6.23 KB

Jandig ARte

ARte is a Progressive Web App for augmented reality artworks. Our goal is to give a way for artists share their artworks in a simple and free way.

You can see these galleries filled with pictures of exhibitions created with Jandig.

How it works

Jandig ARte uses image pattern detection to detect augmented reality markers through the camera of a device and render a content (currently a GIF) on the device screen, giving the impression that your device is like a virtual window that you are looking at.

usage

Jandig ARte is a Progressive Web App, which means you can open in any device with a browser and a camera. You can also add Jandig ARte to your homescreen and it will run like a native app on your device.

People

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:

Collab

We are looking for artists (both illustrators and animators) 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!

Clipping

You can find interviews and references to Jandig in the press here.

Get Started

To contribute to Jandig ARte, it would be awesome if you read Contributing and our Code of conduct. After a good read you are ready to move foward!

Prerequisites

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 ARte is Docker and Docker-Compose.
On Windows Docker Desktop also includes Docker Compose along with other Docker apps.

Installing

Docker has good documentation on their website for installing docker and docker-compose for different operating systems like Ubuntu and Debian. To install docker-compose choose your operating system here.
On Windows, you'll only need install Docker Desktop and WSL2.

Running

Linux OS

To run Jandig ARte 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

If you get any error saying permission denied try run the command with sudo.

sudo docker-compose up

Jandig ARte server will run at localhost. To test modifications you just need to run a web browser and access localhost:8000. If you want to test on a mobile device, you will need a https connection, we recommend ngrok to generate a https link for you.

sudo snap install ngrok
ngrok http 8000

ngrok will prompt 3 links:

usage

Select the one with https at beginning.

Windows OS

To run Jandig ARte all you need to do is:

  • Clone this repo
  • Navigate to the repository folder using WSL2
  • Run the conteiners 'jandigarte/django' and 'jandigarte/requirements' on Docker Desktop
  • Run docker-compose passing the docker-compose.yml
  • Voila!
git clone https://github.com/memeLab/Jandig
cd Jandig
docker-compose up

If you get any error saying permission denied try run the command with sudo.

sudo docker-compose up

Jandig ARte server will run at localhost, but by default WSL2 enables wsl localhost to accessible from windows, but no vice versa. To access you'll need to use windows system IP from wsl2.

  • Run this command on terminal:
vim /etc/resolv.conf
  • Get Network Interface (WSL) IP. It should be like:
nameserver 172.21.176.1
  • Access the localhost using this IP (e.g.: 172.21.176.1:8000)

Prototype

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.