|
| 1 | +--- |
| 2 | +title: "Playlists (TAP)" |
| 3 | +description: "playlist feature / tap files" |
| 4 | +bookCollapseSection: true |
| 5 | +--- |
| 6 | +# Playlist Feature (TAP files) |
| 7 | + |
| 8 | +TeddyCloud supports basic playlist handling. A playlist file (TAP) can be linked to multiple sources, as long as it is supported by ffmpeg. |
| 9 | + |
| 10 | +TAP files can be placed into library folder. The Tonies (from content folder) can then get assigned to any TAP file, just like it would be a normal TAF. |
| 11 | + |
| 12 | +TAP files usually looks like the following: |
| 13 | + |
| 14 | +```json |
| 15 | +{ |
| 16 | + "type": "tap", |
| 17 | + "audio_id": 0, |
| 18 | + "filepath": "lib://by/tapID/radio.taf", |
| 19 | + "name": "Radio", |
| 20 | + "files": [ |
| 21 | + { |
| 22 | + "filepath": "lib://by/audioID/1234567890.taf", |
| 23 | + "name": "Hörspiel Tonie" |
| 24 | + }, |
| 25 | + { |
| 26 | + "filepath": "lib://mp3/album/title.mp3", |
| 27 | + "name": "A Song" |
| 28 | + }, |
| 29 | + { |
| 30 | + "filepath": "http://nas.intranet/musiclibrary/album/song.mp3", |
| 31 | + "name": "Network Audio" |
| 32 | + } |
| 33 | + ] |
| 34 | +} |
| 35 | +``` |
| 36 | + |
| 37 | +## Specification |
| 38 | +| Option | Type | Default | Description | |
| 39 | +|----------------|--------|---------|-------------| |
| 40 | +| type | str | `tap` | Sets the type of playlist | |
| 41 | +| audio_id | uint32 | `0` | Sets the audio id if the file is cached. Set it to 0 to force recreating the cached file | |
| 42 | +| filepath | str | `""` | Sets a path of TAF, which will be produced by ffmpeg | |
| 43 | +| name | str | `""` | Sets the name of the playlist | |
| 44 | +| files | array | `[]` | Define a list of audio files for this playlist | |
| 45 | +| files.filepath | str | `""` | Sets the path to audio resource (must be compatible to ffmpeg) | |
| 46 | +| files.name | str | `""` | Sets the name of the audio resource | |
0 commit comments