hoseo_lms

A data aggregation tool for Hoseo University LMS. Collects course metadata, schedules, and generates reports. No automatic attendance submission or grade modification.

Overview

This skill provides three independent utilities:

1. 1. Data Aggregation: Reads public LMS course pages and generates JSON reports
2. Schedule Analysis: Parses deadlines and activity schedules
3. Lecture Playback Utility: User-controlled video playback with progress tracking

All operations are user-initiated, read-only, and locally stored.

Modules

scraper

Aggregates course data into a structured JSON report.

CODEBLOCK0

Input: User credentials (for authentication only)
Output: ~/.config/hoseo_lms/data.json
Data Collected:

• - Course titles, IDs, professor names
• Assignment deadlines and submission status
• Quiz deadlines
• Activity types (video, assignment, quiz, discussion)
• Attendance records and video requirements

Technical Details:

• - Uses HTTP requests to fetch public course pages
• Parses HTML structures (no browser automation)
• Stores data in plaintext JSON for local analysis
• Read-only operation (no modifications to LMS)

summary

Displays aggregated course data in terminal format.

CODEBLOCK1

Input: Previously generated data.json
Output: Terminal report with:

• - Course roster
• Pending assignments
• Quiz schedules
• Attendance status

auto_attend

Video playback utility with progress tracking.

CODEBLOCK2

Purpose: User-directed video playback and progress tracking.

Key Features:

• - User Control: User specifies exact number of videos to play (--limit-lectures)
• Manual Triggering: Requires explicit command with parameters
• Progress Reporting: Logs playback progress and completion status
• No Automatic Submission: Does not submit attendance or modify grades
• Blocking Operation: Waits for completion before returning

Usage Examples:

Play 3 videos from all courses:
CODEBLOCK3

Play 2 videos from specific course:
CODEBLOCK4

Play 5 videos from weeks 1-8:
CODEBLOCK5

Play with direct credentials:
CODEBLOCK6

Play with debug output:
CODEBLOCK7

Options:

Operational Details:

• - Opens video player in browser (popup or new tab)
• Searches for video element in page and all nested iframes
• Waits for video metadata (duration) to load before tracking
• Plays video with muted autoplay (unmutes after playback starts)
• Auto-resumes if video is paused or stalled
• Skips lecture after 3 consecutive failures (no infinite loop)
• Retries page navigation up to 3 times on network errors
• Records completion status
• No enrollment or grade modifications
• No attendance submission (only playback logging)

Sample Output:

[14:30:45] Login successful
[14:30:50] [Database101] Processing started
[14:30:55] [Database101] Watched: 1/3
[14:35:20] [Database101] Watched: 2/3
[14:39:45] [Database101] Watched: 3/3
[14:39:50] [Database101] Processing complete: 3 watched, 3 attempted
[14:39:50] All tasks completed.

Setup and Configuration

Create Credentials File

Step 1: Create directory

CODEBLOCK9

Step 2: Create credentials.json using terminal

Option A: Using cat (Linux/Mac)

CODEBLOCK10

Example:
CODEBLOCK11

Option B: Using echo (Linux/Mac/Windows)

CODEBLOCK12

Example:
CODEBLOCK13

Option C: Using PowerShell (Windows)

CODEBLOCK14

Example:
CODEBLOCK15

Option D: Manual creation with text editor (All OS)

1. 1. Create ~/.config/hoseo_lms/ directory
2. Create credentials.json file
3. Enter content:

{
  "id": "YOUR_STUDENT_ID",
  "pw": "YOUR_PASSWORD"
}

1. 4. Save file

Step 3: Set secure permissions

CODEBLOCK17

(Not required on Windows - file permissions handled by OS)

• - Location: INLINECODE13
• Format: JSON structured data
• Permissions: User-only (chmod 600)
• Content: Course data, schedules, metadata only

Network Activity:

• - HTTPS connections only to INLINECODE14
• No data transmission to external services
• No collection of personal data beyond login

Technical Scope

In Scope (Implemented):

• - Public course page data collection
• HTML parsing and structure extraction
• JSON data aggregation
• Local file storage and retrieval
• Video playback progress tracking

Out of Scope (Not Implemented):

• - Grade submission or modification
• Attendance system integration (submission disabled)
• Assignment submission
• Discussion board automation
• Account modification

Agent Integration Notes

This skill is designed for local data analysis workflows:

1. 1. Data Queries: User asks for course information → Agent reads data.json or runs INLINECODE16
2. Schedule Management: User asks about deadlines → Agent parses data.json and reports
3. Video Playback: User explicitly requests playback with count → Agent executes INLINECODE18

Agent should:

• - Require explicit user request before running INLINECODE19
• Confirm playback count with user
• Report completion status upon script exit
• Treat as utility tool (no policy override needed)

Agent should not:

• - Assume user intent beyond explicit parameters
• Bypass user confirmation for automated actions
• Modify script behavior or skip steps

Limitations

• - Parser updates required if LMS HTML structure changes
• Availability dependent on network connectivity
• Browser compatibility limited to Playwright-supported environments
• Video playback requires working video player in LMS
• No offline mode

Disclaimer

This skill is provided for personal educational data management only. Users are responsible for:

• - Compliance with institutional policies on tool use
• Appropriate use of personal educational data
• Credential security and access control
• Verification of data accuracy before use

The developer assumes no responsibility for institutional policy violations or misuse of generated data.