An open API service indexing awesome lists of open source software.

https://github.com/danomatika/shadowplay

An exploration of architecture and light in outdoor spaces through sound
https://github.com/danomatika/shadowplay

architecture art experiment ios light media music shadow

Last synced: about 2 months ago
JSON representation

An exploration of architecture and light in outdoor spaces through sound

Awesome Lists containing this project

README

        

ShadowPlay
==========

![ShadowPlay app icon](media/shadowplay-icon-rounded.png)

Copyright (c) [Dan Wilcox](danomatika.com) 2021

BSD Simplified License.

For information on usage and redistribution, and for a DISCLAIMER OF ALL
WARRANTIES, see the file, "LICENSE.txt," in this distribution.

Description
-----------

ShadowPlay is an exploration of architecture and light in outdoor spaces through sound. Using a bicycle-mounted sensor and a smartphone aimed skywards, the mottled patterns of light and shadow become the musical score and one rides along their city streets.

![street building shadows](composerpack/doc/street%20buildings.jpeg)

![ShadowPlay camera setup](media/shadowplay-setup-camera.svg)

Basic Usage
-----------

1. Place device in bicycle mount with active camera uncovered (either front or rear)
2. Open ShadowPlay application
3. Calibrate:
* a. Open ... -> Calibrate
* b. Press the Start button
* c. Roll bike over both light and dark areas
* d. Press Stop button when finished
4. Choose audio scene in Scenes table
5. Ride through areas of light and dark to trigger scene audio

When using the front camera facing upwards, try riding directly under trees, bridges, or overhanging objects to affect the brightness.

For a user friendly info: [ShadowPlay Tutorial PDF](http://danomatika.com/projects/shadowplay/shadowplay-tutorial.pdf) and [ShadowPlay version 1.0.0 screen recording MOV](http://danomatika.com/projects/shadowplay/shadowplay-screen-recording.mov)

See `tutorial.txt` and `composerpack/README.txt` for additional usage and scene composition details.

Developing
----------

### Dependencies

* [libpd](http://github.com/libpd/libpd): included as a git submodule

### Checkout & Build

Clone this repository and checkout it's submodules using git:

git clone https://github.com/danomatika/ShadowPlay.git
git submodule update --init --recursive

Open the Xcode project and Build/Run.

### Release steps

1. Update version in Xcode project, AppInfo.txt (+ localizations), and changelog
2. Update changelog with relevant changes
3. Archive and distribute to App Store Connect
4. Tag version

### Localization

ShadowPlay supports localization in English (Base) and German.

References:
* https://developer.apple.com/documentation/xcode/localization
* https://www.raywenderlich.com/250-internationalizing-your-ios-app-getting-started

Acknowledgments
---------------

Sound scene contributions by:
* Sofy Yuditskaya (New York, USA)
* Damian Stewart (Vienna, AT)

Supported through the UNESCO City of Media Arts Karlsruhe as well as through the City of Karlsruhe. / Unterstützt durch die UNESCO City of Media Arts Karlsruhe sowie durch die Stadt Karlsruhe.

![KA UNESCO COMA logo](media/logo_karlsruhe-unesco_rgb.svg)