diff --git a/docs/custom_filters.md b/docs/custom_filters.md
index fa0b7000..4a1736b8 100644
--- a/docs/custom_filters.md
+++ b/docs/custom_filters.md
@@ -26,19 +26,69 @@ Pay attention to the filter prefix `[v_in];`, this is necessary to get the outpu
 custom_filter: edgedetect=mode=colormix:high=0[c_v_out]
 ```
 
-Check ffmpeg [filters](https://ffmpeg.org/ffmpeg-filters.html) documentation, and find out which other filters ffmpeg has.
-
 ### Where the filters applied in stream mode
 
 The **custom filter** from **config -> processing** and from **playlist** got applied in the _decoder_ instance on every file:
 
 ```
-        +-------------------------------------+    PIPE    +------------------------+
-File -> | Decoder / Filtering / custom filter |------------| Encoder / text overlay | -> Output
-Loop    +-------------------------------------+            +------------------------+
+ +-------------------------------------------------- +
+ |                    file loop                      |
+ |          +-------------------------------------+  |  PIPE    +------------------------+
+ | input -> | decoder / filtering / custom filter |-------------| encoder / text overlay | -> output
+ |          +-------------------------------------+  |          +------------------------+
+ |            start new on file change               |               constant output
+ +---------------------------------------------------+
 ```
 
-#### When which one to take
+#### When take which
 
 * If you want to use for every clip a different filter chain, you should use the custom filter parameter from **playlist**.
 * When you want to use the same filter for every clip you can use the custom filter from **config -> processing**.
+
+### Complex example
+
+This example takes a image and a animated mov clip with alpha and overlays them two times on different positions in time:
+
+```YAML
+custom_filter: [v_in];movie=image_input.png:s=v,loop=loop=250.0:size=1:start=0,split=2[lower_1_out_1][lower_1_out_2];[lower_1_out_1]fifo,fade=in:duration=0.5:alpha=1,fade=out:start_time=9.5:duration=0.5:alpha=1,setpts=PTS+5.0/TB[fade_1];[v_in][fade_1]overlay=enable=between(t\,5.0\,15.0)[base_1];[lower_1_out_2]fifo,fade=in:duration=0.5:alpha=1,fade=out:start_time=9.5:duration=0.5:alpha=1,setpts=PTS+30.0/TB[fade_2];[base_1][fade_2]overlay=enable=between(t\,30.0\,40.0)[base_2];movie=animated_input.mov:s=v,split=2[lower_2_out_1][lower_2_out_2];[lower_2_out_1]fifo,setpts=PTS+20.0/TB[layer_1];[base_2][layer_1]overlay=repeatlast=0[base_3];[lower_2_out_2]fifo,setpts=PTS+50.0/TB[layer_2];[base_3][layer_2]overlay=repeatlast=0[c_v_out]
+```
+
+And here are the explanation for each filter:
+
+```PYTHON
+
+# get input from video
+[v_in];
+
+# load the image, loops it for 10 seconds (25 FPS * 10), and splits it into two outputs
+movie=image_input.png:s=v,loop=loop=250.0:size=1:start=0,split=2[lower_1_out_1][lower_1_out_2];
+
+# take output one from image, fades it in for 0.5 seconds, fades it out for 0.5 seconds, shift the start time to 00:00:05 (5 seconds)
+[lower_1_out_1]fifo,fade=in:duration=0.5:alpha=1,fade=out:start_time=9.5:duration=0.5:alpha=1,setpts=PTS+5.0/TB[fade_1];
+
+# overlay first output on top of the video, between second 5 and 15
+[v_in][fade_1]overlay=enable=between(t\,5.0\,15.0)[base_1];
+
+# take output two from image, fades it in for 0.5 seconds, fades it out for 0.5 seconds, shift the start time to 00:00:30 (30 seconds)
+[lower_1_out_2]fifo,fade=in:duration=0.5:alpha=1,fade=out:start_time=9.5:duration=0.5:alpha=1,setpts=PTS+30.0/TB[fade_2];
+
+# overlay second output on top of output from last overlay, between second 30 and 40
+[base_1][fade_2]overlay=enable=between(t\,30.0\,40.0)[base_2];
+
+# load the animated clip with alpha, splits it into two outputs
+movie=animated_input.mov:s=v,split=2[lower_2_out_1][lower_2_out_2];
+
+# shift the start from first animated clip to second 20
+[lower_2_out_1]fifo,setpts=PTS+20.0/TB[layer_1];
+
+# overlay the shifted animation on top of the last image overlay
+[base_2][layer_1]overlay=repeatlast=0[base_3];
+
+# shift the start from second animated clip to second 50
+[lower_2_out_2]fifo,setpts=PTS+50.0/TB[layer_2];
+
+# overlay the second shifted animation on top of the last overlay
+[base_3][layer_2]overlay=repeatlast=0[c_v_out]
+```
+
+Check ffmpeg [filters](https://ffmpeg.org/ffmpeg-filters.html) documentation, and find out which other filters ffmpeg has and how to apply.