Menu Close

Sound Sampler Manual

Introduction

Controls

Menu

Settings

Script files

App folder

INTRODUCTION

Sound Sampler is a soundboard app for playing sounds on button click. The sounds are customizable and are selected from media files (sound or video) from your device storage. You can create your own unique soundboard. There are different types of buttons for different playing options and you can control sound volume and balance. Also file cropping and fade in/out is possible.



App features:
– set custom sound files from your device (audio or video) for button
– use different types of play (loop, start/stop on press etc…)
– adjust individual sound volume, balance, pitch and speed
– use file cropping for sound
– fade in/out for sound
– ping pong effect for button sound
– stop fade out
– milisecond definition for effects length
– export and import button configurations
– custom number of buttons
– change button position
– set button name
– control master volume, pitch and speed

  1. Go to Menu and turn EDIT MODE on
  2. Press a button to go to button settings
  3. Select button type – 1,2,3,4,5
  4. Select the item that will be played on button press using:
    • [Select File] – to browse to file location
    • [Select Audio] – to choose audio from device storage
    • [Select Video] – to choose video from device storage
    • [Internal file] – to select files from internal app folder. For example script files has to be located in app folder so they have to be selected in this way.
  5. Adjust item parameters like crop, fading, volume, pitch, speed etc.
  6. Exit the EDIT MODE (Menu – EDIT MODE)



BUTTON TYPES:

TYPE 1: Green
– On Click – Plays the file

TYPE 2: Blue
– On Click – Plays the file
– On second click – stops playing

TYPE 3: Red
– On Click – Plays the file
– On release – stops playing

TYPE 4: Yellow
– On Click – Plays the file loop
– On release – stops playing

TYPE 5: Orange
– On Click – Plays the file
– On next click – pauses playing
– On next click – resumes playing

Button Settings in Edit Mode
– Button Type – select button type for different playing behavior
– Button position – select button position on soundboard
– Select File – select sound file from file on your device. Files can be audio, video or midi. Note that for Android 10 and further the app has access only to its specific folder. In this case you can access audio and video in other folders using buttons Select Audio and Select Video.
– Select Audio – select audio from device storage
– Select Video – select video from device storage

Other options:

  • Command – starts several buttons simultaneously. Input command like this: {button#,button#,button#}. For example {1,4,10} for starting buttons 1, 4 and 10.
  • Script file – load text script file. For each row in script file – time in seconds and buttons to be pressed are written. The format is: [time in seconds]:[button#1,button#2…]. FIle must be located in app internal folder. Use USB connection to PC and Windows browser to put script file there.

– Button Name – select button name. By default file name is set as button name.
– Volume – set volume for this sound
– Balance – set balance (left – right) for this sound.
– Pitch – set pitch of the sound. 1 is normal pitch.
– Speed – set speed of play. 1 is normal speed
– File Crop – used for cropping sound from file. Set start and end position timing. End position must be bigger than start position. Check time interval settings format for time values.
– Fade – set fade in and fade out for sound. Set length for both fades.
– Stop fade out – set fading out on sound stop. Set fade out length. When this is on then when sound stops before reaching the end there will be a fade out with specified length.
– Enable ping pong – sets ping pong panning effect (moves sound left and right). You can set ping pong effect cycle length.

TIME INTERVAL SETTINGS
General time format is:

HOURS:MINUTES:SECONDS.MILLISECONDS

For all time intervals you can fill values in format like:
– SECONDS.MILLISECONDS – example – 20.124 means 20 seconds and 124 milliseconds
– MINUTES:SECONDS.MILLISECONDS – 10:20.124 means 10 minutes, 20 seconds and 124 milliseconds
– HOUR:MINUTES:SECONDS.MILLISECONDS – 1:10:20.124 means 1 hour, 10 minutes, 20 seconds and 124 milliseconds

CONTROLS

Master volume, pitch and speed controls control volume, pitch and speed for all sounds simultaneously. You can hide/show controls in Settings – Controls.
You can enable/disable controls using check boxes.
You can reset controls to default position using Reset buttons [R] next to them.

EDIT MODE – switches ON/OFF Edit Mode
NEW – creates new blank soundboard
EXPORT CONFIGURATION – exports current soundboard configuration
IMPORT CONFIGURATION – imports existing soundboard configuration
SETTINGS – app settings
LANGUAGE – select app language
HELP – this manual

SETTINGS

NUMBER OF BUTTONS – number of buttons in current soundboard
USER INTERFACE SETTINGS – settings for app user interface
– Use custom button size – select this if you want to customize button size
– Custom button size – size of the customized button
– Distance size – distance between buttons
– Button font size
– Show used effects in button name – when this is active in button name used effects will be included
– Use scroll zone – select this if there are lot of buttons to ease the scrolling
– Scroll zone size – size of the scroll zone
– Use date time keyboard for time intervals

CONTROLS – settings for volume, speed, pitch and balance controls
– Show volume control
– Show pitch control
– Show speed control
– Show balance control
– Maximum pitch – maximum pitch for pitch control
– Pitch in semi tones – when this is active pitch control is in semi tones. Useful for music transposition
– Maximum speed – maximum speed value for pitch control

– App theme – select light/dark app theme
– Resume playing for TYPE5 button on app restart – when this is on then for button TYPE5 files the playing will be resumed from last played position
– Auto resume – auto resumes video playing when app is bring to foreground from background

Script Files

Script files can be assigned to a button in order to create automated sequence.

Script file has to be located in app folder. To be able to select script file in button settings use [INTERNAL FILE] button. Use USB connection to PC and Windows browser to put script file there.

Script files have following format:

[time in seconds]:[button #1, button#2]

Also following commands are possible:

  • speed=0.7 (for changing speed to 0.7. Normal speed is 1)
  • pitch=0.5 (for changing pitch to 0.5. Normal pitch is 1)
  • balance=-50 (for changing pitch to -50 angle left. Normal balance is 0)
  • volume=80 (for changing volume to 80% . Normal volume is 100%)
  • reset speed (for resetting speed to 1)
  • reset pitch (for resetting pitch to normal)
  • reset balance (for resetting balance to normal)
  • reset volume (for resetting volume to normal)

Here is an example script file:

0:1
2:2
4:1
5:1
6:2
8:5
10:speed=0.7
10:pitch=0.5
10:balance=-50
10:volume=80
11:5
12:9,10
25:reset speed
25:reset pitch
25:reset balance
25:reset volume
40:stop

Script file instructions are:

time – action
0 seconds – press button 1
2nd second – press button 2
…
10th second – set speed, pitch, balance and volume
10th second – press button 5
11th second – press button 5
12th second – press button 9 and button 10
15th second – press buttons 4 and 10
etc.

You can download this script file here.

App folder

There is difference in location for app folder on devices before Android 11 and devices with Android 11 and more. The reason is introduced “app sandboxing” in Android 11. This means every app has access only to its folder and the location of the folder is hardcoded.

Before Android 11:
The app folder is <phone storage>/SoundSampler

Android 11:
The app folder is
<phone storage>/Android/data/com.gyokovsolutions.soundsampler/files/SoundSampler

With Android 11 to access the app folder you can use:
– file manager app that has access to all folders. If file manager app does not have such access due to “sandboxing” it won’t be able to access app folder.
– USB connection with cable to PC. Make sure you are using Windows File Explorer and go to Android/data folder. There you will see all apps folders.



-->