# ongaku

{% hint style="warning" %}
Make sure the bot has enough permissions and the bot is in ther server you are using the command.
{% endhint %}

{% hint style="danger" %}
If you still encounter error please report is via $$/report$$ command
{% endhint %}

{% tabs %}
{% tab title="Music Channel" %}
{% hint style="danger" %}
/setup music channel
{% endhint %}

***

#### What bot does?

1. <mark style="color:green;">Ongaku creates a different channel and send the inital embed message in the channel created.</mark>
2. <mark style="color:green;">It saves the message id sent by ongaku in the channel.</mark>

#### <mark style="color:blue;">Required Permissions</mark>

1. <mark style="color:green;">Manage Channel (For creating channel)</mark>
2. <mark style="color:green;">Embed Links (For sending embed)</mark>
3. <mark style="color:green;">Use External Emojis</mark>
   {% endtab %}

{% tab title="User Playlist" %}
{% hint style="danger" %}
/playlist
{% endhint %}

### Subcommands under playlist command

{% hint style="info" %}
Here name is for your playlist name either search it or bot will show you playlists.
{% endhint %}

***

#### create

* <mark style="color:orange;">name</mark> <mark style="color:green;">(Name for your playlist)</mark>

<mark style="color:blue;">To create your playlist .</mark>

#### view&#x20;

* <mark style="color:orange;">name</mark> <mark style="color:green;">(No need to type name it will showup with available playlist for you)</mark>

<mark style="color:blue;">To view your playlist .</mark>

#### play&#x20;

* <mark style="color:orange;">name</mark> <mark style="color:green;">(No need to type name it will showup with available playlist for you)</mark>
* <mark style="color:orange;">shuffle</mark> <mark style="color:green;">(Whether to shuffle your queue)</mark>
* <mark style="color:orange;">single</mark> <mark style="color:green;">(If you want to play a single song from playlist)</mark>

<mark style="color:blue;">To play you playlist.  Shuffle have true and false and for single provide music number from your playlist to play.</mark>

#### add-playlist

* <mark style="color:orange;">name</mark> <mark style="color:green;">(No need to type name it will showup with available playlist for you)</mark>
* <mark style="color:orange;">link</mark> <mark style="color:green;">(Link of the playlist to add)</mark>

<mark style="color:blue;">To add playlist inside your playlist. For example add spotify playlist link for link option which will add all songs inside provided playlist into yours.</mark>

#### delete

* <mark style="color:orange;">name</mark> <mark style="color:green;">(No need to type name it will showup with available playlist for you)</mark>

<mark style="color:blue;">To delete playlist for provided name.</mark>

#### export

* <mark style="color:orange;">name</mark> <mark style="color:green;">(No need to type name it will showup with available playlist for you)</mark>

<mark style="color:blue;">To export selected playlist. The bot will provide you with .txt file dont modify it.</mark>

#### import

* <mark style="color:orange;">name</mark> <mark style="color:green;">(No need to type name it will showup with available playlist for you)</mark>
* <mark style="color:orange;">file</mark> <mark style="color:green;">(The file ongaku provided .txt)</mark>

<mark style="color:blue;">To import playlist. Please make sure you have at least one playlist to import it in.</mark>
{% endtab %}

{% tab title="Guild Playist" %}

{% hint style="danger" %}
/guildplaylist
{% endhint %}

### Subcommands under guildplaylist command

{% hint style="info" %}
Note: Please setup request channel for it to work.
{% endhint %}

***

The music request is sent via guild member which will be posted on the channel set as request channel. Then the mods users set on playlist can either accept or reject the requested song.

#### request-channel (Private)

* <mark style="color:orange;">channel</mark> <mark style="color:green;">(Channel where you want the music request to be sent)</mark>

<mark style="color:blue;">To set your guild playlist song request channel. You need to have the servers ManageGuild perms to use this command.</mark>

#### mod (Private)

* <mark style="color:orange;">user</mark> <mark style="color:green;">(User to set guild playlist's mod)</mark>

<mark style="color:blue;">To add mod users for guild playlist. You need to have Administrator perms to use this command. After adding to mod users mod dont need perms for accept and decline.</mark>

view (Public)

<mark style="color:blue;">View Guild's Playlist . Only contains approved songs</mark>

view-request (Mod)

<mark style="color:blue;">View all songs requested.</mark>

#### image (Mod)

* <mark style="color:orange;">url</mark> <mark style="color:green;">(Url of the img to set bg of guild's playlist. Suggested to use from Imgur)</mark>

<mark style="color:blue;">To change the image of your guild's playlist image.</mark>

#### approve (Mod)

* <mark style="color:orange;">id</mark> <mark style="color:green;">(Id of the song to approve)</mark>

<mark style="color:blue;">To approve user music request. Here</mark> $$id$$ <mark style="color:blue;">is the id value sent in request channel.</mark>

#### decline (Mod)

* <mark style="color:orange;">id</mark> <mark style="color:green;">(Id of the song to decline)</mark>

<mark style="color:blue;">To decline the song request from user.</mark>

#### remove (Mod)

* <mark style="color:orange;">id/url</mark> <mark style="color:green;">(remove song from playlist via id or url)</mark>

<mark style="color:blue;">To remove songs from playlist.</mark>
{% endtab %}
{% endtabs %}

{% content-ref url="/pages/YeGxR7NBarSWdgSymCrx" %}
[music](/ongaku/setup/music.md)
{% endcontent-ref %}

{% content-ref url="/pages/F3Qjp9dO3OQYXur46Dii" %}
[Character AI](/ongaku/setup/character-ai.md)
{% endcontent-ref %}

{% content-ref url="/pages/SQsuNY9il0Fv5RVeU9q7" %}
[Others](/ongaku/setup/others.md)
{% 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://kakashidracq.gitbook.io/ongaku/ongaku.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.