List and explain available commands / requests

diff --git a/share/http/requests/readme b/share/http/requests/readme
new file mode 100644 (file)
index 0000000..f5033a3
--- /dev/null
+++ b/share/http/requests/readme
@@ -0,0 +1,87 @@
+$Id$
+
+This file describes commands available through the requests/ file:
+
+Lines starting with < describe what the page sends back
+Lines starting with > describe what you can send to the page
+
+All parameters need to be URL encoded.
+Examples:
+ + -> %2B
+ # -> %23
+ space -> +
+ ...
+
+status.xml:
+===========
+< Get VLC status information, current item info and meta.
+
+> add <mrl> to playlist and start playback:
+  ?command=in_play&input=<mrl>
+
+> add <mrl> to playlist:
+  ?command=in_enqueue&input=<mrl>
+
+> play playlist item <id>:
+  ?command=pl_play&id=<id>
+
+> toggle pause. If current state was 'stop', play item <id>:
+  ?command=pl_pause&id=<id>
+
+> stop playback:
+  ?command=pl_stop
+
+> jump to next item:
+  ?command=pl_next
+
+> jump to previous item:
+  ?command=pl_previous
+
+> delete item <id> from playlist:
+  ?command=pl_delete&id=<id>
+
+> empty playlist:
+  ?command=pl_empty
+
+> sort playlist node <id> using sort mode <val>:
+  ?command=pl_sort&id=<id>&val=<val>
+
+> toggle random playback:
+  ?command=pl_random
+
+> toggle loop:
+  ?command=pl_loop
+
+> toggle repeat:
+  ?command=pl_repeat
+
+> toggle enable service discovery module <val>:
+  ?command=pl_sd&val=<val>
+
+> toggle fullscreen:
+  ?command=fullscreen
+
+> set volume level to <val> (can be absolute integer, percent or +/- relative value):
+  ?command=volume&val=<val>
+
+> seek to <val>:
+  ?command=seek&val=<val>
+
+playlist.xml:
+=============
+< get the full playlist tree
+
+browse.xml:
+===========
+< ?dir=<dir>
+> get <dir>'s filelist
+
+vlm.xml:
+========
+< get the full list of VLM elements
+
+vlm_cmd.xml:
+============
+< execute VLM command <cmd>
+  ?command=<cmd>
+> get the error message from <cmd>