canvas-grab

Looking for Maintainers

As I no longer have access to Canvas systems, this project cannot be actively maintained by me. If you are interested in maintaining this project, please email me.

Grab all files on Canvas LMS to local directory.

Less is More. In canvas_grab v2, we focus on stability and ease of use. Now you don't have to tweak dozens of configurations. We have a very simple setup wizard to help you get started!

For legacy version, refer to legacy branch.

Getting Started

1. Install Python
2. Download canvas_grab source code. There are typically three ways of doing this.
   • Go to Release Page and download {version}.zip.
   • Or git clone https://github.com/skyzh/canvas_grab.
   • Use SJTU GitLab, see Release Page, or visit https://git.sjtu.edu.cn/iskyzh/canvas_grab
3. Run ./canvas_grab.sh (Linux, macOS) or .\canvas_grab.ps1 (Windows) in Terminal. Please refer to Build and Run from Source for more information.
4. Get your API key at Canvas profile and you're ready to go!
5. Please don't modify any file inside download folder (e.g take notes, add supplementary items). They will be overwritten upon each run.

You may interrupt the downloading process at any time. The program will automatically resume from where it stopped.

To upgrade, just replace canvas_grab with a more recent version.

If you have any questions, feel free to file an issue here.

Build and Run from Source

First of all, please install Python 3.8+, and download source code.

We have prepared a simple script to automatically install dependencies and run canvas_grab.

For macOS or Linux users, open a Terminal and run:

./canvas_grab.sh

For Windows users:

1. Right-click Windows icon on taskbar, and select "Run Powershell (Administrator)".
2. Run Set-ExecutionPolicy Unrestricted in Powershell.
3. If some courses in Canvas LMS have very long module names that exceed Windows limits (which will causes "No such file" error when downloading), run the following command to enable long path support.

   Set-ItemProperty -Path 'HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem' -Name LongPathsEnabled -Type DWord -Value 1 
   

4. Open canvas_grab source file in file browser, Shift + Right-click on blank area, and select Run Powershell here.
5. Now you can start canvas_grab with a simple command:

   .\canvas_grab.ps1

Configure

The setup wizard will automatically create a configuration for you. You can change config.toml to fit your needs. If you need to re-configure, run ./configure.sh or ./configure.ps1.

Common Issues

• Acquire API token Access Token can be obtained at "Account - Settings - New Access Token".
• SJTU users 请在此页面内通过“创建新访问许可证”按钮生成访问令牌。
• An error occurred You'll see "An error occurred when processing this course" if there's no file in a course.
• File not available This file might have been included in an unpublished unit. canvas_grab cannot bypass restrictions.
• No module named 'canvasapi' You haven't installed the dependencies. Follow steps in "build and run from source" or download prebuilt binaries.
• Error when checking update It's normal if you don't have a stable connection to GitHub. You may regularly check updates by visiting this repo.
• Reserved escape sequence used please use "/" as the path seperator instead of "\".
• Duplicated files detected There're two files of same name in same folder. You should download it from Canvas yourself.

Screenshot

Contributors

See Contributors list. @skyzh, @danyang685 are two core maintainers.

License

MIT

Which means that we do not shoulder any responsibilities for, included but not limited to:

1. API key leaking
2. Users upload copyright material from website to the Internet