diff --git a/README.md b/README.md
index 590c470e..28acdbf3 100644
--- a/README.md
+++ b/README.md
@@ -100,8 +100,7 @@ To install go to *Settings > Extensions*. Copy and paste
`ghcr.io/containers/podman-desktop-extension-bootc` into the *Name of the image* field
and click *Install extension from the OCI image*.
-
-
+[![](/docs/img/install_extension.gif)](https://github.com/containers/podman-desktop-media/raw/bootc-extension/videos/install_extension.mp4)
## Usage
@@ -116,25 +115,25 @@ FROM quay.io/centos-bootc/fedora-bootc:eln
RUN echo "root:root" | chpasswd
```
-
+[![](/docs/img/build_container.gif)](https://github.com/containers/podman-desktop-media/raw/bootc-extension/videos/build_container.mp4)
2. **Push the image:**
> IMPORTANT NOTE: This must be a **PUBLICALLY** accessible registry, this will be fixed in the future to use a local container storage
-
+[![](/docs/img/push_container.gif)](https://github.com/containers/podman-desktop-media/raw/bootc-extension/videos/push_container.mp4)
3. **Build the image:**
> Build the disk image, this takes approximatley 2-5 minutes depending on the performance of your machine.
-
+[![](/docs/img/press_build.gif)](https://github.com/containers/podman-desktop-media/raw/bootc-extension/videos/press_build.mp4)
4. **View the logs:**
> You can now view the conversion process within the Containers section
-
+![](/docs/img/watch_logs.gif)
5. **Launching the VM:**
@@ -144,7 +143,7 @@ See our [Virtual Machine Guide](/docs/vm_guide.md) on how to launch the image!
> IMPORTANT NOTE: This does not represent a 1-1 conversion between container image to virtual machine image and is only meant for troubleshooting or developmental purposes.
-
+[![](/docs/img/within_container.gif)](https://github.com/containers/podman-desktop-media/raw/bootc-extension/videos/within_container.mp4)
You can also test your image within a container BEFORE converting by initiating the `init` boot sequence.
diff --git a/docs/img/build_container.gif b/docs/img/build_container.gif
new file mode 100644
index 00000000..02197429
Binary files /dev/null and b/docs/img/build_container.gif differ
diff --git a/docs/img/install_extension.gif b/docs/img/install_extension.gif
new file mode 100644
index 00000000..af1f23a0
Binary files /dev/null and b/docs/img/install_extension.gif differ
diff --git a/docs/img/launch_vm.gif b/docs/img/launch_vm.gif
new file mode 100644
index 00000000..99c7adcb
Binary files /dev/null and b/docs/img/launch_vm.gif differ
diff --git a/docs/img/press_build.gif b/docs/img/press_build.gif
new file mode 100644
index 00000000..8da971f6
Binary files /dev/null and b/docs/img/press_build.gif differ
diff --git a/docs/img/push_container.gif b/docs/img/push_container.gif
new file mode 100644
index 00000000..198affb3
Binary files /dev/null and b/docs/img/push_container.gif differ
diff --git a/docs/img/watch_logs.gif b/docs/img/watch_logs.gif
new file mode 100644
index 00000000..d4a8eacd
Binary files /dev/null and b/docs/img/watch_logs.gif differ
diff --git a/docs/img/within_container.gif b/docs/img/within_container.gif
new file mode 100644
index 00000000..691d7802
Binary files /dev/null and b/docs/img/within_container.gif differ