# Solving issues

### In this lesson you will learn how to <a href="#in-this-lesson-you-will-learn-how-to" id="in-this-lesson-you-will-learn-how-to"></a>

* check what issues your txt file has,
* how to understand them,
* how to fix them automatically if possible.

### Before you start <a href="#before-you-start" id="before-you-start"></a>

This lesson requires a special songfile with errors. You need to download it from here:

{% file src="<https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2FepQnojFSslLOTQgHMg4O%2FDavid%20Amber%20-%20Second%20Time%20Around%20%5Bproblems%5D.zip?alt=media&token=71ba3d59-d34a-4509-ac51-0507e317ec99>" %}

## Solving issues

### Reviewing issues

Let's load the song and take a look at the bottom:

<figure><img src="https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2Fz2liQF2pNYW44wHVAYrL%2Fimage.png?alt=media&#x26;token=9416aceb-e87e-4b92-a966-ed1bccf91071" alt=""><figcaption></figcaption></figure>

We can see that the *Problems* tab is red. It means that there are some issues that need our attention. Let's click on the tab caption to see what they are:

![](https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2FIfynmjYC7ZRhnm2DtGry%2Fimage.png?alt=media\&token=e9c5adb0-3964-4982-b550-85ef699091a1)

### Problem types

There are 2 kind of problems:

* errors - if they remain unsolved they will negatively impact player's experience,
* warnings - solving them will improve player's experience.

If you hover mouse over any of them, you will see some additional info:

![](https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2FttHchCXCJM72xCvD5dfS%2Fimage.png?alt=media\&token=34553453-43ca-4919-b297-0ada2ff9c3fc)

### Reviewing the issues

Let's click on the first error. You should be transported to the place where it occurs:

<figure><img src="https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2F4eT1oAwJuHWWUax8Y9X0%2Fimage.png?alt=media&#x26;token=0925942b-1a36-4866-8844-3b01cac6ed13" alt=""><figcaption></figcaption></figure>

And the second error:

<figure><img src="https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2FNsQMcK22LIteK6LU4oLO%2Fimage.png?alt=media&#x26;token=ac3d4e90-31e0-47ae-ab04-a591d25c8c1a" alt=""><figcaption></figcaption></figure>

We can fix these issues manually, but let's test the automatic solution.

Right click on the second error and choose *Correct* option.

<figure><img src="https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2FPAitBcHcbx0zBgei2xKg%2Fimage.png?alt=media&#x26;token=353d7ce3-ac8a-4ef4-9ca9-290dab8a17a5" alt=""><figcaption></figcaption></figure>

As you can see, the first note was shortened so that the notes no longer overlap.

Do the same with the other error.

<figure><img src="https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2FLeZyXJ23Y2FQyjo26iny%2Fimage.png?alt=media&#x26;token=b59ece8f-59f4-4f47-a55c-e97e8aeaa3be" alt=""><figcaption></figcaption></figure>

Remember to review whether the fix is actually appropriate. Karedi will just shorten the first note, it will not check whether this is the valid approach. Maybe in your case it is the second note that should start later?

### Solving warnings

You can solve some warnings automatically as well. Click on *"Interval between lines is too small"* warning.

<figure><img src="https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2F7Pu08ZvhwcJeofUn2iAX%2Fimage.png?alt=media&#x26;token=6cc4a271-e2a6-4652-98a7-0fa11b15803b" alt=""><figcaption></figcaption></figure>

As we can see the interval between first and second visible line is just 2 beats. The advised interval is 3 beats or longer so that the player has some time to register line change and read new line's lyrics.

Let's correct it automatically.

![](https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2FThD1mN5oTX7Xu2sS698x%2Fimage.png?alt=media\&token=1c8de725-bcfa-4add-94c5-40224382f4cf)

As you can see, the first note was shortened to make the interval 3 beats long.

{% hint style="warning" %}
You must always check synchro after automatic fixes if you use them.
{% endhint %}

In our case altough the warning disappeared, our *"ver"* note is incorrect. It should be 2 beats shorter.

### Automatic solving

Usually you should not need automatic solver. If you make a song from scratch, just be cautious not to create any overlapping or touching notes. If you see any error, fix it manually or at least verify that the result is satisfactory.

When is it useful?

If you want to fix some old song, e.g. imported from Singstar. These songs may have many overlapping or touching notes. You can use automatic solver to quickly resolve the issues and improve the song quality. Of course to turn the txt file into high-quality you would still have to check the timing and pitches of every note.

{% hint style="info" %}
You can correct all errors/warnings at once.&#x20;
{% endhint %}

Just right-click on *Errors* or *Warnings* group header and choose *Correct* option there instead of clicking on a specific problem.

### Problems with no automatic fixes

After solving all problems that could be solved automatically, our file still has some errors that can not be fixed automatically.

![](https://2464591649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWYWuwgmUrVIBcYKbiiso%2Fuploads%2FHldC925qlCKbaHDCj4Im%2Fimage.png?alt=media\&token=bd47624a-d371-4b8c-9a69-a1ad97f3ee4e)

In the next lesson we will learn how to solve them.

## Shortcuts summary:

In this lessons we have not learned any new shortcuts.

## What's next

In the next lesson we will go back to our original song file and learn how to add golden bonus.

## To learn more refer to:

{% content-ref url="../../user-interface/lower-components/problems-manager" %}
[problems-manager](https://karedi.gitbook.io/karedi/user-interface/lower-components/problems-manager)
{% endcontent-ref %}


---

# 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://karedi.gitbook.io/karedi/creating-songs-for-beginners/finishing-touches/solving-issues.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.
