NTULearn: CLI reference
Service overview · CLI reference · MCP reference
Example
List your enrolled courses, then use a returned course ID to browse its content. The ID below is fictional.
ntu learn courses --limit 20
ntu learn content _100_1 --limit 20
Commands
Choose a command for its arguments, examples and result fields. Use ntu learn --help and append --help to a command for option details. Each command page identifies required arguments and any defaults. See the complete CLI reference for shared settings and all services.
For learn attachments, learn files read, learn files download, and learn videos download, a quoted NTULearn document or lecture launch URL can replace the course and content IDs. File commands still require an attachment ID, which can be found with learn attachments. A URL can also replace the content ID when the course ID is supplied separately; their course IDs must match. Content browsing accepts a document URL in --parent.
For videos, recognizing a URL only extracts its IDs. The downloader still requires a supported Kaltura player or wrapper in the content item; it does not open arbitrary LTI tools. See known issues.
Find a content or attachment ID
- Run
ntu learn coursesand copy the course ID from the result. - Run
ntu learn content COURSE_IDto list the top level. The displayed items include their content IDs. - If the item is inside a folder, run
ntu learn content COURSE_ID --parent FOLDER_IDuntil you find it. Alternatively, usentu learn content tree COURSE_IDfor a nested view. - For a file, run
ntu learn attachments COURSE_ID CONTENT_IDand copy the attachment ID. For a video, use the content ID withntu learn videos download.
The normal terminal output includes these IDs; --json is optional. A supported content URL can supply the course and content IDs, but a file command still needs its attachment ID.
Courses, folders and search
List your courses first, then use a returned course ID to browse content or search. content tree walks nested folders within the configured limits.
| Command | What it does |
|---|---|
ntu learn auth status |
Sign in to NTULearn and report whether access is verified. |
ntu learn content tree |
Read a course's nested content tree. |
ntu learn content show |
Read one level of course content. |
ntu learn courses list |
List your enrolled NTULearn courses and organizations, including published availability and course IDs. |
ntu learn search all |
Recursively search content across available enrolled courses, or selected course_ids. |
ntu learn search course |
Recursively search one course's content titles, body and description for a case-insensitive substring. |
Attachments and downloads
List attachments to obtain an attachment ID. Downloads need an explicit destination and confirmation; a supported NTULearn URL can supply the course and content IDs.
| Command | What it does |
|---|---|
ntu learn attachments |
List files attached to a course content item. |
ntu learn courses download |
Recursively save readable Blackboard attachments under destination/course_id with content folder names and stable file IDs. |
ntu learn files read |
Read an attachment inline as text: PDF, DOCX, PPTX, XLSX and UTF text/code. |
ntu learn files download |
Download a Blackboard attachment to an explicit local file path, up to 20 MB. |
ntu learn videos download |
Download a Kaltura video embedded in an NTULearn content item to a new local file. |
Announcements, calendar and grades
Read activity for a course or collect information across enrolled courses. Date and time inputs without a timezone use Singapore time.
| Command | What it does |
|---|---|
ntu learn announcements |
Read published announcements for one enrolled course. |
ntu learn grades |
Read visible gradebook columns and your own scores/status. |
ntu learn calendar |
Read calendar entries and published deadlines, across your courses or for one course. |
ntu learn upcoming |
Collect all calendar pages across your enrolled courses. |
ntu learn digest |
Digest of recent announcements, upcoming calendar items and your gradebook across courses. |
Messages, participants and groups
Browse participants, groups and messages visible to your account.
| Command | What it does |
|---|---|
ntu learn users |
List course users visible to your account, with their published names and roles. |
ntu learn groups members |
List visible members of a course group through Blackboard's browser membership API. |
ntu learn groups list |
List groups and group sets defined in a course. |
ntu learn messages list |
List Blackboard inbox/sent messages through readable course conversations, without marking them read. |
ntu learn messages read |
Read a message's full body and published conversation recipients. |