Add saved playlists specification

Author: SamantazFox

README.md

@@ -28,6 +28,12 @@ An array of Strings.
 Each string refers to the name of a playlist file (without the `playlist_` prefix)
 that was included in the export.
 
+#### `"saved_playlists_present"`
+
+A Boolean.
+
+Indicates whether the `saved_playlists.json` file was included in the export.
+
 #### `"watch_history_present"`
 
 A Boolean.
@@ -39,6 +45,7 @@ Indicates whether the special playlist `watch_history` was included in the expor
 ```javascript
 {
 	"version": "X.Y.Z[-draft/-rc]",
+	"saved_playlists_present": Boolean,
 	"watch_history_present": Boolean,
 	"subscriptions": SubscriptionObject[],
 	"playlists": String[],
@@ -83,6 +90,23 @@ An array of [video objects](spec/video_object).
 ```
 
 
+## Saved playlist file (`saved_playlists.json`)
+
+This file contains the playlists from other services that the user bookmarked.
+
+#### > `"playlists"`
+
+An array of [saved playlist objects](spec/saved playlist_object).
+
+### Overview
+
+```javascript
+{
+	"playlists": SavedPlaylist[],
+}
+```
+
+
 ## Watch history file (`watch_history.json`)
 
 The watch history is nothing more than a private paylist, without metadata

examples/main.json

@@ -1,5 +1,5 @@
 {
-	"version": "0.0.3-draft",
+	"version": "0.0.4-draft",
 	"subscriptions": [
 		{
 			"type": "youtube",
@@ -9,6 +9,7 @@
 			"thumbnail": "https://yt3.ggpht.com/ytc/[snip]"
 		}
 	],
+	"saved_playlists_present": true,
 	"watch_history_present": true,
 	"playlists": [
 		"abc123"

examples/saved_playlists.json

@@ -0,0 +1,12 @@
+{
+  "playlists": [
+    {
+      "type": "youtube",
+      "id": "PLYT4vq6pQVSvgqA8Qsm8TXjYJMTT2XyNV",
+      "title": "World Of Walker (Full Album)",
+      "author": "Alan Walker",
+      "url": "https://www.youtube.com/playlist?list=PLYT4vq6pQVSvgqA8Qsm8TXjYJMTT2XyNV",
+      "thumbnail": "https://yt3.ggpht.com/ytc/[snip]"
+    }
+  ]
+}

spec/saved_playlist_object.md

@@ -0,0 +1,49 @@
+# SavedPlaylist object
+
+#### > `"type"`
+
+The type of the service this entry refers to.
+
+This field is a short and meaningful identifier that prevents the parser from
+trying to guess the name of the service from the `url` present in this object.
+
+#### > `"id"`
+
+The ID of the playlist.
+
+The format if this ID is service-dependant.
+
+The only requirement being the uniqueness of the ID in the service.
+E.g: All youtube playlist IDs (starting with `PL`) are unique to eachother.
+
+#### > `"title"`
+
+The playlist's title.
+
+#### > `"author"`
+
+The name of the channel/user who created the playlist.
+
+#### > `"url"`
+
+The URL used to access the video.
+
+This URL SHOULD NOT contain query parameters, unless required by the service
+(e.g youtube playlists).
+
+#### > `"thumbnail"`
+
+The URL to the plylist's thumbnail.
+
+### Overview
+
+```javascript
+{
+	"type": String,
+	"id": String,
+	"title": String,
+	"author": String,
+	"url": String,
+	"thumbnail": String
+}
+```