/wandrer

Mobile streaming app for geo-tagged field recordings

Primary LanguageJavaScript

Wandrer is a cross-platform sound streaming app for geotagged field recordings from the Freesound library, letting the user explore places near and far through an archive of sound.

By selecting a location in the world, Wandrer generates a playlist of sounds recrded nearby using geocoordinates, and moves the user to each location as the sounds are played, creating an associative audio journey that is drawn on the screen in a generative path.

Screenshots

Getting started

Token

Wandrer requires an API key from freesound in order to query their sound library. This requires a Freesound account, which is free, after which the application for an API key is usually immediately accepted. Follow this link to apply for the key: Freesound API key

After recieving the key, it will need to be placed in the .env file after installation.

Installation

  1. Clone the repo
git clone https://github.com/awenine/wandrer.git
cd wandrer
  1. Install dependencies
npm install
  1. Start development server
npm start
  1. Insert Freesound API token into .env file in this format
TOKEN= *API key here*
  1. Scan the barcode with the Expo app on your phone or follow the terminal instructions to load up the emulator on your machine.

Built with

  • React Native - Front end library for building user interfaces
  • React Navigation - Routing and navigation for React Native apps
  • Expo - Build cross-platform native apps
  • Freesound API - Collaborative database of Creative Commons Licensed sounds.
  • React Native Maps - For rendering Map navigation via Google Maps
  • Thousands of users archiving a world of sound over 15 years

Contributing

All contributions are welcome :-)

Author

Christopher Owen - Github LinkedIn

License

This project is licensed under the MIT License.