# Kinescope plugin for Moodle


If you use Moodle, you can add a Kinescope video in any text editor on the platform by pasting a link. The Kinescope media plugin recognizes it and turns it into an embedded player inside the course.

## How it works

The plugin is a **Media player** type in Moodle. After you install and enable it, it registers the Kinescope domain as an allowed media source. From there:

1. You copy a video link from Kinescope.
2. You paste it into a Moodle text editor — course description, assignment, page, or another activity.
3. Moodle replaces the link with an embedded Kinescope player.

The student sees the player on the course page, without leaving for another site.

## Installation

The plugin is in the official Moodle plugins directory: [media_kinescope](https://moodle.org/plugins/media_kinescope/versions). The current version is **v1.0.3**. It supports Moodle 3.11, 4.0–4.5, 5.0, and 5.1.

To install:

1. Download the ZIP from the plugin page on Moodle.org.
2. Extract it on the server to:

   ```
   /path/to/moodle/media/player/kinescope
   ```

3. Sign in to Moodle as an administrator and open site administration. Moodle detects the new plugin and offers to finish the install.

> **Информация:**

The plugin is also listed in the [Moodle plugins directory](https://moodle.org/plugins/media_kinescope) if you prefer to install by hand or through version control.



## Configuration

After installation, enable the plugin:

1. In the admin panel open **Site administration → Plugins → Manage media players**.
2. Find **Kinescope** in the list and turn it on.
3. Save the changes.

That is enough for basic use.

### Default player size

In the plugin settings you can set the player height and width for every embedded video on the platform. Open the plugin parameters in the same media players section and enter values in pixels.

> **Информация:**

Sizes in the plugin settings apply globally. For a one-off size, edit the embed HTML in Moodle's advanced editor.



## Usage tips

**Use a direct video link.** The plugin recognizes links like `https://kinescope.io/VIDEOID`. Copy the link to a specific video, not a folder or a project.

**Restrict playback by domain.** To play the video only inside your Moodle site, turn on [domain restriction](https://docs.kinescope.com/content-protection/access-restrictions/) in the Kinescope video settings. Then the player will not open on other sites even if someone copies the link.

**Check video privacy.** Kinescope videos can be access-restricted by default. Make sure privacy settings allow playback through the plugin, or students will see a playback error.

**Do not paste embed code instead of a link.** The plugin works with video links. An iframe pasted as-is may show as text or not show at all, depending on the editor settings.

## Who already uses the plugin

According to the official Moodle directory, the plugin is installed on more than **22 platforms** worldwide, including education organizations and corporate learning portals that store and protect course video in Kinescope.

## What's next?

After you set up the integration:

1. **[Restrict video access](https://docs.kinescope.com/content-protection/access-restrictions/)** — allow playback only on your LMS domain.
2. **[Media file settings](https://docs.kinescope.com/catalog-and-video-management/media-file-settings/)** — privacy and access conditions.
3. **[Content protection](https://docs.kinescope.com/content-protection/)** — DRM encryption and watermarks.
4. **[Analytics](https://docs.kinescope.com/catalog-and-video-management/analytics/)** — who watches course videos and for how long.
5. **[Open edX](https://docs.kinescope.com/integrations/integration-with-open-edx/)** — if you also run Open edX.

Questions? Write to [support chat](https://t.me/kinescope_bot).