PHPackages                             mpc/mpc-vidply - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Image & Media](/categories/media)
4. /
5. mpc/mpc-vidply

ActiveTypo3-cms-extension[Image & Media](/categories/media)

mpc/mpc-vidply
==============

Universal, Accessible Video & Audio Player for TYPO3. Includes support for HTML5 video/audio, YouTube, Vimeo, SoundCloud, HLS streaming, playlists, captions, transcripts, sign language, and full WCAG 2.1 AA accessibility compliance.

1.0.47(1mo ago)2374↓20%[1 issues](https://github.com/MatthiasPeltzer/mpc-vidply/issues)GPL-2.0-or-laterPHPPHP ^8.2

Since Nov 29Pushed 2mo agoCompare

[ Source](https://github.com/MatthiasPeltzer/mpc-vidply)[ Packagist](https://packagist.org/packages/mpc/mpc-vidply)[ Docs](https://github.com/MatthiasPeltzer/mpc-vidply)[ RSS](/packages/mpc-mpc-vidply/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (8)Versions (49)Used By (0)

VidPly TYPO3 Extension
======================

[](#vidply-typo3-extension)

Universal, accessible video and audio player for **TYPO3 13/14** with YouTube, Vimeo, SoundCloud, and HLS streaming support.

Features
--------

[](#features)

- **Privacy-First External Services** - YouTube, Vimeo, SoundCloud with GDPR-compliant consent layer
- **Site-Wide Privacy Settings** - Centralized backend configuration for privacy layer texts, links, and headlines
- **Media Library** - Reusable media records across your site
- **Auto Playlists** - 2+ items automatically create playlists
- **Full Accessibility** - Captions, chapters, audio description, sign language, keyboard controls
- **HLS Streaming** - Adaptive bitrate streaming with hls.js
- **Modern Player** - Responsive, Picture-in-Picture, quality switching, playback speed
- **Conditional Asset Loading** - Only loads JavaScript needed for your media types

Quick Start
-----------

[](#quick-start)

### Install

[](#install)

```
composer require mpc/mpc-vidply
```

1. **Database Update** → Maintenance → Analyze Database Structure
2. **Include Static Template** → Root page → "VidPly Player (mpc\_vidply)"
3. **Clear Caches**

### Create Media

[](#create-media)

**List Module → VidPly Media**

Choose media type:

- **HTML5 Video/Audio** - Upload MP4, WebM, MP3
- **YouTube** - Paste video URL
- **Vimeo** - Paste video URL
- **SoundCloud** - Paste track/set URL
- **HLS** - Enter .m3u8 stream URL

### Configure Privacy Layer Settings

[](#configure-privacy-layer-settings)

**List Module → Privacy Layer Settings**

Manage privacy layer content for YouTube, Vimeo, and SoundCloud:

- **Headline** (optional) - Display above privacy text
- **Intro Text** - Text before privacy policy link
- **Outro Text** - Text after privacy policy link
- **Policy Link** - URL to privacy policy page
- **Link Text** - Text for the privacy policy link
- **Button Label** (optional) - Accessible label for play button

Settings support multilingual content and apply to both single items and playlists. Empty fields fall back to default translations.

### Add to Page

[](#add-to-page)

**Page Module → Add Content → VidPly Player**

- Select media items (1 = single player, 2+ = playlist)
- Configure player options
- Save and view

Media Types
-----------

[](#media-types)

TypeSourcePrivacy LayerNotesHTML5 VideoUpload/URLNoMP4, WebM, OGGHTML5 AudioUpload/URLNoMP3, OGG, WAVYouTubeVideo URLYesGDPR consent requiredVimeoVideo URLYesGDPR consent requiredSoundCloudTrack/Set URLYesGDPR consent requiredHLS.m3u8 URLNoAdaptive streamingPrivacy Layer
-------------

[](#privacy-layer)

For YouTube, Vimeo, and SoundCloud:

- No tracking before user consent
- Play button overlay with privacy notice
- One-click activation - loads and plays immediately
- Centralized backend configuration for all privacy texts
- Multilingual support for privacy settings
- Auto-translated fallbacks (German and English)

Configuration
-------------

[](#configuration)

### Player Options

[](#player-options)

OptionDefaultDescriptionControlsOnShow player controlsKeyboardOnEnable shortcutsResponsiveOnResponsive sizingAuto AdvanceOnAuto-play next in playlistAutoplayOffStart automaticallyLoopOffLoop contentTranscriptOffShow transcript panel### Keyboard Shortcuts

[](#keyboard-shortcuts)

- **Space/K** - Play/Pause
- **M** - Mute
- **F** - Fullscreen
- **C** - Captions
- **←/→** - Seek ±10s
- **↑/↓** - Volume ±10%

Accessibility
-------------

[](#accessibility)

- **Captions/Subtitles** - WebVTT files with language codes
- **Chapters** - WebVTT file with timestamps for navigation
- **Audio Description** - Alternative audio tracks for visually impaired users
- **Sign Language** - Overlay videos with sign language interpretation
- **Transcripts** - Auto-generated searchable transcripts from captions

Playlists
---------

[](#playlists)

**Single Item** → Single player
**2+ Items** → Automatic playlist with visual panel, track navigation, auto-advance, and loop options

**Lazy loading behavior (local MP4/MP3 + HLS):**

- If **Autoplay is off**, the extension configures VidPly to **defer network loading** until the user starts playback (reduced initial bandwidth for pages with many players).
- In **playlists**, selecting a track initializes the UI/metadata (poster, duration, captions/chapters menus) and a click on a playlist item **loads and plays** that track.

Advanced
--------

[](#advanced)

### Conditional Asset Loading

[](#conditional-asset-loading)

Only loads JavaScript needed for your media types:

- **External services** - PrivacyLayer.js (~5KB)
- **Local video/audio** - VidPly core + PlaylistInit (~180KB)
- **HLS streaming** - Adds hls.js when .m3u8 streams detected
- **Playlists** - PlaylistInit.js loads for 2+ items

Performance improvement: Up to 97% reduction for external services.

### Template Structure

[](#template-structure)

Modular template partials:

- `VidPly/Assets.html` - Asset registration
- `VidPly/VideoSources.html` - Video source rendering
- `VidPly/AudioSources.html` - Audio source rendering
- `VidPly/Tracks.html` - Caption/chapter tracks
- `VidPly/MetadataScripts.html` - Accessibility metadata
- `VidPly/PrivacyLayer.html` - External service consent

Documentation
-------------

[](#documentation)

- [Editors Guide](Documentation/Editors-Guide.md) - How to use VidPly for content editors
- [Developers Quickstart](Documentation/Developers-Quickstart.md) - Quick reference for developers
- [AssetLoading.md](Documentation/AssetLoading.md) - Conditional asset loading optimization
- [Partials.md](Documentation/Partials.md) - Template structure and customization
- [PrivacyLayer.md](Documentation/PrivacyLayer.md) - External service privacy implementation
- [HLS-Implementation.md](Documentation/HLS-Implementation.md) - HLS streaming technical details

Troubleshooting
---------------

[](#troubleshooting)

**Media not showing?**

- Check media record is not hidden
- Verify file/URL is accessible
- Check database MM relation

**Playlist not working?**

- Need 2+ items for playlist
- Check JavaScript console for errors
- Verify PlaylistInit.js loads

**Privacy layer not working?**

- Clear TYPO3 caches
- Check PrivacyLayer.js loads
- Verify Privacy Layer Settings are configured

Requirements
------------

[](#requirements)

- **TYPO3**: 13.4+ or 14.x
- **PHP**: 8.2+ (8.3 recommended)
- **Composer**: Required
- **Browsers**: Chrome 90+, Firefox 88+, Safari 14+

License
-------

[](#license)

GNU General Public License v2.0 or later

Author
------

[](#author)

Matthias Peltzer

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance76

Regular maintenance activity

Popularity19

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Recently: every ~11 days

Total

48

Last Release

53d ago

PHP version history (2 changes)v1.0.0PHP >=8.2

1.0.13PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/0e83a68b66501b808de6117f7849ba0599205126aa412e80f486156f26b4f821?d=identicon)[MatPeltz](/maintainers/MatPeltz)

---

Top Contributors

[![MatthiasPeltzer](https://avatars.githubusercontent.com/u/7772293?v=4)](https://github.com/MatthiasPeltzer "MatthiasPeltzer (106 commits)")

### Embed Badge

![Health badge](/badges/mpc-mpc-vidply/health.svg)

```
[![Health](https://phpackages.com/badges/mpc-mpc-vidply/health.svg)](https://phpackages.com/packages/mpc-mpc-vidply)
```

###  Alternatives

[fluidtypo3/vhs

This is a collection of ViewHelpers for performing rendering tasks that are not natively provided by TYPO3's Fluid templating engine.

1954.1M49](/packages/fluidtypo3-vhs)[netresearch/rte-ckeditor-image

Image support in CKEditor for the TYPO3 ecosystem - by Netresearch

63991.3k4](/packages/netresearch-rte-ckeditor-image)[typo3/testing-framework

The TYPO3 testing framework provides base classes for unit, functional and acceptance testing.

675.0M775](/packages/typo3-testing-framework)[eliashaeussler/typo3-form-consent

Extension for TYPO3 CMS that adds double opt-in functionality to EXT:form

1481.0k](/packages/eliashaeussler-typo3-form-consent)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)