> For the complete documentation index, see [llms.txt](https://davitas.gitbook.io/playerbox-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://davitas.gitbook.io/playerbox-documentation/getting-started/quickstart.md).

# Quickstart

{% embed url="<https://youtu.be/ssJkGroGPVs?si=Hnm19ltmONfwYZLx>" %}

### License Activation

<figure><img src="/files/67fXscxcA4hAyIs3DhNz" alt=""><figcaption></figcaption></figure>

Enter the license key from your purchase in the box and hit activate.

### Creating a Database

<figure><img src="/files/ipW9yOUdFefFvlPyiseh" alt="" width="375"><figcaption></figcaption></figure>

Press the ***create new database*** button. Enter a name for your new database and select a file path. Select a folder to scan and grab a :coffee: while the scan finishes. Once finished, the database loads into the search bucket and fills the bucket with all results.\
\
You can then search for particular keywords in the database. Multi-word search is supported: you can search for multiple words with commas (for example: explosion, large, wide). \
\
The search combs through the file name + audio file metadata and produces results if it finds the matching keyword(s) in either section.\ <br>

<figure><img src="/files/JeRl0cSnYDToKEGyw2uI" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/difbSF6QEyPqsCCFAaL0" alt=""><figcaption></figcaption></figure>

### Playback

Press and hold the ***A key*** to arm the new track button. Press a track (with your mouse or the keyboard) with the new track button held down to load a random audio file into the track. Your track will now have the colour of the resulting search bucket.

**ALTERNATELY:**

Right click on a track block and select INIT track. You need to have an active search bucket to add audio files.

<figure><img src="/files/EqszrR5B07IcVekFzVAi" alt="" width="286"><figcaption></figcaption></figure>

Following the same procedure again on the same coloured track, it will add a new audio file to the track.<br>

<figure><img src="/files/dXedqcn65G8Rz2sqCtzV" alt="" width="375"><figcaption></figcaption></figure>

Press the track to hear the audio file. The space bar plays back all active tracks.

### Randomization

<figure><img src="/files/r9gFcAw4E3Xq1pDvqV6m" alt="" width="375"><figcaption></figcaption></figure>

1. Inspiration button: randomizes both sounds and parameter blocks on every active track.
2. Play button: plays all audio files.
3. Randomize parameters: randomizes parameter blocks based on global block settings. The audio file stays the same.
4. Randomize sound: randomizes the audio file on all active tracks.
5. Clear parameters: Resets the parameters on a track. Hold down to arm, then press the track.
6. Clear: totally clear a track and start over. Hold down to arm, then press the track.

### Recording

<figure><img src="/files/0wV9OBtEZAw0DY5ssfGA" alt=""><figcaption></figcaption></figure>

Press the record button to start recording. The default recording channel count is 2 (stereo). Press the button again to stop the recording, and save your audio file to the chosen directory.&#x20;