# 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;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://davitas.gitbook.io/playerbox-documentation/getting-started/quickstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.