PHPackages awcodes/matinee - 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. awcodes/matinee ActiveLibrary[Utility & Helpers](/categories/utility) awcodes/matinee =============== OEmbed field for Filament Panel and Form Builders. v3.0.0(3mo ago)216.1k↓29.3%101MITPHPPHP ^8.2CI passing Since Feb 21Pushed 2mo ago1 watchersCompare [ Source](https://github.com/awcodes/Matinee)[ Packagist](https://packagist.org/packages/awcodes/matinee)[ Docs](https://github.com/awcodes/matinee)[ GitHub Sponsors](https://github.com/awcodes)[ RSS](/packages/awcodes-matinee/feed)WikiDiscussions 3.x Synced 1mo ago READMEChangelog (8)Dependencies (9)Versions (11)Used By (1) Matinée ======= [](#matinée) OEmbed and Video field for Filament Panel and Form Builders. [![Latest Version](https://camo.githubusercontent.com/ab2cc2ab7ea1828fd1a959770a35675b12540426eb05f4388ff58c27775b2b5a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f6177636f6465732f6d6174696e65652e7376673f7374796c653d666c61742d73717561726526636f6c6f723d626c7565266c6162656c3d52656c65617365)](https://github.com/awcodes/matinee/releases)[![MIT Licensed](https://camo.githubusercontent.com/a7e65aee57b11d28e4caff8b945729a66be0bb663f7f93bd24c5aa65699f148e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d626c75652e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/846e4699a16777241d7336fc8fe8e9dcd0af64e5231c4b95a21c5ebca0275cdb/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6177636f6465732f6d6174696e65652e7376673f7374796c653d666c61742d73717561726526636f6c6f723d626c7565266c6162656c3d446f776e6c6f616473)](https://packagist.org/packages/awcodes/matinee)[![GitHub Repo stars](https://camo.githubusercontent.com/4c02b728d7687f86e887b083a3bce2eb2edd5cd10e200c50428bccd2eb32f943/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f73746172732f6177636f6465732f6d6174696e65653f7374796c653d666c61742d73717561726526636f6c6f723d626c7565266c6162656c3d5374617273)](https://github.com/awcodes/matinee/stargazers) Compatibility ------------- [](#compatibility) Package VersionFilament Version1.x3.x2.x4.x3.x5.xInstallation ------------ [](#installation) You can install the package via composer: ``` composer require awcodes/matinee ``` Important If you have not set up a custom theme and are using Filament Panels follow the instructions in the [Filament Docs](https://filamentphp.com/docs/4.x/styling/overview#creating-a-custom-theme) first. After setting up a custom theme add the plugin's views to your theme css file or your app's css file if using the standalone packages. ``` @source '../../../../vendor/awcodes/matinee/resources/**/*.blade.php'; ``` Preparing your model -------------------- [](#preparing-your-model) Matinée stores its content as JSON data in a single column on your model. So, it is vital that you cast the column to an array or json object in your model. ``` protected $casts = [ 'video' => 'array', // or 'json' ]; ``` Usage ----- [](#usage) ``` use Awcodes\Matinee\Matinee; Matinee::make('video') ``` Forcing the preview to show --------------------------- [](#forcing-the-preview-to-show) ``` use Awcodes\Matinee\Matinee; Matinee::make('video') ->showPreview() ``` Custom Providers ---------------- [](#custom-providers) Matinée comes with a Provider for YouTube and Vimeo, but you can add your own by creating a class and passing it into the `providers` modifier on the field. ``` use Awcodes\Matinee\Providers\Concerns\IsMatineeProvider; use Awcodes\Matinee\Providers\Contracts\MatineeProvider; class CustomProvider implements MatineeProvider { use IsMatineeProvider; public function getId(): ?string { return 'custom'; } public function getDomains(): array { return [ 'custom.com', ]; } public function getOptions(): array { return [ 'controls' => 1, 'title' => 0, ]; } public function convertUrl(?array $options = []): string { return 'https://www.custom.com/embed/' . $this->getId() . '?' . http_build_query($options); } } ``` Then you can use it by passing it into the `providers` modifier on the field instance or globally in the `register` method of a service provider with the `configureUsing()` method. ``` use Awcodes\Matinee\Matinee; Matinee::make('video') ->providers([CustomProvider::class]) ``` Rendering the video ------------------- [](#rendering-the-video) You are free to render the video in any way you see fit, but Matinée comes with a blade component you can use for convenience. ``` ``` The stored data will take the following shape: ``` { "width": "16", "height": "9", "responsive": true, "url": "https:\/\/www.youtube.com\/watch?v=N9qZFD1NkhI", "embed_url": "https:\/\/www.youtube.com\/embed\/N9qZFD1NkhI?controls=1&start=0", "options": { "controls": "1", "nocookie": "0", "start": "00:00:00" } } ``` Testing ------- [](#testing) ``` composer test ``` Contributing ------------ [](#contributing) Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details. Security Vulnerabilities ------------------------ [](#security-vulnerabilities) Please review [our security policy](.github/SECURITY.md) on how to report security vulnerabilities. Credits ------- [](#credits) - [Adam Weston](https://github.com/awcodes) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 52 — FairBetter than 96% of packages Maintenance82 Actively maintained with recent releases Popularity36 Limited adoption so far Community19 Small or concentrated contributor base Maturity60 Established project with proven stability Bus Factor1 Top contributor holds 52.3% 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 ~82 days Recently: every ~50 days Total 10 Last Release 77d ago Major Versions v1.0.3 → v2.0.0-beta.12025-06-20 v2.0.1 → v3.0.02026-01-19 PHP version history (2 changes)v1.0.0PHP ^8.1 v2.0.0-beta.1PHP ^8.2 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/3596800?v=4)[Adam Weston](/maintainers/awcodes)[@awcodes](https://github.com/awcodes) --- Top Contributors [![awcodes](https://avatars.githubusercontent.com/u/3596800?v=4)](https://github.com/awcodes "awcodes (23 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (12 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (6 commits)")[![eduardonwa](https://avatars.githubusercontent.com/u/40727355?v=4)](https://github.com/eduardonwa "eduardonwa (1 commits)")[![inerba](https://avatars.githubusercontent.com/u/5882517?v=4)](https://github.com/inerba "inerba (1 commits)")[![PrashantDhungana](https://avatars.githubusercontent.com/u/29656761?v=4)](https://github.com/PrashantDhungana "PrashantDhungana (1 commits)") --- Tags filamentfilament-pluginpluginlaravelfilamentawcodesmatinee ### Code Quality TestsPest Static AnalysisRector Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/awcodes-matinee/health.svg) ``` [![Health](https://phpackages.com/badges/awcodes-matinee/health.svg)](https://phpackages.com/packages/awcodes-matinee) ``` ### Alternatives [awcodes/filament-table-repeater A modified version of the Filament Forms Repeater to display it as a table. 262815.1k5](/packages/awcodes-filament-table-repeater)[awcodes/filament-badgeable-column Filament Tables column to append and prepend badges. 142419.3k3](/packages/awcodes-filament-badgeable-column)[codewithdennis/filament-select-tree The multi-level select field enables you to make single selections from a predefined list of options that are organized into multiple levels or depths. 320392.1k17](/packages/codewithdennis-filament-select-tree)[pboivin/filament-peek Full-screen page preview modal for Filament 253319.6k12](/packages/pboivin-filament-peek)[awcodes/filament-curator A media picker plugin for FilamentPHP. 434297.7k19](/packages/awcodes-filament-curator)[awcodes/light-switch Plugin to add theme switching (light/dark/system) to the auth pages for Filament Panels 4789.9k2](/packages/awcodes-light-switch) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)