MiniMeters: Common Issues (Linux)

Setting the Session Type

MiniMeters will automatically select a session type by reading the XDG_SESSION_TYPE environment variable. If you would like to force a specific session type simply run MiniMeters like so:

XDG_SESSION_TYPE=x11 ./MiniMeters.AppImage

...Or for Wayland:

XDG_SESSION_TYPE=wayland ./MiniMeters.AppImage

If for some reason you need to keep the XDG_SESSION_TYPE environment variable set, perhaps due to a window manager limitation, you can also set the MINIMETERS_SESSION_TYPE environment variable.

Wayland Limitations

Wayland does now allow Wayland clients (such as MiniMeters) to set the position of a window. MiniMeters will attempt to use the wlr-layer-shell extension to present MiniMeters as a toolbar, but if this is unavailable MiniMeters will not be able to save and restore MiniMeters' position. In this case, if you do not need fractional scaling support on Linux I would recommend using X11 as your XDG_SESSION_TYPE in MiniMeters.

Audio Server plug-in does not receive audio from the Bitwig flatpak

MiniMeters requires access to the system's /dev/shm to enable communication between "MiniMeters - Audio Server" and the MiniMeters standalone application. Bitwig's flatpak does not allow access to that by default.

To enable it run the following command:

flatpak override --user --device=shm com.bitwig.BitwigStudio

The next time you launch Bitwig, MiniMeters will be able to connect to the Audio Server.

"Monitor Of [Input]" does not receive DAW audio when using Pipewire

To fix this, close MiniMeters. Then, install pauvcontrol using the package manager for your distribution.

Once installed, go to the Configuration tab, and select the "Pro Audio" profile for the device you are trying to monitor.

MiniMeters should now properly be able to monitor your audio device.

Hyprland

"Application MiniMeters with class of app.minimeters.MiniMeters is not responding."

When switching workspaces in Hyprland, an "Application Not Responding" pop-up may appear. This appears to be caused by using VSync with OpenGL.

Option 1:

Select a custom frame rate from the FPS Limit options inside MiniMeters.

Option 2:

Disable the Application Not Responding window in your Hyprland config.

misc {
    enable_anr_dialog = false
}

If you know a better solution to this issue please reach out. I'd be happy to employ a fix.

Tips

MiniMeters' on Hyprland works best when using the Horizontal Layout w/ Stick Mode (found in the Reposition Menu) or the Quad Layout. Using the Horizontal layout without Stick mode will cause MiniMeters to cut off certain modules and generally be a bad experience.

Gnome (Wayland) Limitations

MiniMeters' Stick Mode does not work on Gnome (or other Mutter-based window managers) when using Wayland. As of v1.0.15 MiniMeters supports Stick Mode when using X11. As a workaround, setting the XDG_SESSION_TYPE=x11 environment variable will allow Stick mode to work on Gnome w/ Wayland. If you know a better way to allow this behavior to work correctly please reach out with that info.

Cosmic

MiniMeters' window is very small on the Cosmic desktop

It appears that Cosmic sometimes reports the incorrect display resolution to MiniMeters, causing some strange behavior. Disable Stick Mode by going to the Reposition menu and deselecting "Stick." You can also try running MiniMeters with XDG_SESSION_TYPE=x11 to see if that helps.

Still need help?

Do not hesitate to reach out on Discord or via email: support(at)minimeters.app. I am happy to help!