voicegardens/README.md

# voicegardens

> https://voicegardens.org
>
> http://doesitsparkjoy.voicegardens.org

## @ Interwebz

* [barbican.org.uk: This is Public Space](https://www.barbican.org.uk/whats-on/2019/event/this-is-public-space)
* [upprojects.com: This is Public Space](https://www.upprojects.com/projects/this-is-public-space/)

## Meanwhile, in the padiverse

* [kari.this.is.public.space](https://pad.vvvvvvaria.org/kari.this.is.public.space) (private)
* [vocoder](https://pad.vvvvvvaria.org/vocoder) (public)

## Doodle Doodle Doo

* [wet-signal-voice-garden.pdf](./media/wet-signal-voice-garden.pdf)
* [staringcaring.com](http://staringcaring.com/)

## Hackity Hack Hack

Please note, these commands were run on a Debian Stretch system.

### Install packed lunch

```bash
$ sudo apt install -y make git
```

### Get your discount source code

```bash
$ git clone ssh://gitea@vvvvvvaria.org:12345/varia/voicegardens.git
$ cd voicegardens
```

### Do the Python dance

```bash
$ python3 -m venv .venv
$ source .venv/bin/activate
$ pip install -r requirements.txt
```

### The curious case of GDAL

It's really hard to install GDAL. We need it to generate the tiles for the map.
Here is one way to do it but you might run into problems and need to research a
bit.

```bash
$ sudo apt install -y libgdal-dev
$ pip install pygdal=="`gdal-config --version`.*"
$ pip install gdal2tiles
```

And then it should be possible to run the tile generation.

```bash
$ gdal2tiles.py -l -p raster -z 0-5 -w none tiles2
```

You may need to use `python gdal2tiles.py` instead?

### Run the server

```bash
$ make dev-serve
```

### Deploy the site

You can add the following to your SSH configuration:

```
Host voicegardens.org
  Hostname voicegardens.org
  User voicegardens
  Port 12345
  IdentityFile ~/.ssh/my-ssh-secret-key-file
```

(Where you should replace "my-ssh-secret-key-file" with the real filename.)

Make sure you can SSH into the server.

```bash
$ ssh voicegardens.org
$ sudo -i  # you have root access too
```

Then it's possible to release the site with the following targets.

```bash
$ make doesitsparkjoy # https://doesitsparkjoy.voicegardens.org
$ make voicegardens   # https://voicegardens.org
```

### Layers of the Onion

* [Flask](http://flask.palletsprojects.com/en/1.1.x/)
* [Leaflet](https://leafletjs.com)
* [Mappa.js](https://mappa.js.org)
* [p5.js](https://p5js.org)

## License

TBD.