# Audio Lesson

{% embed url="<https://youtu.be/sNmXeINHDFI?feature=shared>" %}

The **Audio Lesson Addon** for MasterStudy LMS introduces a new and engaging way to deliver course content. Now you can share audio lessons by uploading audio files or adding them from Spotify or SoundCloud. This addon allows educators to create audio-based lessons using various audio formats, enhancing the learning experience by catering to auditory learners. You can mix audio lessons with text, video, and quizzes to create a comprehensive learning experience. Below is a detailed guide on how to use the Audio Lesson Addon effectively.

#### Key Features

* **Support for Multiple Audio Formats:** The addon supports MP3, OGG, and WAV files.
* **External Audio Links:** Easily integrate audio files hosted on external platforms like Spotify and SoundCloud.
* **Seamless Integration:** Fully integrates with existing MasterStudy LMS courses and lessons.
* **Multimedia Mixing:** Combine audio lessons with text, video, and quizzes for a rich, interactive course experience.

### Enabling the Audio Lesson Addon

1. **Access Addons:**
   * Navigate to your WordPress admin dashboard.
2. **Open MasterStudy LMS Addons:**
   * Go to `MS LMS` > Pro`Addons`.
3. **Enable the Audio Lesson Addon:**
   * Find the Audio Lesson Addon in the list of available addons.
   * Toggle on the button next to the Audio Lesson Addon to enable it.

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FFa5XNmwtzBO7ivD5WBhx%2FPro-Addons-%E2%80%B9-m-pro-plus-%E2%80%94-WordPress.jpg?alt=media&#x26;token=0153d14c-f08f-4e2d-90a7-3ab574531d1c" alt=""><figcaption><p>Enabling Audio Lesson addon</p></figcaption></figure>

### **Set Preferred Audio Source:**

* Before uploading audio files, click on `Preferred Audio Source` in the settings => Course.
* Tick whether or not you will upload audio file formats directly

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FlxVth83REiyVD90XpaUe%2FAudio-Source-type.jpg?alt=media&#x26;token=99ce898c-946e-4a40-84b7-7eb4f6515d36" alt=""><figcaption><p>Choose the Preferred Audio Source Type</p></figcaption></figure>

### Creating an Audio Lesson

1. **Navigate to Course Builder:**
   * From the WordPress admin dashboard, go to `MasterStudy LMS` > `Courses => Add New Course`.
   * Select the course you want to add an audio lesson to or create a new course.
2. **Add New Lesson:**

   * In the course builder, click `Add Lesson`.
   * Select `Audio Lesson` from the lesson type options.

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FTFvdyTHqVDwFLdQQO1NK%2FAudio%20Add%20lesson.jpg?alt=media&#x26;token=f7a24e41-b160-41f4-b93d-438d50c490da" alt=""><figcaption><p>Audio Lesson</p></figcaption></figure>

**Upload Audio Files:**

* Click on `Upload Audio` to add MP3, OGG, or WAV files from your computer.
* Alternatively, you can add external links by selecting the `Add External Link` option and entering the URL of the audio file from platforms like Spotify or SoundCloud.

**Configure Lesson Settings:**

* Enter the lesson title and description.

**Publish the Lesson:**

* Once all details are filled in, click `Publish` to make the audio lesson available to your students.

{% tabs %}
{% tab title="Audio File Upload" %}

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2F8IUD1CpBbSnlKi1E6Gvi%2FCourse-Audio-file.jpg?alt=media&#x26;token=31f6b083-0def-4230-bad7-c4edf03d6734" alt=""><figcaption></figcaption></figure>
{% endtab %}

{% tab title="Audio Lesson View" %}

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FRjqT4baF9aWYCJWBe6iD%2FAudio-Lesson-view.jpg?alt=media&#x26;token=0e284e80-6cb2-42c8-ab43-855667d60bc4" alt=""><figcaption></figcaption></figure>
{% endtab %}
{% endtabs %}

### Managing Audio Lessons

* **Edit Existing Lessons:**
  * To edit an audio lesson, go to `MasterStudy LMS` > `Courses`, select the course, and click on the lesson you wish to edit.
  * Make the necessary changes and update the lesson.

Let's say we want to enhance our lesson by integrating a SoundCloud podcast.

To do this, follow these steps:

1. Navigate to SoundCloud and find the podcast you wish to embed.
2. Click on the 'Share' button and select 'Embed' to generate the embed code for the podcast.
3. Copy the generated embed code to your clipboard.

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FumqDQVkS47szBG3bKLX7%2Fsoundcloud-embedded-code.jpg?alt=media&#x26;token=e56460b4-afe0-40ea-87a4-59fb3f76bee8" alt=""><figcaption><p>Copying embedded code from SoundCloud</p></figcaption></figure>

Next, edit the lesson where you want to include the podcast:

1. Open the lesson in your preferred editor.
2. Switch to the source code or HTML view of the lesson.
3. Paste the copied embed code into the desired location within the source code.

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FW88sMnTI8R8RLIqOYSSl%2Fedit-lesson-soundcloud.jpg?alt=media&#x26;token=c3aa5f34-b4d6-407f-9bab-da3b088e9fdd" alt=""><figcaption></figcaption></figure>

Example of embedded SoundCloud code:

```html
<iframe width="100%" height="300" scrolling="no" frameborder="no" allow="autoplay" src="https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/playlists/1586853385&color=%23ff5500&auto_play=false&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true"></iframe><div style="font-size: 10px; color: #cccccc;line-break: anywhere;word-break: normal;overflow: hidden;white-space: nowrap;text-overflow: ellipsis; font-family: Interstate,Lucida Grande,Lucida Sans Unicode,Lucida Sans,Garuda,Verdana,Tahoma,sans-serif;font-weight: 100;"><a href="https://soundcloud.com/takeiteasyrec" title="Take It Easy Records" target="_blank" style="color: #cccccc; text-decoration: none;">Take It Easy Records</a> · <a href="https://soundcloud.com/takeiteasyrec/sets/deep-house-2023" title="Deep House 2024" target="_blank" style="color: #cccccc; text-decoration: none;">Deep House 2024</a></div>
```

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FCK5SWBKsCuSD9uh4M04o%2FLesson-1-example.jpg?alt=media&#x26;token=2e45fb5f-82c1-4cfc-bf07-62d7508a44b8" alt=""><figcaption><p>Edited Audio Lesson View</p></figcaption></figure>

By following these steps and examples, you can seamlessly add enriching SoundCloud and any external podcasts to your lessons.

## Required Audio Progress&#x20;

The **Required Audio Progress** feature ensures that learners listen to a certain percentage of a lesson’s audio before marking it as complete. As they listen, a progress indicator displays how much of the audio has been passed, and the **Complete** button remains disabled until the specified listen threshold (e.g., 75% or 100%) is met—this helps maintain course quality by requiring students to fully engage with the content.

{% hint style="info" %}
**Required Audio Progress** is **available in all audio source types** except **Embed** and **Shortcode** types. They **do not** function with them, as those methods **lack direct access** to the audio player's time data, preventing progress tracking.
{% endhint %}

### How to Set Required Audio Progress Percentage?

This is quite a straightforward process.&#x20;

{% stepper %}
{% step %}
Create or edit any audio lesson except **Embed** and **Shortcode** source types in [**Course Builder**](https://docs.stylemixthemes.com/masterstudy-lms/lms-course-features/course-builder) and write down the **Required Audio Progress** **(%)** percentage to see:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FELwsv0zXkaJn0u1eT95m%2Fimage.png?alt=media&#x26;token=7750c169-26da-49e2-b695-cf23947bbb40" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Save** the changes:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FpHiwP9xRZnOU5XtvWAtJ%2Fimage.png?alt=media&#x26;token=9f3efd32-e135-4598-b6fb-c6685b1ea967" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

Here is how it will look to students:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FbtYssyBol64lswKg0Ell%2Fimage.png?alt=media&#x26;token=ca929d82-d6d6-4225-b244-2cc892e22d24" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Because the Required Audio Progress feature only **controls the lesson’s completeness**, a student can still **access the next lesson** via the **curriculum** or a direct link **even if** they haven’t met the watch percentage.

***

However, if you want to prevent moving to the next lesson without completing this lesson and ensure proper lesson sequencing, you can use the [**Drip Content**](https://docs.stylemixthemes.com/masterstudy-lms/lms-pro-addons/drip-content) **add-on.**&#x20;
{% endhint %}

## Timecodes

**Timecodes** let you link specific points of audio to text in your lesson, so learners can jump straight to the exact moment they need. This is especially helpful for longer audio with multiple topics, allowing students to quickly navigate to relevant sections without manually scrubbing through the entire audio.

{% hint style="warning" %}
Timecodes **are available in all audio source types** except **Embed** and **Shortcode** types. They **do not** function with them, as those methods **lack direct access** to the audio player's time data, preventing progress tracking and timestamp jumps.
{% endhint %}

### How to Add Timecodes to Audio Lessons?

This is quite a straightforward process.

{% stepper %}
{% step %}
Create Audio lesson in [**Course Builder**](https://docs.stylemixthemes.com/masterstudy-lms/lms-course-features/course-builder)**:**

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FCtNgHdluQ9imHZxJGBRR%2Fimage.png?alt=media&#x26;token=a001e17e-dc66-4196-bfac-f3784277145a" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Choose any source type except embed and shortcode types, then provide the rest of the information:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FPSn8MP73DBoFAhbjGWYK%2Fimage.png?alt=media&#x26;token=c38d365e-0f8d-4e3c-a925-5caf3968ddca" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Timecodes Format

Scroll down to the **Lesson Content** section and wrap the timestamp and its title/description in curly braces `{} in.` For example:

```
{wrapped text 01:25}
```

* This signals the LMS that “<mark style="color:purple;">**01:25**</mark>” is a timestamp for your audio, and “**wrapped text**” is simply a label or description.

You can use the timestamp in different positions like this example:

```
#Timestamp at the beginning
{01:25 wrapped text}

#Timestamp in the middle
{wrapped 01:25 text}

#Timestamp at the end
{wrapped text 01:25}
```

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FCLEGukntR3DNXmGv94Tr%2Fimage.png?alt=media&#x26;token=763ec555-d47f-411b-8230-7f08fbdd6e88" alt=""><figcaption><p>Example of Timecodes in Lesson Content</p></figcaption></figure>
{% endstep %}

{% step %}
To get timecodes easily, there is a **Listen Audio** button that opens the audio you provided right in the[ **Course Builder:**](https://docs.stylemixthemes.com/masterstudy-lms/lms-course-features/course-builder)

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FgVqk2OmAkwSPxVSglKT1%2Fimage.png?alt=media&#x26;token=01d3f047-b5c7-40c5-9a05-0a477e9fd2ce" alt=""><figcaption></figcaption></figure>

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FOfOrIgJkt9VhyyL51RXr%2Fimage.png?alt=media&#x26;token=297f9b1c-8a9a-4a44-afed-5d48a4748902" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Here you can see how it will look to students:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FeWe4mMxXw7FfJS6DmMli%2Fimage.png?alt=media&#x26;token=8b6289e8-d4bd-43c7-99a6-3d9beee04324" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Timecodes in Discussions

Students and instructors can use the timecodes to highlight the exact moment of the audio and video lessons. They have to follow [**the same format**](https://docs.stylemixthemes.com/masterstudy-lms/lms-pro-addons/audio-lesson#timecodes-format) as in the Course Builder:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2F6WzYhNe6g4rD70hyHa3A%2Fimage.png?alt=media&#x26;token=662971b6-5d36-4a3b-925a-b26c69062c36" alt=""><figcaption></figcaption></figure>

Here is how it will look after the submission:

<figure><img src="https://691205473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MDTL6WUldKvxQaP8jzz%2Fuploads%2FhnMIDX93wLBDaYhsxL8K%2Fimage.png?alt=media&#x26;token=2e628f75-48c6-47a1-9180-ceb3c9f6e8e7" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stylemixthemes.com/masterstudy-lms/lms-pro-addons/audio-lesson.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
