diff --git a/deadbeef/README b/deadbeef/README
new file mode 100644
index 0000000..c8e8318
--- /dev/null
+++ b/deadbeef/README
@@ -0,0 +1,10 @@
+To enable the opus decoder plugin, you need to have opusfile installed;
+opus by itself is not enough. An opusfile port is available in this
+repository.
+
+The GTK3 UI fails to load the playback control buttons when
+adwaita-icon-theme is version 42 or higher. Either downgrade to
+adwaita-icon-theme#41, or make do with the command-line options --play,
+--stop, --pause, --next, --prev, until a fix for legacy gtk3 code is
+released. See https://gitlab.gnome.org/GNOME/gtk/-/issues/4790 for more
+details.