VAST is a Python script that searches an Instructure Canvas course for media and returns results in a CSV file.
- Python 2.7
- YouTube API Key
- Vimeo API Key
- System permission to install python libraries
- Install all dependencies by using
pip install -r requirements.txt
- Copy
vast_config.template.py
tovast_config.py
- Set the configuration variables in
vast_config.py
:- api_key - Canvas API Key. To scan a course you're not enrolled in, you'll needs a sub-account or admin level key
- api_url - Canvas URL and API e.g.
https://example.instructure.com/api/v1/
- youtube_key
- vimeo_api_key
- courses_url - e.g.
https://example.instructure.com/courses
VAST will identify the following types of media:
- YouTube videos (iframe and links)
- Vimeo videos (iframe and links)
- Video files linked from the Rich Content Editor
- Audio files linked from the Rich Content Editor
- SWF files linked from the Rich Content Editor
- Media comments in the Rich Content Editor
- Embedded Canvas Video and Audio in the Rich Content Editor
- Links from video providers:
- Films on Demand
- Alexander Street Press
- Kanopy
- Custom links can be added/removed to the
lib_media_urls
list in thevast_config.py
Note: VAST relies on the mime type of the file provided by Canvas
- VAST does not check the Quizzes tool
- VAST can not determine if captions exist on video files, audio files, flash files, or video providers. The report will list the location of the file to check manually and provide a download link. Make sure to be logged into Canvas first; unless the download link will not work.
- VAST may not be able to check all YouTube or Vimeo videos for captions. If it can't, the report will note so.
A testing course is available in Canvas Commons. Use the search term Vast Test Course
.
- Open up a terminal window
- Go to the directory containing
vast.py
(use cd command) - Type
python vast.py
- Enter the Canvas course id number e.g.(1234567 from
https://example.instructure.com/courses/1234567
) - The report will be saved in the same directory as the
vast.py
script
- John Raible
- Matt Emond