v1.8.2: support UMJI canvas

Thank you for using canvas_grab! In this version, we only did some minor improvements. You may choose not to upgrade.

• We have fixed a bug related to UMJI canvas. Now you can use canvas_grab with UMJI canvas system.

If you have any question, have any advice, or want new features, feel free to create an issue at https://github.com/skyzh/canvas_grab/issues

v1.8.1: link download support and ignore previous courses

Thank you for using canvas_grab! In this version, we only did some minor improvements. You may choose not to upgrade.

1.8.1

• Support link download by enabling ENABLE_LINK option.
• You may now ignore courses from previous semesters with RETAIN_COURSE_DAYS option.

Happy new semester!

If you have any question, have any advice, or want new features, feel free to create an issue at https://github.com/skyzh/canvas_grab/issues

v1.7.8: minor improvements

Thank you for using canvas_grab! In this version, we only did some minor improvements. You may choose not to upgrade.

1.7.8

• Some files on Canvas have unknown size and cannot be downloaded. Now they will be skipped instead of crashing the program.
• Better support for image files. Now when downloading these files, their size will be shown in progress bar.
• New whitelist mode. Only download selected courses.
• [dev] .checkpoint file is more readable.
• [dev] Internal structure has been refactored.

Good luck in final exam!

If you have any question, have any advice, or want new features, feel free to create an issue at https://github.com/skyzh/canvas_grab/issues

Release v1.7.7

This is a hotfix to ignore file with unknown size. If you encountered this issue, please download this hotfix version v1.7.7. Otherwise, use stable version below.

v1.7.6: fastest module resolving and minor improvements

Thank you for using canvas_grab! In this version, we only did some minor improvements. You may choose not to upgrade.

1.7.6

• Even faster module resolving by using file cache. This is only supported in courses with module and file functionality both enabled.
• Download failure can be handled gracefully. Now the program won't exit if a file fails to download.
• Better support for courses with nickname. You can use NICKNAME in course folder config.
• You can now disable version check in config.

1.7.5

• canvas_grab now concurrently resolves module files. Download by module mode will be much faster.
• If you've enabled remove stale files (and folders), we'll now only scan files in each course folder.
• Now you'll be warned if you've downloaded incomplete file. It seems that canvas server will randomly cut down connection without any reason.

NOTE Several users have reported incomplete downloaded files. This is a network issue, and should be automatically resolved within hours. From 1.7.5, we will warn you on incomplete file, instead of downloading it without awareness. Remove existing incomplete file and we'll automatically re-download it.

If you have any question, have any advice, or want new features, feel free to create an issue at https://github.com/skyzh/canvas_grab/issues

v1.7.5: faster module resolving and bug fixes

Thank you for using canvas_grab! In this version, we fix some bugs. I recommend upgrading to latest version to have a more stable experience.

NOTE Several users have reported incomplete downloaded files. This is a network issue, and should be automatically resolved within hours. This new version will warn you on incomplete file, instead of downloading it without awareness. Remove existing incomplete file and we'll automatically re-download it.

1.7.5

• canvas_grab now concurrently resolves module files. Download by module mode will be much faster.
• If you've enabled remove stale files (and folders), we'll now only scan files in each course folder.
• Now you'll be warned if you've downloaded incomplete file. It seems that canvas server will randomly cut down connection without any reason.

1.7.4

• Now we will remove empty folders when removing stale files
• Sometimes download bar will appear in wrong position. We've fixed it.

It has been 45 days since I pushed first line of canvas_grab on GitHub. Surprisingly, this small script grows into a easy-to-use utility tool for every one, with the help of our collaborators and maintainers, and you, the users who take the initiative to test this software.

Time flies. It won't be long before we could meet again on campus. Hope everything goes well!

If you have any question, have any advice, or want new features, feel free to create an issue at https://github.com/skyzh/canvas_grab/issues

v1.7.4: minor improvement

Thank you for using canvas_grab! In this version, we make some minor improvement. You may choose not to upgrade if you don't encounter the issues below.

• Now we will remove empty folders when removing stale files
• Sometimes download bar will appear in wrong position. We've fixed it.

If you have any question, have any advice, or want new features, feel free to create an issue at https://github.com/skyzh/canvas_grab/issues

v1.7.3: remove stale files and fix bugs

Thank you for using canvas_grab! In this version, we added new functionality to remove stale files in download folder. And we fixed a bug introduced in v1.5.0, where files updated on Canvas were considered duplicated files.

We recommend you to upgrade if you encountered the bug.

v1.7.3

• We can remove file in your download folder but not on Canvas for you. Enable this functionality by tweaking SCAN_STALE_FILE config.
• Files updated on Canvas will be downloaded correctly. Specifically, you'll encounter this bug when the teacher deleted the original file and re-uploaded one. Previously we introduced a bug that considers them as duplicated files.

v1.6.0

• Add "module_with_file" organize mode (module mode with unmoduled files). In this mode, canvas_grab will organize files in their corresponding module folder, and then download files not in module to "unmoduled" folder.
• Reduced release package size.
• Stability improvement for macOS prebuilt binary.

v1.5.0

• You can now specify module folder name by template. For example, {IDX} {NAME}.
• You may enable CONSOLIDATE_MODULE_SPACE option to remove redundant consecutive space in module name. e.g. Module 1 will become Module 1.
• You may set download mode on a per-course basis, with COURSE_FOLDER.ORGANIZE_BY config.
• Please refer to config.example.toml for how to enable these features.
• For new users, we provide a better set up process. Now canvas_grab will let you re-enter your API_KEY if you provided a wrong one.

If you have any question, have any advice, or want new features, feel free to create an issue at https://github.com/skyzh/canvas_grab/issues

v1.6.0: new download mode "module_with_file"

Thank you for using canvas_grab! In this version, we improved stability, reduced package size, and add a new download mode "module_with_file".
If you won't use these new features, you may choose not to upgrade.

v1.6.0

• Add "module_with_file" organize mode (module mode with unmoduled files). In this mode, canvas_grab will organize files in their corresponding module folder, and then download files not in module to "unmoduled" folder.
• Reduced release package size.
• Stability improvement for macOS prebuilt binary.

v1.5.0

• You can now specify module folder name by template. For example, {IDX} {NAME}.
• You may enable CONSOLIDATE_MODULE_SPACE option to remove redundant consecutive space in module name. e.g. Module 1 will become Module 1.
• You may set download mode on a per-course basis, with COURSE_FOLDER.ORGANIZE_BY config.
• Please refer to config.example.toml for how to enable these features.
• For new users, we provide a better set up process. Now canvas_grab will let you re-enter your API_KEY if you provided a wrong one.

If you have any question, have any advice, or want new features, feel free to create an issue at https://github.com/skyzh/canvas_grab/issues

v1.5.0: better support for downloading by module

Thank you for using canvas_grab! In this version, we improved support for downloading by module.
If you won't use these new features, you may choose not to upgrade.

v1.5.0

• You can now specify module folder name by template. For example, {IDX} {NAME}.
• You may enable CONSOLIDATE_MODULE_SPACE option to remove redundant consecutive space in module name. e.g. Module 1 will become Module 1.
• You may set download mode on a per-course basis, with COURSE_FOLDER.ORGANIZE_BY config.
• Please refer to config.example.toml for how to enable these features.
• For new users, we provide a better set up process. Now canvas_grab will let you re-enter your API_KEY if you provided a wrong one.

v1.4.0

• Add NEVER_OVERWRITE_FILE and NEVER_DOWNLOAD_AGAIN options in config to provide fine-grain control of what to download.
• Files that exist locally but lose sync with Canvas will be listed.
• Improved download and checkpoint. Now we'll create a temporary file for them in case of power failure and force majeure during download.
• Fix typo of IGNORED_CANVAS_ID in config. If you've changed this option before, be sure to update your config.
• [dev] Now we'll tell that "you're using development version" instead of always reporting there's more recent release.

If you have any question, or want new features, feel free to create an issue at https://github.com/skyzh/canvas_grab/issues