PHPackages                             inspiredminds/contao-youtube-sync - 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. [Utility & Helpers](/categories/utility)
4. /
5. inspiredminds/contao-youtube-sync

ActiveContao-bundle[Utility & Helpers](/categories/utility)

inspiredminds/contao-youtube-sync
=================================

Contao extension to synchronize a contao news archive with a YouTube playlist.

2.1.0(9mo ago)31.5k2LGPL-3.0-or-laterPHPPHP >=8.2

Since Jun 5Pushed 9mo ago2 watchersCompare

[ Source](https://github.com/inspiredminds/contao-youtube-sync)[ Packagist](https://packagist.org/packages/inspiredminds/contao-youtube-sync)[ Docs](https://github.com/inspiredminds/contao-youtube-sync)[ GitHub Sponsors](https://github.com/sponsors/fritzmg)[ RSS](/packages/inspiredminds-contao-youtube-sync/feed)WikiDiscussions main Synced yesterday

READMEChangelog (7)Dependencies (20)Versions (11)Used By (0)

[![](https://camo.githubusercontent.com/0cdf417072ad5a919ec6c2bef6ed9cdac1eeb13699318e75bbd6676109f1749a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f696e7370697265646d696e64732f636f6e74616f2d796f75747562652d73796e632e737667)](https://packagist.org/packages/inspiredminds/contao-youtube-sync)[![](https://camo.githubusercontent.com/a9b8a40b4ef9ce720fd5e2cccbd38af2afac402b9a8103549b3585bc19b0b448/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f696e7370697265646d696e64732f636f6e74616f2d796f75747562652d73796e632e737667)](https://packagist.org/packages/inspiredminds/contao-youtube-sync)

Contao YouTube Sync
===================

[](#contao-youtube-sync)

This extension allows you to automatically import all videos of a YouTube playlist as news entries in Contao.

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

[](#configuration)

First you need to obtain a Google API key.

1. Go to [console.developers.google.com](https://console.developers.google.com/) and create a project, or use an existing one.
2. Go to the [API Library](https://console.developers.google.com/apis/library) and search for *YouTube Data API v3*.
3. Enable the *YouTube Data API v3* for your project.
4. Go to the [Credentials](https://console.developers.google.com/apis/credentials) of your project and choose *Create Credentials* » *API key*. You can also use an existing key.
5. Copy the API key for later use.

After obtaining the API key it can be configured for the extension:

```
# config/config.yml
contao_youtube_sync:
    developer_key:
```

Once this extension is installed, you will have additional options in the settings of your Contao news archives:

[![YouTube synchronisation settings](https://raw.githubusercontent.com/inspiredminds/contao-youtube-sync/master/screenshot.png)](https://raw.githubusercontent.com/inspiredminds/contao-youtube-sync/master/screenshot.png)

Enable the synchronisation and set the YouTube playlist ID from which to import videos as news entries. You also need to define a default author for the synchronised entries and a target directory for the downloaded thumbnail images. Optionally you can define whether new entries should be published by default or not and if already synchronised entries should always be updated (this will not update the alias or author).

Synchronisation
---------------

[](#synchronisation)

Synchronisation can be triggered in three ways:

- **Cronjob**: executed hourly.
- **Command**: `contao_youtube_sync:sync`
- **Back end**: in the article overview, use the *YouTube sync* link in the global operations.

Events
------

[](#events)

Whenever a YouTube video is imported as a news article (or whenever a news article is updated), the following event will be dispatched:

```
InspiredMinds\ContaoYouTubeSync\Event\NewsYouTubeSyncEvent

```

This event lets you retrieve the `\Contao\NewsModel` to be saved to the database, as well as the `\Google\Service\YouTube\PlaylistItem` instance of the YouTube video. It also allows you to *discard* the news article (or the changes added to it) by setting `$event->setDiscard(true)`.

Templates
---------

[](#templates)

There will be two additional variables available within a news template:

- `$this->youtube_id`: This will contain the video ID of the YouTube video, if the news article was imported from a YouTube playlist.
- `$this->youtube_data`: This is an object containing the original data of the video from the Google YouTube API.

The extension also provides a basic `news_youtube` template, which can be used instead of the `news_full` template for the newsreader of YouTube videos. The template contains markup to show the YouTube video embedded in an iframe.

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance56

Moderate activity, may be stable

Popularity23

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 96.4% 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 ~214 days

Recently: every ~0 days

Total

10

Last Release

292d ago

Major Versions

1.0.4 → 2.0.02025-09-13

PHP version history (2 changes)1.0.0PHP >=7.1

2.0.0PHP >=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/25f6ec05570f72d0fcc4d0a4fef2309799d53badf8b30484284e73724661e0d8?d=identicon)[fritzmg](/maintainers/fritzmg)

---

Top Contributors

[![fritzmg](https://avatars.githubusercontent.com/u/4970961?v=4)](https://github.com/fritzmg "fritzmg (27 commits)")[![Defcon0](https://avatars.githubusercontent.com/u/1485098?v=4)](https://github.com/Defcon0 "Defcon0 (1 commits)")

### Embed Badge

![Health badge](/badges/inspiredminds-contao-youtube-sync/health.svg)

```
[![Health](https://phpackages.com/badges/inspiredminds-contao-youtube-sync/health.svg)](https://phpackages.com/packages/inspiredminds-contao-youtube-sync)
```

###  Alternatives

[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.6M574](/packages/shopware-core)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M203](/packages/sulu-sulu)[contao/core-bundle

Contao Open Source CMS

1231.6M2.8k](/packages/contao-core-bundle)[chameleon-system/chameleon-base

The Chameleon System core.

1028.6k5](/packages/chameleon-system-chameleon-base)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.5k5.9M738](/packages/sylius-sylius)

PHPackages © 2026

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