/Playlist import

Imports a playlist from a specified format (e.g. JSON, TXT). More formats may be added based on user suggestions

Usage

/playlist import file:<JSON or TXT>

Add a name to import to a specific playlist

---

Formats

JSON Format

Structured format suitable for re-import, automation, or third-party applications.

Examples Input:

{
  "name": "default",
  "songs": [
    {
      "title": "Song Title",
      "url": "https://example.com/audio/song1.opus"
    },
    {
      "title": "Song Title",
      "url": "https://example.com/audio/song2.mp3"
    }
  ]
}

Field descriptions:

• name: Name of the playlist.

• createdBy: Discord user ID of the playlist creator.

• songs: Array of song objects.

  • title: Name of the track or file. (optional)

  • url: Direct link to the audio file or stream.

  • thumbnail : link to a picture of the song. (optional)

  • duration : duration of the song either in seconds, in "hh:mm:ss" or "mm:ss" format (optional)

[
    {
      "title": "Song Title",
      "url": "https://example.com/audio/song1.opus"
    },
    {
      "title": "Song Title",
      "url": "https://example.com/audio/song2.mp3"
    }
]

Field descriptions:

• Array of song objects.

  • title: Name of the track or file. (optional)

  • url: Direct link to the audio file or stream.

  • thumbnail : link to a picture of the song. (optional)

  • duration : duration of the song either in seconds, in "hh:mm:ss" or "mm:ss" format (optional)

Use case: Perfect for re-importing playlists, syncing across bots, or integration into custom tools.

---

TXT Format

Simple plain text list, human-readable and easy to share.

Example Input:

https://example.com/audio/song1.opus
https://example.com/audio/song2.mp3

Behavior:

• One track per line.

• Each line is a direct URL, no metadata included.

Use case: Quick sharing, manual curation, or pasting into external players or chat.