VocationalLMSHelp center

Help center · School Admins

A-134For School Admins and Directors

Workstation video rendering: your own PC draws a course's lesson videos and sends the finished video here

A switch and a status block in a master course's Narration panel. Your workstation draws the lesson videos with the same code the server uses, much faster than the server, and sends the finished video; the server checks it and protects it. Approved lessons are never touched.

Open this in VocationalLMSAI Course Builder > a course > Narration for this course > Workstation video rendering

Who can do this: Only the VocationalLMS Super Admin can see or change the switch. The PC worker signs in with a private token saved on the server and on your PC (a different token from the narration one); it can reach only these video addresses, and only VocationalLMS master courses unless you list a school on the server. Students, School Admins, Directors, Instructors and auditors are refused.

What it is for

The server draws a lesson video on two processors: it makes a picture of every slide in a browser and encodes one video with the narration. For the hundreds of hours of lessons being added that is about 138 hours of server time. Your workstation does the very same steps, with the same program code, in about 40 to 70 hours, and the server stays free for students. Workstation video rendering lets that PC pull the lessons whose narration is finished and whose video is missing, draw each one exactly as the server would, and send the finished video back. The server does not trust the file: it checks that it is the right shape (picture size, frame rate, sound format, a key frame every 6 seconds, the right length for the narration), that it belongs to the very text, narration and pictures the PC pulled, and then it adds the captions and the protected (encrypted) stream itself, one lesson at a time. It costs nothing: no voice account and no picture service is used.

Steps

Get the course ready

  1. Make sure the course's lessons have all their narration (record them on the server, or use Workstation narration, A-133). A lesson with a slide that has no narration is not offered to the PC.
  2. Open the master course page and click Narration for this course.
  3. Under Workstation video rendering check that Token on the server says set, then tick Allow the workstation to send videos. It is off until you tick it.

Run the worker on the PC

  1. On the workstation, in a copy of the VocationalLMS folder, run py tools/video_pc_worker.py --server https://vocationallms.com --course-id 9. Add --max-lessons 3 for a first try. The PC needs Python, Playwright with Chromium, ffmpeg, and the internet (the slides use the same web fonts as the server).
  2. It pulls a batch, draws every slide, builds one video per lesson, checks its length, and sends it. Leave it running; if the site is being updated or the internet drops it keeps the finished video and sends it later.
  3. To stop it at any time create a file named STOP in its work folder (or press Ctrl+C). It stops between steps and carries on from where it was the next time.

Check what arrived

  1. The block shows how many lessons still need a video, how many are held by the worker right now, whether a video is being packaged, and the last videos received.
  2. A received video becomes video ready as soon as the server has packaged its protected stream. Run the worker in the evening or at night: the packaging step is a heavy job and the server does one at a time.

What happens next

The lesson is video ready exactly as if the server had drawn it: same captions, same protected playback, same duration. If a lesson was edited after the PC pulled it, the server refuses the file and the PC pulls the lesson again.

Common problems

#ProblemWhat to do
1The worker says the switch is off (403).Tick Allow the workstation to send videos in the course's Narration panel.
2The worker says the slide fonts did not load.The PC must reach the internet so Chromium can load the same two fonts the server uses (Lexend and Source Sans 3). Without them the slides would look different from the server's.
3A lesson never appears in the worker's list.A slide has no narration yet, the lesson is approved or in review, a job is running on it, another worker holds it, or it already has a finished video.
4The server answered that the lesson changed.Someone edited a slide, its narration or a picture after the PC pulled it. The worker throws that video away and pulls the lesson again; nothing wrong was stored.
5The worker stopped on a lesson and the block says it is held.A hold ends by itself after two hours. To free it now click Free every hold in the block.

See also