[ie/vimeo] Extract "live_status" and "release_timestamp" for live events

[pzhlkj6612]

IMPORTANT: PRs without the template will be CLOSED

Description of your pull request and other information

Note: this is a quick fix. I didn't do thorough testing.

The config['video']['live_event'] field is:

// is_upcoming

{
  "video": {
    "live_event": {
      "id": "",
      "status": "pending",
      "show_viewer_count": false,
      "settings": {
        "event_schedule": true,
        "hide_live_label": false
      },
      "archive": {
        "status": "",
        "source_url": ""
      },
      "ingest": {
        "scheduled_start_time": "2023-02-29T00:00:00+00:00",
        "width": 0,
        "height": 0,
        "start_time": 0
      },
      "low_latency": false,
      "dvr": false,
      "sessionUrl": null
    }
  }
}

// is_live

{
  "video": {
    "live_event": {
      "id": "00000000-0000-0000-0000-000000000000",
      "status": "started",
      "show_viewer_count": false,
      "settings": {
        "event_schedule": true,
        "hide_live_label": false
      },
      "archive": {
        "status": "started",
        "source_url": ""
      },
      "ingest": {
        "scheduled_start_time": "2023-02-29T00:00:00+00:00",
        "width": 1920,
        "height": 1080,
        "start_time": 1700000000
      },
      "low_latency": false,
      "dvr": false,
      "sessionUrl": "https://live-api.vimeocdn.com/sessions/${video.live_event.id}?~exp=1700000000&~id=player&~sig=..."
    }
  }
}

// was_live

{
  "video": {
    "live_event": null
  }
}

For now, our code can't differentiate between "was_live" and "not_live", or say, between "live archives" and "fixed-length videos".

Those four statuses are from https://f.vimeocdn.com/p/4.28.9/js/player.module.js (wayback machine backup).

{e.pending="pending",e.active="active",e.started="started",e.ended="ended"}

For future developers

We should get info about live videos by analyzing https://vimeo.com/live_event/status?clip_id=${video_id} . This API is still informative after the end of live events.

// is_upcoming

{
  "id": 42,
  "metering": {
    "seconds_remaining": 43200,
    "seconds_max": 43200
  },
  "ingest": {
    "rtmps_url": "rtmps://rtmp-global.cloud.vimeo.com:443/live",
    "height": null,
    "width": null,
    "status": 0,
    "session_id": null,
    "stream_ended_reason": null,
    "start_time": null,
    "scheduled_start_time": "2023-02-29T00:00:00+00:00"
  },
  "archive": {
    "status": 0
  }
}

// is_live

{
  "id": 42,
  "metering": {
    "seconds_remaining": 40000,
    "seconds_max": 43200
  },
  "ingest": {
    "rtmps_url": "rtmps://rtmp-global.cloud.vimeo.com:443/live",
    "height": 1080,
    "width": 1920,
    "status": 4,
    "session_id": "00000000-0000-0000-0000-000000000000",
    "stream_ended_reason": null,
    "start_time": 1700000000,
    "scheduled_start_time": "2023-02-29T00:00:00+00:00"
  },
  "archive": {
    "status": 1
  }
}

// was_live

{
  "id": 42,
  "metering": {
    "seconds_remaining": 43200,
    "seconds_max": 43200
  },
  "ingest": {
    "rtmps_url": "rtmps://rtmp-global.cloud.vimeo.com:443/live",
    "height": 1080,
    "width": 1920,
    "status": 5,
    "session_id": "00000000-0000-0000-0000-000000000000",
    "stream_ended_reason": 6,
    "start_time": 1700000000,
    "scheduled_start_time": "2023-02-29T00:00:00+00:00"
  },
  "archive": {
    "status": 2
  }
}

Template

Before submitting a pull request make sure you have:

• At least skimmed through contributing guidelines including yt-dlp coding conventions
• Searched the bugtracker for similar pull requests
• Checked the code with flake8 and ran relevant tests

In order to be accepted and merged into yt-dlp each piece of code must be in public domain or released under Unlicense. Check all of the following options that apply:

• I am the original author of this code and I am willing to release it under Unlicense
• I am not the original author of this code but it is in public domain or released under Unlicense (provide reliable evidence)

What is the purpose of your pull request?

• Fix or improvement to an extractor (Make sure to add/update tests)
• New extractor (Piracy websites will not be accepted)
• Core bug fix/improvement
• New feature (It is strongly recommended to open an issue first)

[pzhlkj6612]

I tested Vimeo's public events with FFmpeg RTMP.

What I did	live_event::status	Found streams	Audiences saw	The host's management page
Created an event	pending	HTTP 404	a placeholder [1]	"Go live from your encoder to start the event"
Started live by launching FFmpeg	started	live	the live stream	showing the preview
Killed FFmpeg		live but no new segments	"Live stream offline"	the preview turned blank
Waited a moment [2]	live_event is None	VOD	the archived video	"{event_name} has stopped streaming"

With "Preview stream before going live" [3] enabled:

What I did	live_event::status	Found streams	Audiences saw	The host's management page
Created an event	pending	HTTP 404	a placeholder [1]	"Connect encoder to begin stream preview"
Launched FFmpeg	active			showing the preview
Killed FFmpeg
Waited a moment [2]	pending			"Stream preview ended due to inactivity. Restart the stream from your encoder to resume."
Relaunched FFmpeg and clicked "Go live"	started	live	the live stream	showing the preview
Killed FFmpeg		live but no new segments	"Live stream offline"	the preview turned blank
Waited a moment [2]	live_event is None	VOD	the archived video	"{event_name} has stopped streaming"

• [1] "This event hasn't started yet", "This event is scheduled for ..." or "This event will start in ..." hovering over a test card.
• [2] "... this will trigger our 5-minute reconnection window..." Ending your stream § Overview: Create and go live to an event – Vimeo Help Center
• [3] "Note that there is also a Preview toggle..." Stream with an encoder § Overview: Create and go live to an event – Vimeo Help Center

.

So, the live_status of "active" should be "is_upcoming".