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

# Arpeggi Studio Tutorial

## Create your first on-chain song.

Follow along with this video to create your first on-chain song from scratch with Arpeggi Studio.

{% embed url="<https://www.youtube.com/watch?v=R7Ub7AAmUtE&t=1s&ab_channel=ashwest>" %}

## Arpeggi Studio Main Window

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

Arpeggi Studio's main window organizes everything you need to create and remix on-chain music into an easy-to-use interface.&#x20;

For producers with *digital audio workstation* experience, Arpeggi Studio is intuitive enough to jump  right in.&#x20;

For beginners, it's easy to get started.

### Track Settings

<figure><img src="/files/3RzgeTZ9KbV3ULidIVE9" alt=""><figcaption></figcaption></figure>

Settings that affect your entire track live in the **top bar** of the main window. Give your track a name, set a tempo, and adjust overall track volume from the top bar.&#x20;

{% hint style="info" %}
Setting your track's tempo is the first step to achieving a desired style or feel. For example, 90bpm for hip-hop, 128bpm for house, and 140bpm for trap.
{% endhint %}

When your track is ready to mint, the **Mint** button is located on the right side of the top bar.

### Controls

<figure><img src="/files/48FCzXkd1tTOZsaSDrmc" alt=""><figcaption></figcaption></figure>

There are three buttons in the center of the top bar that you will use extensively while producing music.&#x20;

**Play/Pause**\
Click the center button to start playing your track. Click again to pause.&#x20;

**Stop**\
Click the stop button to the left of play/pause to stop playback. Click again to start playback at the beginning of your track.

**Loop**\
Click the loop button on the right to play a section of your track over and over again.

### Mixer

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

Each instrument that you add to your track will appear in a column on the left side of the main window. This section is the **mixer**.

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

With the mixer, you can:

* Click and drag an instrument name to re-order.
* Adjust the volume slider to make an instrument louder or quieter.
* Click the S icon to solo an instrument and listen to it on its own. Click again to disable.
* Click the speaker icon to mute an instrument. Click again to disable.
* Drag a sample or stem from the sound library to add a new instrument to your track.

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

Check out this video for a detailed walkthrough of adding instruments.

{% embed url="<https://drive.google.com/file/d/1eCJL-ismFl8oX8R01epkzdYveKIi0DPJ/view?usp=sharing>" %}

### Timeline

<figure><img src="/files/1Nu1A2S9DNKeZzSMkHW3" alt=""><figcaption></figcaption></figure>

The majority of the main window is dedicated to the timeline. Each column in the timeline is a 4-bar section and you can scroll horizontally.

With the timeline, you can:

* Visualize how your track evolves over time.
* Decide which instruments play which parts at what time.
* Create new MIDI variations.
* Add and manipulate audio files.

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

Simply click an empty region to add a new MIDI variation. Click an existing section or click the + card to create a new variation.

{% hint style="info" %}
Most pop songs are organized into repeating sections (ie. Intro -> Verse -> Chorus -> Verse -> Chorus -> Outro). In Arpeggi Studio, you can create A, B, C, etc. parts for each instrument and use the timeline to put them in order.
{% endhint %}

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

The timeline helps you visualize how your track evolves over time. In the example above, only the Drums and Bell instruments are playing during the intro. A few more instruments start playing during the buildup, and the drop section brings in the full instrument list.

### The Drum Sequencer

<figure><img src="/files/2XDTAl1zWwJu869aBj07" alt=""><figcaption></figcaption></figure>

Click on a section on your *Drums* instrument to bring up the drum sequencer.

Each time you add a new drum sound to your track (ie. snare, kick, cymbal), it will be added to your *drum rack.* Use the drum sequencer to program a drum beat to play automatically.

In the drum sequencer, you will see 4 groups of boxes. Each group represents one bar.&#x20;

Larger boxes indicate longer notes (ie. 4 boxes in a group = quarter notes).&#x20;

Simply click on a box to tell the drum sequencer to play that drum sound at that time.

Check out this video for a detailed demonstration of the drum sequencer.

{% embed url="<https://drive.google.com/file/d/14MItYb675OtACX9DhxI8XfP-LlvfukhW/view?usp=sharing>" %}

### The Piano Roll

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

Click a clip on an instrument track to bring up a piano roll.&#x20;

In the piano roll, you will see four bars divided into beats. You can adjust the subdivisions using the dropdown on the right.&#x20;

Each row in the piano roll corresponds with a note on the left. Click on a box to tell the piano roll when to play which note at what time.

Check out this video for a detailed walkthrough of the piano roll.&#x20;

{% embed url="<https://drive.google.com/file/d/1aWBEW-dCsTMUpaSLL7tFyuEZLVuP0U0l/view?usp=sharing>" %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://arpeggi.gitbook.io/faq/arpeggi-studio-tutorial.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.