Skip to main content

Add a video and ask questions

VideoQ transcribes videos, finds scenes related to your questions, and answers based on them. Try the full workflow with one video: upload → course → question → play the cited scene.

Prerequisite: Complete Run the development environment and log in to the local app.

1. Add a short video​

Open the video library and upload a short video with spoken explanations. A video whose content you already know makes the first check easier.

To import from YouTube, save your own SearchAPI key in settings before registering the URL. File uploads do not need SearchAPI.

2. Wait for processing​

A video may not be ready for questions immediately after upload. The following steps run in the background.

Search preparation is complete when the video status is completed and its transcript appears on the video detail screen. If the status stops progressing, see video processing troubleshooting.

3. Add the video to a course​

Create a course and add the video. A course defines the set of videos you want to ask questions about; adding a video does not move its stored file.

For example, add a setup tutorial video to a course called “Team development environment.” See the core data model for the relationship between videos and courses.

4. Ask about the content​

Ask a question in the course chat about something covered in the video.

What are the setup steps explained in this video?

Select a citation in the answer and check that it jumps to the corresponding time in the video. Verify that the answer matches the content and that the cited scene supports the explanation.

Questions such as “How many videos are in this course?” can be answered from metadata alone, so they may not include scene citations.

5. Try study mode​

Q&A answers your own questions. Study mode guides learning with questions and hints organized around concepts.

Study mode requires PLOG, a graph of connected concepts. PLOG is generated in a separate job after search data is created, so a video with status completed may not yet be ready for study mode.

If study mode is unavailable, check the PLOG status on the video detail screen. It also cannot start when there are no concepts or the graph cannot produce a learning order. See PLOG and study mode for the conditions.

What you should be able to verify​

  • Your video appears in the library and you can read its transcript.
  • You can add the video to a course.
  • You can ask about the content and jump to a cited scene.

Read next: Find your way around the code to trace the operations you just tried.