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 and DASH streaming, playlists, captions, transcripts, sign language, and WCAG 2.2 AA accessibility compliance. 1.2.14(2d ago)2763↓23.3%[1 issues](https://github.com/MatthiasPeltzer/mpc-vidply/issues)GPL-2.0-or-laterPHPPHP ^8.2 Since Nov 29Pushed 2w 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 yesterday READMEChangelogDependencies (25)Versions (86)Used By (0) VidPly TYPO3 Extension ====================== [](#vidply-typo3-extension) Universal, Accessible Video & Audio Player for TYPO3. Includes support for HTML5 video/audio, YouTube, Vimeo, SoundCloud, HLS and DASH streaming, playlists, captions, transcripts, sign language, and WCAG 2.2 AA accessibility compliance. 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 1.6.16** (Chrome / Firefox / Edge / desktop Safari) and native HLS on iOS / iPadOS — both paths integrate with VidPly's captions, transcript and quality menus - **DASH Streaming** - MPEG-DASH via **dash.js 5.2.0** (modern UMD) with adaptive quality and subtitles (integrated into video/audio types) - **SoundCloud Renderer** - First-class SoundCloud playback through the SoundCloud Widget API (in addition to the GDPR consent layer) - **Buffering Spinner** - Centered loading spinner shown automatically while the media is buffering - **Optional Download Button** - Per-media download control with custom URL support - **Modern Player** - Responsive, Picture-in-Picture, quality switching, playback speed - **TypeScript Codebase** - The bundled VidPly player is now authored in strict TypeScript with shipped `.d.ts` declarations - **Conditional Asset Loading** - Only loads JavaScript needed for your media types - **Listview & Detail Page** — Add a **VidPly Listview** content element for one or more browsable rows (horizontal shelf or responsive grid), optional per-row **browser pagination** and **sort** control, category chips on cards, and links to a **VidPly Detail** page with short + **long (RTE) description**, categories, and slug or `?media=` URLs; connected translations follow the default-language row configuration (see [`Documentation/Listview.md`](Documentation/Listview.md)) 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: - **Video** - Upload MP4, WebM or add HLS/DASH streaming URLs (with progressive fallbacks) - **Audio** - Upload MP3, OGG or add HLS/DASH streaming URLs (with progressive fallbacks) - **YouTube** - Paste video URL - **Vimeo** - Paste video URL - **SoundCloud** - Paste track/set 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 LayerNotesVideoUpload/URLNoMP4, WebM, HLS (.m3u8), DASH (.mpd) with fallbacksAudioUpload/URLNoMP3, OGG, HLS (.m3u8), DASH (.mpd) with fallbacksYouTubeVideo URLYesGDPR consent requiredVimeoVideo URLYesGDPR consent requiredSoundCloudTrack/Set URLYesGDPR consent required; once accepted, played via the dedicated SoundCloud Widget rendererPrivacy 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 (video/audio including HLS/DASH sources):** - 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) - **Video/Audio** - VidPly core + PlaylistInit (~180KB) - **HLS sources** - Adds hls.js when .m3u8 streams detected - **DASH sources** - Adds dash.js when .mpd 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 - [Listview & Detail](Documentation/Listview.md) - Mediathek-style overview, detail page, routing, pagination, i18n behaviour - [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 & DASH streaming technical details - [SettingsArchitecture.md](Documentation/SettingsArchitecture.md) - Configuration system architecture 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 (Core, Fluid, Extbase) - **PHP**: 8.2+ (8.3 recommended) - **Composer**: Required - **Browsers**: Chrome 90+, Firefox 88+, Safari 14+ `fluid_styled_content` is optional. VidPly registers its own frontend content-rendering TypoScript (`lib.mpcVidplyContentElement`) and ships a compatible Default layout for `tt_content` headers and frame classes. License ------- [](#license) GNU General Public License v2.0 or later Author ------ [](#author) Matthias Peltzer ### Health Score 48 — FairBetter than 93% of packages Maintenance88 Actively maintained with recent releases Popularity21 Limited adoption so far Community6 Small or concentrated contributor base Maturity63 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 Total 85 Last Release 2d 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 (184 commits)") ### Code Quality TestsPHPUnit ### 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 [friendsoftypo3/content-blocks TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML 103519.9k53](/packages/friendsoftypo3-content-blocks)[pagemachine/typo3-formlog Form log for TYPO3 23238.6k8](/packages/pagemachine-typo3-formlog)[netresearch/rte-ckeditor-image Image support in CKEditor for the TYPO3 ecosystem - by Netresearch 611.1M8](/packages/netresearch-rte-ckeditor-image)[typo3/cms-install TYPO3 CMS Install Tool - The Install Tool is used for installation, upgrade, system administration and setup tasks. 1812.3M494](/packages/typo3-cms-install)[web-vision/wv_deepltranslate DeepL Translate (CORE) - This extension provides option to translate content element, and TCA record texts to DeepL supported languages. 33304.3k](/packages/web-vision-wv-deepltranslate)[web-vision/deepltranslate-core DeepL Translate (CORE) - This extension provides option to translate content element, and TCA record texts to DeepL supported languages. 33142.5k8](/packages/web-vision-deepltranslate-core) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)