Senkyoshi Converter

Senkyoshi converts exported Blackboard packages into Canvas .imscc packages. It also allows you to upload those converted packages to a Canvas instance.

Senkyoshi converts Blackboard course exports as well as Instructure's converter with several improvements detailed in the table below:

See Senkyoshi Canvas Plugin if you want to enable this in your canvas app.

Add this line to your application's Gemfile:

gem "senkyoshi"
gem "canvas_cc", git: "https://github.com/atomicjolt/canvas_cc.git"

And then execute:

$ bundle

Or install it yourself as:

$ gem install senkyoshi

Create a Rakefile and add:

require "senkyoshi/tasks"
Senkyoshi::Tasks.install_tasks

Create a senkyoshi.yml and add credentials:

# Generally looks like https://< mycanvas_instance >/api
:canvas_url: <canvas instance api url>

# Canvas tokens can be generated at <my_canvas_url>/profile/settings provided
# that the user has the required privileges
:canvas_token: <canvas token>

# The account or sub-account ID. This can be :self, :default, or an ID
:account_id: <id>

# URL of SCORM manager. This could be the Adhesion app
# [https://github.com/atomicjolt/adhesion]
:scorm_url: <scorm manager url>

# This should be the endpoint to launch a given SCORM course. In the case of
# Adhesion, this will look like https://<adhesion url>/scorm_course
:scorm_launch_url: <scorm launch url>

# This should be the oauth_consumer_key for scorm. In the case of
# Adhesion, it would just be `scorm`.
:scorm_oauth_consumer_key: <scorm oauth consumer key>

# This is the shared id for the jwt aud. In the case of Adhesion it
# will be `adhesion`.
:scorm_shared_id: <scorm shared id>

# This is the secret used to create a jwt to communicate with the SCORM manager.
:scorm_shared_auth: <scorm manager token>

# The number of seconds before uploads timeout. Defaults to 1800 (30 minutes)
:request_timeout: <request timeout seconds>

Senkyoshi rake tasks can be used to batch convert Blackboard Courses to Canvas Courses and optionally upload them to a Canvas instance.

It expects all Blackboard courses to be converted to be in a folder called sources, and outputs to a folder

Run the rake task to convert from .zip to .imscc:

rake senkyoshi:imscc

This will take all your files in your source folder and convert them to your outputs folder.

Run converting files in parallel:

time rake senkyoshi:imscc -m # The `time` command is optional.

Delete entire outputs folder:

rake clean

Upload to Canvas to process:

rake senkyoshi:upload

After checking out the repo, run bundle install to install dependencies. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Bug reports and pull requests are welcome on GitHub at https://github.com/atomicjolt/senkyoshi. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

The gem is available as open source under the terms of the AGPL-3.0 License.