About QTI Migrator

QTI Migrator

A powerful, cross-platform command-line tool for migrating QTI (Question and Test Interoperability) content between different versions and formats.

Version: 1.0.0

Author: QTI Migration Team

License: MIT License

Language: Go

Platforms: Windows, macOS, Linux

What is QTI?

QTI (Question and Test Interoperability) is an international standard developed by IMS Global Learning Consortium that enables the exchange of assessment content and results between different learning management systems and educational platforms.

Supported QTI Versions

QTI 1.2 - Legacy format, widely deployed
QTI 2.1 - Stable, comprehensive feature set
QTI 2.2 - Enhanced accessibility and adaptive testing
QTI 3.0 - Latest specification with modern features

Why Use QTI Migrator?

Seamless migration between QTI versions
Batch processing for large content libraries
Content validation and error reporting
Preserves assessment logic and metadata
Command-line automation support

Cross-platform CLI tool written in Go

Features

Key Features

Core Features

Supported Formats

Advanced

Core Capabilities

Parse and validate QTI content
Convert between QTI versions (1.2, 2.0, 2.1, 2.2)
Batch processing of multiple files
Command-line interface for automation
Cross-platform support (Windows, macOS, Linux)
Progress tracking and detailed logging

Input/Output Formats

QTI XML (all versions)
Common Cartridge
SCORM packages
CSV export for question banks
JSON format for web applications
Custom format templates

Advanced Features

Content validation and error reporting
Media file handling and migration
Metadata preservation
Custom transformation rules
API for programmatic access
Plugin system for extensions

Installation Guide

Multiple installation options to get QTI Migrator running on your system.

📦 Download Pre-built Binary

The easiest way to get started. Download the appropriate binary for your platform:

Platform-specific Instructions

Windows: Download qti-migrator-windows-amd64.exe and add to PATH

macOS: Download qti-migrator-darwin-amd64 and make executable

Linux: Download qti-migrator-linux-amd64 and make executable

🚀 Install via Go

If you have Go installed (version 1.19 or later required):

go install github.com/sonyccd/qti-migrator@latest

🔧 Build from Source

For developers or custom builds:

git clone https://github.com/sonyccd/qti-migrator.git
cd qti-migrator
go build -o qti-migrator ./cmd/qti-migrator/main.go

✅ Verify Installation

Test that QTI Migrator is installed correctly:

# Check version
qti-migrator --version

# Show help
qti-migrator --help

Usage Examples

# Convert QTI 1.2 to QTI 2.1
qti-migrator convert --input quiz.xml --output quiz_v21.xml --from qti12 --to qti21

# Validate QTI content
qti-migrator validate assessment.xml

# Batch convert all files in directory
qti-migrator batch --input-dir ./assessments --output-dir ./converted --to qti22

Requires Go 1.19 or later

GitHub Repository

Open Source Project

QTI Migrator is open source and available on GitHub!

Repository: github.com/sonyccd/qti-migrator

Stars: ⭐ 142

License: MIT License

Contributing

We welcome contributions! Please see our contributing guidelines on GitHub.

Quick Links

Clone Repository

git clone https://github.com/sonyccd/qti-migrator.git

QTI Migrator Help

Help Center

Comprehensive guide to using QTI Migrator effectively.

Getting Started

Commands

Examples

Troubleshooting

What is QTI Migrator?

QTI Migrator is a command-line tool designed to help educators and developers migrate Question and Test Interoperability (QTI) content between different versions and formats.

Key Benefits

Version Migration: Convert between QTI 1.2, 2.0, 2.1, 2.2, and 3.0
Format Support: Handle XML, JSON, and Common Cartridge formats
Batch Processing: Process multiple files or entire directories
Validation: Verify QTI content integrity before and after migration
Cross-Platform: Works on Windows, macOS, and Linux

Quick Start

# Validate a QTI file
qti-migrator validate assessment.xml

# Convert QTI 1.2 to 2.1
qti-migrator convert --input quiz.xml --output quiz_v21.xml --from qti12 --to qti21

Command Reference

Global Options

--help, -h - Show help information
--version, -v - Show version information
--verbose - Enable verbose output
--quiet - Suppress output except errors

convert

Convert QTI content between versions and formats.

qti-migrator convert [options] --input FILE --output FILE

--input, -i FILE - Input file path (required)
--output, -o FILE - Output file path (required)
--from VERSION - Source QTI version (auto-detected if not specified)
--to VERSION - Target QTI version (required)
--format FORMAT - Output format: xml, json, cc (default: xml)

validate

Validate QTI content against specification schemas.

qti-migrator validate [options] FILE

--version VERSION - QTI version to validate against
--schema FILE - Custom schema file

batch

Process multiple files in batch mode.

qti-migrator batch [options] --input-dir DIR --output-dir DIR

--input-dir DIR - Input directory
--output-dir DIR - Output directory
--pattern GLOB - File pattern to match (default: *.xml)
--to VERSION - Target QTI version

Usage Examples

Basic Conversion

# Convert a single assessment from QTI 1.2 to 2.1
qti-migrator convert -i old_quiz.xml -o new_quiz.xml --from qti12 --to qti21

# Auto-detect source version and convert to QTI 3.0
qti-migrator convert -i assessment.xml -o assessment_v3.xml --to qti30

Batch Operations

# Convert all XML files in a directory
qti-migrator batch --input-dir ./assessments --output-dir ./converted --to qti21

# Process only specific files
qti-migrator batch --input-dir ./tests --output-dir ./updated --pattern "*_test.xml" --to qti22

Validation

# Validate against auto-detected version
qti-migrator validate quiz.xml

# Validate against specific QTI version
qti-migrator validate --version qti21 assessment.xml

Format Conversion

# Convert QTI to JSON format
qti-migrator convert -i quiz.xml -o quiz.json --to qti21 --format json

# Create Common Cartridge package
qti-migrator convert -i assessment.xml -o package.zip --to qti21 --format cc

Troubleshooting

Common Issues

Schema Validation Errors

Problem: File fails validation with schema errors.

Solution: Use --verbose flag to see detailed error messages:

qti-migrator validate --verbose problematic_file.xml

Unsupported QTI Version

Problem: "Unsupported QTI version" error.

Solution: Check supported versions and specify explicitly:

qti-migrator convert -i file.xml -o output.xml --from qti12 --to qti21

Media Files Missing

Problem: Referenced images or media files not found.

Solution: Ensure all referenced files are in the same directory or use absolute paths.

Getting Help

Run qti-migrator --help for command-specific help
Use --verbose flag for detailed processing information
Check the GitHub repository for issue reporting and documentation
Review QTI specification documentation for format requirements

QTI Documentation

QTI Specifications & Documentation

Links to official QTI specifications and related documentation.

Official QTI Specifications

🔗 QTI 3.0 (Latest)

The most current version of the QTI specification with enhanced features and improved interoperability.

🔗 QTI 2.2

Widely adopted version with comprehensive assessment capabilities and good tool support.

QTI Migrator

What is QTI?

Supported QTI Versions

Why Use QTI Migrator?

Key Features

Core Capabilities

Input/Output Formats

Advanced Features

Installation Guide

📦 Download Pre-built Binary

Platform-specific Instructions

🚀 Install via Go

🔧 Build from Source

✅ Verify Installation

Usage Examples

Open Source Project

Contributing

Quick Links

Clone Repository

Help Center

What is QTI Migrator?

Key Benefits

Quick Start

Command Reference

Global Options

convert

validate

batch

Usage Examples

Basic Conversion

Batch Operations

Validation

Format Conversion

Troubleshooting

Common Issues

Schema Validation Errors

Unsupported QTI Version

Media Files Missing

Getting Help

QTI Specifications & Documentation

Official QTI Specifications

🔗 QTI 3.0 (Latest)

🔗 QTI 2.2

🔗 QTI 2.1

🔗 QTI 1.2 (Legacy)

Additional Resources

IMS Global Learning Consortium

Development Resources

Migration Notes

Version Compatibility

Key Differences