Control audio or video playback with your keyboard

This article applies to a feature that's available on Firefox 81 and over.

What is the media control feature?

You control media (audio or video) playback inside Firefox without clicking on the video or audio itself. You can now control it by pressing the hardware control buttons on a keyboard or headset, pressing the button on the virtual control interface or by ending commands via specific protocol, such as MPRIS.

This depends on website developers using the MediaSession API.

What platform supports this feature?

You can use this feature on MacOS (OSX 10.12.1 or above), Windows (Windows 8.1 or above), Linux (gtk-based distributions).

How are media control supported?

What kinds of media can be controlled by this feature?

Currently we only support controlling media playing from audio and video, so it cannot control media from web-audio, web-speech and Flash plugin.

  • If an audible media is playing from audio and video, then it’s able to be controlled.
  • If a playable media enters fullscreen
  • If a playable media enters picture-in-picture mode

What kinds of media can NOT be controlled by this feature?

Mediafrom web-audio, web-speech and Flash plugin cannot be controlled. There are some exceptions:

  • Inaudible media (silent videos that don't have an audio track, such as GIF-like images)
  • Notification sounds

If I have multiple tabs playing media, which tab would be controlled?

If there are multiple tabs playing at the same time, you could control the last tab playing media, unless you are playing in Picture-in-Picture mode. In this case, then picture-in-picture video belongs to would always be the tab that is being controlled.

Why sometimes when I press media control keys, it controls other apps but not Firefox? Or, other apps are also being controlled at the same time?

Each platform has its own mechanism for which applications control audio. In some cases, multiple applications might try to control the media keys at the same time. If this happens, try to close any other apps that are trying to control your media control keys.

Was this article helpful?

Please wait...

These fine people helped write this article:

Illustration of hands


Grow and share your expertise with others. Answer questions and improve our knowledge base.

Learn More