cc2olx is a converter of Common Cartridge .imscc files into .tar.gz files that can be imported into Studio.
Converted:
- HTML
- Web links
- Some videos
- LTI links
- QTI assessments
- Assignments
- PDF files
Not converted:
- Images
Clone repository and install via setup.py:
python setup.py install
The converter is a command-line Python 3 program.
To convert one file:
cc2olx -i <IMSCC_FILE>
This will write a .tar.gz file into the tmp directory here.
To store all results in zip file:
cc2olx -r zip -i <IMSCC_FILE>
An embeded video in an iframe tag in HTML can be converted to it's corresponding video xblock if we provide a link map file to it.
The CSV file should have the following header:
External Video Link, Edx Id, Youtube Id
Either Edx Id or Youtube Id should be be present. In case both of these are given Edx Id takes priority.
The link map file can be supplied using -f or --link_file:
cc2olx -r zip -i <IMSCC_FILE> -f <CSV_FILE>
If the original course content contains relative links and the resources (images, documents etc) the links point to are not included into the exported course dump, you can specify their source using -s flag:
cc2olx -i <IMSCC_FILE> -s <RELATIVE_LINKS_SOURCE>
If some custom xBlocks are installed on the target Open edX instance, the corresponding blocks can be specified by -c argument. If the content that such xBlocks can render are found during the course converting, they will be used. The argument values correspond to the xBlock names to specify in advanced_modules inside a course advanced settings.
Supported Custom xBlocks:
Argument usage example:
cc2olx -i <IMSCC_FILE> -c <CUSTOM_BLOCK_1_NAME> -c <CUSTOM_BLOCK_2_NAME>
To make the application platform-independent, it is dockerized. To run the application using Docker you need:
Build the image:
docker build -t cc2olx .
2. Run the conversion command in a container by mounting passed argument path directories/files and passing the corresponding arguments to the script:
docker run --rm -v /input/file/path/cc_course_dump.imscc:/data/input/cc_course_dump.imscc -v /output/file/path/output_dir:/data/output/ cc2olx -r zip -i /data/input/cc_course_dump.imscc -o /data/output/edx_dump
It will convert Common Cartridge dump from /input/file/path/cc_course_dump.imscc and save the OLX in /output/file/path/output_dir/edx_dump.zip file.
There are some test imscc files in test_data directory, but if you can also try cc2olx on some larger courses:
- HBUHSD Geometry Resource Course (29.7 MB) (Kendra Rosales, by-nc-sa 4.0, source)
- Kung Fu Canvas (65.48 MB) (Mike Cowen, by-nc-sa 4.0, source)
- KNOW & The Challenge Mosaic (572.43 MB) (Missy Widmann, by-nc-sa 4.0, source)
We would love help building out this tool. If you can help, either with development, or with real-world testing, please submit pull request or open new issue.
Work that needs to be done:
- Test on real courses
- Clean up the code
- Add support for more Common Cartridge content
- Write more documentation
- The cc2olx repository also has a video upload tool that can be used to upload videos to directly to edX's video encoding pipeline. See the tool's README :ref:`video_upload_tool`. for a further details.
