Metadata-Version: 2.1
Name: canvasdl
Version: 1.4.4.post5
Summary: course content synchronizer
Home-page: https://github.com/quintenroets/canvasdl
Download-URL: https://github.com/quintenroets/canvasdl/archive/refs/tags/v1.4.4-5.tar.gz
Author: Quinten Roets
Author-email: quinten.roets@gmail.com
Description-Content-Type: text/markdown
License-File: LICENSE

# Canvasdl

Tired of managing your course content on 5-10 different platforms? 
Canvasdl comes to the rescue and saves you hours of work when studying and completing assignments.
This convenient package:
- Synchronizes all your course content to local files
- Synchronizes your assignment dates to google calendar
- Shows you what items are new
- Remembers your progress through course materials
- Keeps you up to date without overwhelming you with useless notifications
- Synchronizes content available on:
   - Canvas:
     - Announcements
     - Assignments
     - Course files
     - Video recordings
   - Course websites
   - Ed Discussion
   - Google Drive
   - Piazza
   - Gradescope
- Developed for students at Columbia University 
- Useful for any school with (partly) the same platforms
- Developed for Linux OS. 
- Contact developer for other platforms support.

## Installation

Make sure you are using python3.9+

1) Install the package
    ```shell
    pip install canvasdl
    ```
2) Obtain Canvas API key
    - Columbia University students
      - Go to Courseworks > Account > Settings
      - Click on "New Access Token"

3) [Optional] Obtain Google Calendar [API key](https://developers.google.com/calendar/api/quickstart/python#authorize_credentials_for_a_desktop_application)
4) [Optional] Specify custom [Calendar ID](https://xfanatical.com/blog/how-to-find-your-google-calendar-id/)
5) Configure your settings:
   ```shell
   canvasdl --configure
   ```
6) Install package for local file management
   - python-xattr
   - [mediainfo](https://manpages.ubuntu.com/manpages/bionic/man1/mediainfo.1.html)
7) [Optional] Install package for UI progress during synchronization
   - python-pyqt6
   - pip install PyQt6

## Usage
Run command to synchronize all content and check for updates
```shell
canvasdl
```
