← Back to Blog

Fix Stremio Flatpak Black Screen on Linux Mint 22.3

August 15, 2026

If Stremio Flatpak opens as a completely black window on Linux Mint 22.3, update and repair the Flatpak installation first. If that does not help, an affected user reported success with Stremio 4.4.168 from the official .deb, modified for libmpv2, while keeping its required legacy OpenSSL library isolated from the rest of the system.

The package modification is an advanced community workaround, not an official Stremio fix. Do not replace system OpenSSL libraries or link libcrypto.so.1.1 to libcrypto.so.3.

Affected configuration and likely cause

The reported problem occurred with this configuration:

  • Linux Mint 22.3 Cinnamon
  • X11 session
  • NVIDIA GeForce RTX 3050
  • NVIDIA driver 595.84
  • x86_64 architecture
  • Stremio Flatpak 1.2.0 and 1.1.4
  • Stremio desktop client 4.4.168

Stremio launched without an obvious crash, but its entire window remained black. The available evidence points to a compatibility problem somewhere in the Flatpak, WebKit, graphics-driver, or rendering stack. It does not establish one universal cause for every Linux black-screen problem.

Because the window fails during startup, this is unlikely to be caused by a catalog or streaming addon. Community addons are independently operated and do not control the Linux application's window rendering.

1. Update and repair Flatpak first

Close Stremio, open Terminal, and update installed Flatpak applications and runtimes:

flatpak update

Repair the per-user Flatpak installation:

flatpak repair --user

Confirm that Stremio is installed under the expected application ID:

flatpak list | grep -i stremio

Then launch it from Terminal:

flatpak run com.stremio.Stremio

If the interface appears, no package modification is necessary.

You can also check whether the NVIDIA driver is responding:

nvidia-smi

A driver error here should be resolved through Linux Mint's Driver Manager before attempting to patch Stremio. Avoid changing a working NVIDIA driver solely because one Stremio window is black.

2. Do not rely on the unsuccessful launch flags

In the reported Linux Mint configuration, these WebKit environment changes did not fix the black screen:

flatpak run --env=WEBKIT_DISABLE_DMABUF_RENDERER=1 com.stremio.Stremio

flatpak run --env=WEBKIT_DISABLE_COMPOSITING_MODE=1 com.stremio.Stremio

The Chromium-style --disable-gpu argument was also reported as unsupported by this Stremio executable. Downgrading the Flatpak from 1.2.0 to 1.1.4 did not help that user either.

These results are specific to the reported machine. Testing one WebKit environment variable is relatively low risk, but do not make it permanent if it has no effect.

What worked for affected users

One user reported that the following workaround restored both startup and playback:

  1. Download Stremio 4.4.168 as a .deb.
  2. Change its dependency from libmpv1 to Linux Mint 22.3's libmpv2.
  3. Change the executable's expected library name from libmpv.so.1 to libmpv.so.2.
  4. Rebuild and install the package.
  5. Extract, but do not system-install, the required libcrypto.so.1.1 library.
  6. Start Stremio through a wrapper that exposes the legacy library only to Stremio.

This was confirmed only for the reported system. Binary library-name substitution can fail if the newer library is not ABI-compatible with the functions the application uses.

3. Modify the Stremio .deb

Download the 64-bit Debian/Ubuntu package from the official Stremio downloads page. These commands assume the downloaded file is named stremio_4.4.168-1_amd64.deb and is in ~/Downloads.

Remove the Flatpak only if you want to avoid duplicate menu entries:

flatpak uninstall com.stremio.Stremio

Extract the .deb into a working directory:

rm -rf ~/stremio-test
mkdir -p ~/stremio-test
dpkg-deb -R ~/Downloads/stremio_4.4.168-1_amd64.deb ~/stremio-test

Confirm the original dependency and unresolved MPV library:

grep -n "libmpv" ~/stremio-test/DEBIAN/control
ldd ~/stremio-test/opt/stremio/stremio | grep -i mpv

The affected package declared libmpv1 and looked for libmpv.so.1. Change both references:

sed -i 's/libmpv1/libmpv2/g' ~/stremio-test/DEBIAN/control
sed -i 's/libmpv\.so\.1/libmpv.so.2/g' ~/stremio-test/opt/stremio/stremio

Verify the changes before rebuilding:

grep -n "libmpv" ~/stremio-test/DEBIAN/control
strings ~/stremio-test/opt/stremio/stremio | grep -E "libmpv\.so"

Build and install the modified package:

dpkg-deb -b ~/stremio-test ~/Downloads/stremio_4.4.168-mint22_amd64.deb
sudo apt install ~/Downloads/stremio_4.4.168-mint22_amd64.deb

If apt reports additional unresolved dependencies, stop rather than forcing the installation.

4. Isolate libcrypto.so.1.1

Running stremio may now report that libcrypto.so.1.1 cannot be found. Linux Mint 22.3 uses a newer OpenSSL ABI, so never create this unsafe link:

libcrypto.so.1.1 -> libcrypto.so.3

Instead, obtain an x86_64 libssl1.1 Debian package from a trusted distribution archive and verify its origin. Do not install that legacy package system-wide.

Assuming the package is in ~/Downloads, extract it into your home directory:

mkdir -p ~/stremio-libs
dpkg-deb -x ~/Downloads/libssl1.1_*_amd64.deb ~/stremio-libs

Verify the required file exists:

ls -l ~/stremio-libs/usr/lib/x86_64-linux-gnu/libcrypto.so.1.1

Test Stremio with the isolated library path:

LD_LIBRARY_PATH="$HOME/stremio-libs/usr/lib/x86_64-linux-gnu" stremio

If Stremio still fails, check for missing libraries in the same environment:

LD_LIBRARY_PATH="$HOME/stremio-libs/usr/lib/x86_64-linux-gnu" \
ldd /opt/stremio/stremio | grep "not found"

Do not continue if several unrelated libraries are missing.

5. Create a permanent launcher

If the test succeeds, create a wrapper:

sudo tee /usr/local/bin/stremio-fixed > /dev/null <<'EOF'
#!/bin/sh
export LD_LIBRARY_PATH="$HOME/stremio-libs/usr/lib/x86_64-linux-gnu"
exec /usr/bin/stremio "$@"
EOF
sudo chmod +x /usr/local/bin/stremio-fixed

Test it:

stremio-fixed

Create a user-specific application-menu override instead of editing the system desktop file directly:

mkdir -p ~/.local/share/applications
cp /usr/share/applications/smartcode-stremio.desktop \
  ~/.local/share/applications/
sed -i 's/^Exec=stremio %U$/Exec=stremio-fixed %U/' \
  ~/.local/share/applications/smartcode-stremio.desktop

Log out and back in if the Cinnamon menu does not immediately notice the change.

Important limitations

Keep both of these while using the workaround:

  • ~/stremio-libs
  • /usr/local/bin/stremio-fixed

A Stremio update may replace the modified executable, while a future package may make the workaround unnecessary. Before updating, check whether the current official package installs and opens normally on Linux Mint 22.3.

If you are uncomfortable modifying a package or using a legacy library, the safer fallback is to remove the modified installation and wait for a compatible official build rather than altering system libraries.

Last reviewed: August 15, 2026