Save idle-time-limit in asciicast v2 header

asciinema/asciicast/v2.py

@@ -100,7 +100,7 @@ class Recorder:
             'width': cols,
             'height': lines,
             'timestamp': int(time.time()),
-            # TODO save max_wait here
+            'idle_time_limit': idle_time_limit,
         }
 
         if captured_env:

doc/asciicast-v2.md

@@ -54,6 +54,13 @@ Unix timestamp of the beginning of the recording session. Integer.
 
 Duration of the whole recording in seconds (when it's known upfront). Float.
 
+#### `idle_time_limit`
+
+Idle time limit, as given via `-i` option to `asciinema rec`. Float.
+
+This should be used by an asciicast player to reduce all terminal inactivity
+(delays between frames) to maximum of `idle_time_limit` value.
+
 #### `command`
 
 Command that was recorded, as given via `-c` option to `asciinema rec`. String.