Media Push Plugin

Unleash Your Website’s Magic

About Media Push Plugin

It is an open-source project that is implemented as a plugin for Ant Media Server. Its source code is here. You may also consider this project as a boilerplate for your own plugins.


  • Media Push Plugin allows you to open any website of your choice and immediately begin live streaming the entire page, including its audio.
  • You have the option to watch the stream in real-time or conveniently record it using either the MP4 or WebM protocol.
  • Additionally, you can also simulcast any online classes, video conferences, or auctions using Ant Media Server

Getting Started

Before starting:

You need to have an active Ant Media Server(AMS) license. You can subscribe through AWS and deploy AMS with just one click. Or directly subscribe to self-hosted license on our website.


  • Ant Media Server Enterprise Edition v2.6.0+
  • Google Chrome 108


  • Download the pre-built media-push-plugin.jar file
  • Copy the media-push-plugin.jar file to plugins directory under /usr/local/antmedia
sudo cp media-push-plugin.jar /usr/local/antmedia/plugins
  • Restart the server
sudo service antmedia restart


The plugin is controlled using REST API methods. Such as starting and stopping the web page recording. 


  • Type:
    • POST
  • URL:
    • SERVER_URL/APP_NAME/rest/v1/media-push/start
  • Query Parameters:
    • streamId: id of stream you wanted to publish.
  • JSON Parameters:
    • url: url of the website you wanted to publish.
cURL example:
curl -i -X POST -H "Accept: Application/json" -H "Content-Type: application/json" "http://localhost:5080/WebRTCAppEE/rest/v1/media-push/start?streamId=your-streamid" -d '{"url": "", "width": 1280, "height": 720}'


  • Type:
    • POST
  • URL:
    • SERVER_URL/APP_NAME/rest/v1/media-push/stop/{streamId}

cURL example:

curl -i -X POST -H "Accept: Application/json" "http://localhost:5080/WebRTCAppEE/rest/v1/media-push/stop/{streamId}"


Our engineers are available for you. Please  if you need technical support or help. If you need more dedicated support, we offer support packages.


will be provided shortly

Unleash Your Website’s Magic