diff --git a/media-video/qliveplayer/files/README.gentoo b/media-video/qliveplayer/files/README.gentoo
new file mode 100644
index 0000000000..bede90a6fb
--- /dev/null
+++ b/media-video/qliveplayer/files/README.gentoo
@@ -0,0 +1,5 @@
+qliveplayer is a GUI program to watch live streams and videos.
+qlphelper is the core CLI program called by qliveplayer.
+qlphelper or qlprecorder can be used to record live streams and videos.
+mpv console or a qliveplayer config file can be used to change settings.
+See https://github.com/IsoaSFlus/QLivePlayer/wiki for more information.
diff --git a/media-video/qliveplayer/qliveplayer-3.21.0-r1.ebuild b/media-video/qliveplayer/qliveplayer-3.21.0-r1.ebuild
index d5f8601baa..27026270c5 100644
--- a/media-video/qliveplayer/qliveplayer-3.21.0-r1.ebuild
+++ b/media-video/qliveplayer/qliveplayer-3.21.0-r1.ebuild
@@ -5,7 +5,7 @@ EAPI=7
 
 PYTHON_COMPAT=( python3_{7..9} )
 
-inherit xdg cmake optfeature python-single-r1
+inherit xdg cmake optfeature python-single-r1 readme.gentoo-r1
 
 MY_P="QLivePlayer-${PV}"
 
@@ -56,9 +56,16 @@ src_prepare()
 		|| die "Sed failed to set python version!"
 }
 
+src_install()
+{
+	cmake_src_install
+	readme.gentoo_create_doc
+}
+
 pkg_postinst()
 {
 	xdg_pkg_postinst
+	readme.gentoo_print_elog
 	optfeature "twitch support" "net-misc/streamlink"
 	optfeature "youtube support" "dev-python/protobuf-python net-misc/streamlink"
 }
diff --git a/media-video/qliveplayer/qliveplayer-3.21.1-r1.ebuild b/media-video/qliveplayer/qliveplayer-3.21.1-r1.ebuild
index e83c785215..d581231de1 100644
--- a/media-video/qliveplayer/qliveplayer-3.21.1-r1.ebuild
+++ b/media-video/qliveplayer/qliveplayer-3.21.1-r1.ebuild
@@ -5,7 +5,7 @@ EAPI=7
 
 PYTHON_COMPAT=( python3_{7..9} )
 
-inherit xdg cmake optfeature python-single-r1
+inherit xdg cmake optfeature python-single-r1 readme.gentoo-r1
 
 MY_P="QLivePlayer-${PV}"
 
@@ -56,9 +56,16 @@ src_prepare()
 		|| die "Sed failed to set python version!"
 }
 
+src_install()
+{
+	cmake_src_install
+	readme.gentoo_create_doc
+}
+
 pkg_postinst()
 {
 	xdg_pkg_postinst
+	readme.gentoo_print_elog
 	optfeature "twitch support" "net-misc/streamlink"
 	optfeature "youtube support" "dev-python/protobuf-python net-misc/streamlink"
 }