diff --git a/listdef.json b/listdef.json
new file mode 100644
index 0000000..dee4124
--- /dev/null
+++ b/listdef.json
@@ -0,0 +1,12 @@
+{
+    "title": "", //name of this playlist
+    "items": [
+        {
+            "id": "",
+            "title": "",
+            "description": "",
+            "link": "",
+            "thumb": "" //an image file
+        }
+    ]
+}
diff --git a/packagedef.json b/packagedef.json
new file mode 100644
index 0000000..e61beb1
--- /dev/null
+++ b/packagedef.json
@@ -0,0 +1,16 @@
+{
+    "id": "",
+    "title": "",
+    "thumb": "", //an image file
+    "token": "",
+    "subtitles": "", //a .vtt file
+    "sources": [ //any number of sources, tested up to 4
+        {
+            "video": { //all sources should have the same set of resolutions
+                "720":  "" //map a resolution to a video file
+            },
+            "poster": "", //an image file
+            "playAudio": true //only one source should play audio
+        }
+    ]
+}