SoundClout Application User Guide

Github Repo

About the team

Video Quickstart Guide:

The Soundclout app is an application intended to control and distribute a series of instructions to raspberry pi devices for use in a sound art installation. Even though the intended use of the app is for an art installation, it can still serve as a generalized raspberry pi controller.

The raspberry pis need to be configured with specific code we have developed in order to properly recieve and execute instructions from the soundclout app. A guide for setting up the RPi devices can be found here.

Home Screen:


To get started you must connect to the raspberry pis you intend on using. Go to the "Connect Devices" Page.

Connected Devices page:

Connected Devices

First make sure your computer's bluetooth is ON. Hit scan(1) and the app will search the list of bluetooth enabled devices in the area for the configured raspberry pis. The list of devices that show up in the list under scan(2) will only be the pis that are configured for the app- so any other devices in the area won't be available to make a connection. Click on the device name in the list to add it to your list of connected devices(3). If you wish to disconnect from a device simply click on the name in the connected devices area(3). If you want to disconnect from all devices, hit the button(4). Click the home icon in the top left corner to return to the main screen.

To test the raspberry pis you are connected to, navigate to the "Device Tester" screen.

Device Tester Screen:

Test Devices

There will be a list of the devices you are connected to(1) and then you can toggle the switches(2) next to the name to "ON" and hit the test button(3) to start running the components connected to the Pi(s).

Once you are satisfied everything is working as intended you can start grouping together your devices

Go to the "Edit Device Groups page" to begin adding devices.

Edit Device Groups Page:

Edit Device Groups

Select Create Group(1) to create a new group. Groups are collections of devices that all receive the same instructions from the application. Alternatively you can Load Groups(2) to load a configuration you have previously saved.

New Group Screen:

New Device Groups

Where it says "New Group"(1) you can name the group whatever you'd like and then hit ok(2) when you're satisfied.

You'll see this after you hit ok:

Group Settings

Now you can see your group settings and the devices that you're connected to(1) in this page. Hit the switch(2) to choose which devices are active inside of this group. Hit back(3) to go back to the edit device groups screen - or hit remove(4) to delete this group.

Now the Edit Device Groups page looks like this:

Edit Device Groups2

You can now see the groups you have made in the edit device groups screen. You can click save(1) to save your current group configurations if you want to.

Now we can return to the main screen.

Navigate to the "Edit Group Behavior" screen to start building a timeline. A timeline is a group of time slots that tell each device group how to behave during that slot of time. When the app is running the time slots are executed in order.

Edit Group Behavior Screen:

Edit Group Behavior

Hit build timeline(1) to create a new one or load timeline(2) to load a timeline configuration you've already made. Let's look at building a new timeline.

Building Timelines:

Building Timeline

Hit add slot(1) to add a new slot. Each slot represents a range of time in which specific setting are applied to each active group. When you select a slot(2) you can then individually configure the settings you want applied to each group of devices in that slot of time. First you must select the group whose settings for that slot you'd like to edit.

Selecting Slot Group:

Select Group In Slot

You'll see the groups you have created here(1). You can select a group to edit the slot settings, or you can press "Remove Slot"(2) to delete the slot you are currently editing. Let's select Group 1 to see its slot settings.

Configuring Group Slot Settings:

Configure Slots

The number of events(1) is how many times the connected group activates the attached components within the total time lenght of the slot. The Event length(2) is how long the components are activated during each instance of an event. The Apply Trigger(3) allows you to connect another group to the current group. When the other group triggers an event, there is a percent chance(4) you can specify that the current group will also have an event regardless of the number of total events selected. This allows groups to be dependent on or interact with one another.

Hit save(5) to commit the group behavior for this time slot.

Once you configure settings for each group in each slot, we can return to the homescreen to execute the program.

Click the start button and the program will generate a pattern to send to your connected devices based on the parameters you provided. The events will be placed randomly within a time slot so running the same pattern multiple times will generate new sequences.