How to Automatically Download, Organise, and Sync All Your Canvas Course Files to Google Drive (Without Losing Your Mind)
Navigating Canvas is a deadweight time tax that students hate. When you are juggling intense coursework alongside professional commitments, wasting cognitive bandwidth hunting through nested web subfolders for a reading from three weeks ago is pure friction. You need your academic library offline, cleanly indexed, and instantly searchable.
Below is the blueprint for a localised file engine that completely automates this process. With a single terminal command, it queries Canvas, extracts your materials, converts cluttered presentation slides into clean PDFs, and streams organised folders straight to your secure cloud backup. Note that files locked behind library paywalls or external university login gates cannot be scraped directly, but the system automatically flags these in a custom checklist for quick manual download.
Setting up this pipeline requires no coding experience—just about 20 minutes of initial configuration and the ability to copy and paste text into a terminal window.
What This System Does For You
- Smart Downloading: It checks Canvas for you, skipping files you already have and only downloading brand-new materials your professors just uploaded.
- Non-Destructive Cloud Archiving: It copies new documents to your Google Drive without deleting old files. If you clear out local space on your hard drive, your cloud files remain safe.
- The "To-Do" Checklist: If a professor links to an external website or a locked library archive requiring a separate web login, the script leaves a text file in your coursework folder (
login_links.txt) telling you exactly what you need to fetch manually. - Automatic Formatting: It automatically finds every Word document and PowerPoint slide deck and creates a clean PDF version right next to it, leaving your originals completely untouched.
- Human-Readable Folders: Canvas names folders using random code numbers. This system automatically reads your course names and cleans them up to match your actual subject titles (e.g., Accounting for Management).
Step 1: Set Up Your Computer's Free Toolkit
We need to install three free tools: Python (to talk to Canvas), LibreOffice (to handle the PDF conversions), and Rclone (to securely talk to Google Drive). Find your operating system below and copy-paste the commands into your terminal window.
🌐 For Chromebook (ChromeOS) & Modern Linux Users
Newer updates to Chromebooks use Debian Linux, which safely locks down Python environments to protect the system. We use an isolated app manager called pipx to bypass this barrier natively. Open your Terminal app, select Penguin, and paste this block:
sudo apt update
sudo apt install -y python3 python3-pip libreoffice rclone pipx
pipx install canvas-downloader
pipx ensurepath
source ~/.bashrc🪟 For Windows Users
Windows handles file paths and Linux shell scripts poorly on its own, so we use the built-in Windows Subsystem for Linux (WSL) to run this smoothly.
- Open your Windows Start Menu, type PowerShell, right-click it, and choose Run as Administrator.
- Type this command and hit Enter:
wsl --install - Restart your computer.
- Open the newly installed Ubuntu terminal from your Windows Start menu. Follow the quick prompt to create a simple username and password.
- Inside that new terminal window, paste the setup commands:
sudo apt update
sudo apt install -y python3 python3-pip libreoffice rclone pipx
pipx install canvas-downloader
pipx ensurepath
source ~/.bashrc🍏 For Mac Users
- Open your Terminal app. (If you don't have the Homebrew tool manager installed, get it first from
brew.sh). - Run this block to install the tools, utilising
pipxto keep your environment pristine. Note that modern macOS configurations use Zsh by default, so we reload the shell path accordingly:
brew install rclone python pipx
pipx install canvas-downloader
pipx ensurepath
brew install --cask libreoffice
sudo ln -s /Applications/LibreOffice.app/Contents/MacOS/soffice /usr/local/bin/libreoffice
source ~/.zshrc📱 For iOS Users (iPhone & iPad)
The Mobile Reading Strategy: Due to Apple's security rules, you cannot run background terminal scripts directly on an iPhone or iPad.
Instead, run this automation script on your computer or Chromebook. Because the engine automatically pushes your beautifully organised PDFs straight into your Google Drive, your iOS device becomes the ultimate viewing destination. Simply install the free Google Drive app from the App store, and your entire current course library will be sitting right there, offline-ready and perfectly indexed.
Step 2: Link Your Google Drive Securely
We will use Rclone to talk to your Google account. It uses Google's official, secure validation process. It will never see or save your password.
- In your terminal window, type this command and hit Enter:
rclone config - Type
nand hit Enter to create a new connection. - Type a distinct name for your remote profile (for example:
MBS_Googleorgdrive) and hit Enter. CRITICAL NOTE: Remember exactly what you type here; you will need this exact label in Step 4. - You will see a long list of cloud storage types. Find Google Drive in the list, type
driveand hit Enter. - Leave the
client_idandclient_secretprompts completely blank by hittingEntertwice. - Choose the option corresponding to full drive access (usually option
1). - Hit
Enterat the next two prompts to accept the blank defaults. - When it asks Use auto-config?, type
y. Your web browser will automatically open. Log into your university or personal Google account, click Allow, and close the tab when it says "Success!". - Type
nwhen asked if it is a Shared Drive, confirm everything withy, and finally typeqto quit the setup wizard.
Step 3: Get Your Secret Canvas Key
To download your files, the script needs a temporary digital key from your Canvas account.
- Log into your university Canvas website using a web browser.
- Click on Account (your profile picture) in the top left corner, then click Settings.
- Scroll down to the section that says Approved Integrations and click the button that says + New Access Token.
- Type a purpose (like "File Sync App") and click Generate Token.
- Copy the long string of letters and numbers that appears.
⚠️ Keep this key completely private. It is a temporary password to your student dashboard. Never share it or post it online.
Step 4: Create Your Secret Passcode File
We are going to create a hidden settings file on your computer. This keeps your private keys completely safe and separated from the main software script.
- Open a terminal window and type:
nano ~/.canvas_sync.conf - Paste the text below into the editor. Replace the placeholder values inside the quotation marks with your actual web address, your secret Canvas token, and the path where you want things saved on Google Drive. Make sure to replace
YOUR_REMOTE_NAMEwith the exact label you created in Step 2:
# Secure Canvas Configuration File
TOKEN="PASTE_YOUR_LONG_CANVAS_TOKEN_HERE"
CANVAS_URL="https://youruniversity.instructure.com"
GDRIVE_PATH="YOUR_REMOTE_NAME:your_nested_folder_path/Uni"- Save and close the file by pressing
Ctrl + O, hittingEnter, and then pressingCtrl + X. - Lock down the security of this file so other apps cannot view it:
chmod 600 ~/.canvas_sync.conf
Step 5: Deploy the Main Sync Script
This is the main automated engine. It reads your configuration file, hooks up with Canvas, cleans up messy folder names, runs the PDF conversions, logs errors, and handles the Google Drive upload entirely on its own.
This is the only long step; you do not need to understand every line of code to use it.
- Create your main coursework folder and open it:
mkdir -p ~/Downloads/Coursework && cd ~/Downloads/Coursework - Create the script file:
nano canvas_sync.sh - Paste the complete, automated script below directly inside the file:
#!/bin/bash
# Ensure script executes out of the current directory context
cd "$(dirname "$0")" || exit 1
# Establish a baseline execution timestamp for the summary report
touch .sync_start
# =====================================================================
# SOURCE CONFIGURATIONS
# =====================================================================
CONFIG_FILE="$HOME/.canvas_sync.conf"
if [ -f "$CONFIG_FILE" ]; then
. "$CONFIG_FILE"
else
echo "[!] CRITICAL ERROR: Configuration file not found at $CONFIG_FILE"
echo " Please create it with secure permissions before running this script."
exit 1
fi
# Dynamically locate the downloader binary across different OS configurations
if command -v canvas-downloader &> /dev/null; then
DOWNLOADER_BIN=$(command -v canvas-downloader)
else
DOWNLOADER_BIN="$HOME/.local/bin/canvas-downloader"
fi
CHECKLIST_FILE="login_links.txt"
RAW_LOG=".raw_sync_log.txt"
CONVERSION_ERRORS="conversion_failures.txt"
# Clear historical execution artifacts
rm -f "$RAW_LOG" "$CHECKLIST_FILE" "$CONVERSION_ERRORS"
echo "========================================="
echo " STEP 0: Verifying Canvas API Access"
echo "========================================="
if ! python3 -c "import requests; r=requests.get('$CANVAS_URL/api/v1/users/self', headers={'Authorization': 'Bearer $TOKEN'}); assert r.status_code == 200" 2>/dev/null; then
echo "[!] ERROR: Canvas API token is invalid, expired, or URL is unreachable."
echo " Please verify credentials in $CONFIG_FILE."
exit 1
fi
echo "[+] API token authentication verified."
echo "========================================="
echo " STEP 1-3: Streaming Live Course Data Sync"
echo "========================================="
SYNC_ERROR=0
# PROCESS SUBSTITUTION: Using < <(python3 ...) keeps execution in the parent shell
# so that trackable metrics and variables persist correctly outside the block.
while IFS=":::" read -r course_id course_name; do
[ -z "$course_id" ] && continue
# SANITIZATION: Clean structural layout characters out of filesystem paths
clean_name=$(echo "$course_name" | tr -d '[:cntrl:]' | sed 's/[/\\*?:"<>|]/_/g' | sed 's/[[:space:]]*$//')
echo "-> Processing: $clean_name ($course_id)"
# 1. Automated Course Incremental Download Sync
"$DOWNLOADER_BIN" --canvas-url "$CANVAS_URL" --api-token "$TOKEN" --output-dir "." --include-assignments --course-id "$course_id" 2>&1 | tee -a "$RAW_LOG"
# 2. Dynamic Desktop Link Mapping
if [ -d "$course_id" ]; then
ln -sfn "$course_id" "$clean_name"
fi
# 3. Secure Accumulative Cloud Sync (Non-destructive copy configuration)
if [ -d "$course_id" ]; then
rclone copy "$course_id" "$GDRIVE_PATH/$clean_name" --exclude ".*" --quiet
if [ $? -ne 0 ]; then
echo " [!] Cloud sync warning encountered on: $clean_name"
SYNC_ERROR=1
fi
fi
sleep 2
done < <(python3 -c "
import requests
try:
r = requests.get('$CANVAS_URL/api/v1/courses?per_page=100', headers={'Authorization': 'Bearer $TOKEN'}).json()
for c in r:
if isinstance(c, dict) and 'id' in c and 'name' in c:
print(f\"{c['id']}:::{c['name']}\")
except Exception:
pass
")
echo "========================================="
echo " STEP 4: Running Smart PDF Conversion"
echo "========================================="
find . -type f \( -name "*.docx" -o -name "*.pptx" -o -name "*.doc" -o -name "*.ppt" \) -print0 | while IFS= read -r -d '' file; do
pdf_file="${file%.*}.pdf"
if [ -f "$pdf_file" ]; then
continue
else
echo "Converting new document: $file"
# 30s timeout protection cap, isolated profile contexts, and blocked stdin hijacking
timeout 30s libreoffice "-env:UserInstallation=file:///tmp/lo_convert_$$" --headless --convert-to pdf --outdir "$(dirname "$file")" "$file" < /dev/null
if [ $? -eq 124 ]; then
echo " [!] WARNING: Conversion timed out on $file (likely corrupt). Skipping."
echo "$file" >> "$CONVERSION_ERRORS"
rm -f "$(dirname "$file")/.~lock.$(basename "$file")#" 2>/dev/null
fi
fi
done
rm -rf /tmp/lo_convert_* 2>/dev/null
echo "========================================="
echo " STEP 5 AUDIT: Building Login Checklist"
echo "========================================="
if [ -f "$RAW_LOG" ]; then
grep -E "Failed|403|401|Forbidden|Unauthorized" "$RAW_LOG" > "$CHECKLIST_FILE"
fi
if [ -s "$CHECKLIST_FILE" ]; then
echo "[!] Attention needed: External or locked links flagged."
echo " Check '$(pwd)/$CHECKLIST_FILE' for items requiring manual browser actions."
else
rm -f "$CHECKLIST_FILE" 2>/dev/null
fi
echo "========================================="
echo " SUMMARY REPORT"
echo "========================================="
NEW_FILES=0
if [ -f "$RAW_LOG" ]; then
NEW_FILES=$(grep -cE "Downloaded:|██████████" "$RAW_LOG" 2>/dev/null || echo "0")
fi
MANUAL_LINKS=0
if [ -f "$CHECKLIST_FILE" ]; then
MANUAL_LINKS=$(wc -l < "$CHECKLIST_FILE" 2>/dev/null || echo "0")
fi
PDF_COUNT=$(find . -name "*.pdf" -newer .sync_start 2>/dev/null | wc -l || echo "0")
FAILED_CONVERSIONS=0
if [ -f "$CONVERSION_ERRORS" ]; then
FAILED_CONVERSIONS=$(wc -l < "$CONVERSION_ERRORS" 2>/dev/null || echo "0")
fi
echo " New files downloaded from Canvas : $NEW_FILES"
echo " Office documents built to PDF : $PDF_COUNT"
echo " Failed document PDF conversions : $FAILED_CONVERSIONS"
echo " Flagged items requiring login : $MANUAL_LINKS"
echo "-----------------------------------------"
if [ "$SYNC_ERROR" -eq 0 ]; then
echo "[+] SUCCESS: Cloud infrastructure mirrors are completely current."
else
echo "[!] WARNING: Cloud sync finished with localized folder exceptions."
fi
# Clear state files
rm -f .sync_start "$RAW_LOG"
echo "========================================="
echo " WORKFLOW COMPLETE"
echo "========================================="- Save and close the editor (
Ctrl+O,Enter,Ctrl+X). - Give your computer official permission to run the script file:
chmod +x canvas_sync.sh
Step 6: Run the Engine
Whenever you want to completely update your course dashboard, download new readings, build PDFs, and back them up, simply run this command in your terminal window:
./canvas_sync.shWhat You Will See Next Week:
The script will turn on, verify your keys, look at Canvas, and instantly bypass the files you already have. It will pull down the brand-new files, quietly turn them into cloud-friendly PDFs, and sync them seamlessly to your organised Google Drive folder without you having to click a single button.
Troubleshooting & Core Constraints
While this pipeline is engineered defensively, users should keep a few operating constraints in mind:
- University Security Restrictions: Canvas setups vary heavily by institution. A small number of universities restrict API access tokens or enforce strict single-sign-on (SSO) profile locks. If the tool connects successfully but returns zero files, verify your token permissions with your student dashboard helpdesk.
- Course Limits: This pipeline processes up to 100 courses per run due to core Canvas API page limitations.
- Complex Office Documents: Highly complex formulas, legacy layouts, or heavy password protections in old
.docor.pptfiles can occasionally cause the background PDF processor to skip a file. If an asset isn't generating a PDF mirror, check theconversion_failures.txtlog in your folder. - Cloud Authentication Reconnects: Google security tokens typically stay persistent. However, if your university updates its network authentication rules, you can quickly re-link your drive by entering
rclone config reconnect YOUR_REMOTE_NAMEin the terminal.
