# Gallery service plugin - 1.0

This service takes a list of images in the /images_artwork folder and display a random image on the screen.

this service is handled by default in the `wall_paper`bundle.

Gallery service depends on the `eink` service, for the image display. 

## Configuration

No additional configuration is required for this service, 

| Env Variable | Description                                           |      |
| ------------ | ----------------------------------------------------- | ---- |
| FILES_PATH   | folder in which the images are stored for the gallery |      |
|              |                                                       |      |



## Detailed commands

### random_get_image

This function take a random image and send it to the eink screen. The service communicate with the eink service directly to trigger the display.



## Sample for using the gallery using the admincli / admin_web commands



```
deploy_app('wall_paper', False)
activate_app('wall_paper-1.0', {"FILES_PATH":"/images_artwork"})
start_app('wall_paper-1.0')

```

scheduling a periodic change using the wall paper / gallery service :

The current following command line trigger the random_get_image every 20 minutes

```
call_service('scheduler', 'update_or_create_job', 'gallery_refresh', 'call_service(\'gallery\',\'random_get_image\')','*/20 * * * *' , True)
```



undeploying

```
stop_app('wall_paper-1.0')
undeploy_app('wall_paper-1.0')

```