blackboardsync 0.9.0a1

Sync your blackboard content to your device

BlackboardSync

Automatic Syncing Of Your Blackboard Content

BlackboardSync performs a periodic, incremental download of all your Blackboard content, such as lecture slides, lab sheets, and other attachments.

About

Being a student in this day and age means constantly having to keep up to date with the files that are uploaded to the student portal. I needed a tool that would take care of retrieving these files for me, allowing me to focus on the work to be done. Something I could set up and forget about.

What I was looking for in such an application was:

• Automatic syncing with minimal intervention after the initial setup
• Graphical interface
• Cross-platform compatibility
• It would make use of the Blackboard REST API

Why is my university not supported?

Simply put, some information is necessary to make the login process compatible with any given university. If you would like to help to add support for your university, or would like to see which universities are currently supported, start here.

Built with:

• Python 3.10
• PyQt5

Features

• Supported content:
  • Attachments of any type (e.g. .docx, .pptx, .pdf, etc.)
  • Internet links
  • Content descriptions (saved as html files)
• Cross-platform
  • Linux, Windows, and macOS ready

Installation

Binaries

You can find all releases on GitHub. Only MacOS (.dmg) and Windows (.exe) are supported at the moment.

Note: These releases are automatically built on GitHub Actions from source.

⚠️ ATTENTION MACOS USERS 

On MacOS, you will face an issue when trying to open the application, since it has not been notarised by Apple. A workaround can be found here.

From PyPI

python3 -m pip install blackboardsync

From source

Requirements

Python 3.10 & pip

Pipenv

Git

From your command line:

Clone the repository

git clone https://github.com/jacobszpz/BlackboardSync.git
cd BlackboardSync

To fetch the dependencies, run

pipenv install

To start the program

cd blackboard_sync
pipenv run python -m blackboard_sync

Contributions

Contributions are welcome.

More details available at CONTRIBUTING.md

Bugs, issues or feature requests?

Open a GitHub issue here.

Show Your Support

Ko-fi ☕

LiberaPay

Bitcoin ₿

bc1qhvcs07y3jnf09kahefscs05gxlmvhu542wzvgp

License

This software is distributed under the General Public License v2.0, more information available at the Free Software Foundation.

Acknowledgements

Blackboard API documentation

PyInstaller

README templates/guide by tonycrosby-tech, neildrew, and Rita Łyczywek