https://github.com/radio125/scorm-test-ispring-decoder-telegram-bot

Telegram bot for decoding SCORM test data from iSpring. Upload JSON files to get readable test questions and answers.
https://github.com/radio125/scorm-test-ispring-decoder-telegram-bot

bot-development educational-tools ispring json-decoder lms python-3 scorm12 scorm2004 telegram-bot test-analysis

Last synced: 11 days ago
JSON representation

Telegram bot for decoding SCORM test data from iSpring. Upload JSON files to get readable test questions and answers.

• Host: GitHub
• URL: https://github.com/radio125/scorm-test-ispring-decoder-telegram-bot
• Owner: Radio125
• Created: 2024-06-10T16:49:03.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2024-06-11T07:27:24.000Z (7 months ago)
• Last Synced: 2024-12-15T23:42:12.545Z (11 days ago)
• Topics: bot-development, educational-tools, ispring, json-decoder, lms, python-3, scorm12, scorm2004, telegram-bot, test-analysis
• Language: Python
• Homepage:
• Size: 9.96 MB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# SCORM (iSpring Learn) Test Decoder Telegram Bot

![Build Status](https://img.shields.io/github/actions/workflow/status/Radio125/SCORM-Test-Decoder-Telegram-Bot/ci.yml?branch=main)

![License](https://img.shields.io/github/license/Radio125/SCORM-Test-Decoder-Telegram-Bot)

## Table of Contents

- [Description](#description)

- [Features](#features)

- [How to Use](#how-to-use)

- [Example Result](#example-result)

- [Installation](#installation)

- [Configuration](#configuration)

- [Contributing](#contributing)

- [Author](#author)

- [License](#license)

## Description

  Click to expand

  
The SCORM Test Decoder Telegram Bot is designed to facilitate the extraction and decoding of SCORM (Sharable Content Object Reference Model) test questions and answers from JSON files. It supports SCORM versions 1.2 and 2004, making it a versatile tool for analyzing test data.


## Features

  Click to expand

  


    


Upload and Decode SCORM Files: Users can upload data-1.json files containing encrypted SCORM test questions. The bot decrypts the data and provides a readable output.

    


SCORM Test Parsing: The bot automatically identifies the type of each question and provides the correct answers.

    


Real-Time Responses: Provides immediate feedback by decoding and displaying test content upon file upload.

    


Comprehensive Overview: Displays all test questions and answers in a single window for quick review.

  


## How to Use

  Click to expand

  


    


Start the Bot: Add the bot to your Telegram contacts and start a chat.

    


Upload SCORM JSON File: Send the data-1.json file containing SCORM test data to the bot.

    


Receive Decoded Content: The bot processes the file and returns the decoded questions and answers in a readable format.

  


## Example Result

  Click to expand

  
Question: Match the pairs as they should be:

  


    


Type: Matching

    


Answers:

      


        
🔗 Pair 1 part 1 -> Pair 1 part 2

        
🔗 Pair 2 part 1 -> Pair 2 part 2

        
🔗 Pair 3 part 1 -> Pair 3 part 2

      

    

  

  
Question: How many blue hairs does Harry Potter have?

  


    


Type: Multiple Choice

    


Answers:

      


        
❌ A hundred million

        
❌ None

        
✅ Twenty-five

        
❌ Fifty-four

      

    

  

  
Question: Enter the answer to your question from me, how much does a kilo of raisins cost in raisins?

  


    


Type: Text Input

  

  
Question: What is the sequence of notes?

  


    


Type: Sequencing

    


Answers:

      


        
1️⃣ Do

        
2️⃣ Re

        
3️⃣ Mi

        
4️⃣ Fa

        
5️⃣ So

        
6️⃣ La

        
7️⃣ Ti

      

    

  

  
Question: There are 2 correct answers, try to guess which options are correct:

  


    


Type: Multiple Response

    


Answers:

      


        
✅ Second option

        
✅ Option one

        
❌ This is the third option

        
❌ And here is the fourth option

      

    

  


## Installation

  Click to expand

  


    


Clone the Repository:

      Copy command

      
git clone https://github.com/Radio125/SCORM-Test-Decoder-Telegram-Bot.git

    

    


Navigate to the Directory:

      Copy command

      
cd SCORM-Test-Decoder-Telegram-Bot

    

    


Create a Virtual Environment (optional but recommended):

      Copy command

      
python -m venv venv

    

    


Activate the Virtual Environment:

      


        


Windows:

          Copy command

          
venv\Scripts\activate

        

        


macOS/Linux:

          Copy command

          
source venv/bin/activate

        

      

    

    


Install Dependencies:

      Copy command

      
pip install -r requirements.txt

    

    


Run the Bot:

      Copy command

      
python bot.py

    

  


## Configuration

  Click to expand

  
Bot Token: Replace the placeholder token in the config.py file with your actual Telegram Bot API token.

  
SCORM Files: Ensure SCORM JSON files are properly formatted for the bot to decode and process them effectively.


## Contributing

  Click to expand

  
If you would like to contribute to the development of this bot, please feel free to fork the repository and submit pull requests. Any suggestions or bug reports are also welcome via GitHub issues.


## Author

  Click to expand

  
Created by Radio125. Feel free to download, distribute, and modify the code. A simple like is enough!


## License

  Click to expand

  
This project is licensed under the MIT License - see the LICENSE file for details.