Usage Guide
This page assumes you've already installed the server. If you haven't, go to the Installation page first.
Starting the server
Every time you want to use the tool, you need to start the server first. Just run start.py from the root of the repo:
Linux / macOS:
python3 start.py
Windows:
python start.py
If you see an error saying the virtual environment wasn't found, you haven't run setup yet. Go to the Installation page and complete setup first.
A Chrome window will open to the Edpuzzle login page. Sign in with your teacher account — the window will close itself after a few seconds once it's ready.
Then go to http://localhost:8080.
Getting answers for an assignment
- Go to edpuzzle.com and open the assignment you want answers for
- Make sure the URL looks like:
https://edpuzzle.com/assignments/{id}/watch - Copy the URL
- Paste it into the tool at http://localhost:8080
- Click the button to fetch answers
The multiple choice answers will be displayed on screen.
Features
Auto-answer
Automatically fills in all the multiple choice answers for you. Click the auto-answer button after fetching the answers.
Open-ended question answering (AI)
Uses Google Gemini to generate answers for free-response questions. This requires a valid Gemini API key in your config — see the Configuration Reference for setup.
Video skipper
Lets you jump to any point in the video, including the end. Useful for skipping required watch time.
Video speed
Change the playback speed of the video.
Prevent auto-pause
Stops the video from pausing when you switch tabs.
Using the bookmarklet
Instead of copying and pasting the URL every time, you can set up the bookmarklet:
- Make sure your server is running at http://localhost:8080
- Drag the bookmarklet button into your bookmarks bar (or right-click → bookmark link on Firefox)
- Now when you're on any Edpuzzle assignment page, just click the bookmark to launch the tool
The bookmarklet only works while your server is running. If the tool doesn't open, make sure you started the server with start.py first.
Canvas and Schoology
The tool also works for Edpuzzles embedded in Canvas and Schoology.
Canvas:
- Navigate to the assignment on Canvas
- Click the bookmarklet — it will open the Edpuzzle in a new tab
- Click the bookmarklet again on the new tab to run the tool
Schoology: Works the same way as Canvas.
Stopping the server
When you're done, go back to your terminal and press Ctrl+C to stop the server.