PHPackages                             jamband/ripple - 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. jamband/ripple

ActiveLibrary

jamband/ripple
==============

Get a track/album information from the URL.

v0.18.0(5mo ago)104.2k↑116.7%1MITPHPPHP ^8.2CI passing

Since Sep 12Pushed 2mo ago3 watchersCompare

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

READMEChangelogDependencies (3)Versions (41)Used By (0)

ripple
======

[](#ripple)

[![Build Status](https://github.com/jamband/ripple/workflows/ci/badge.svg)](https://github.com/jamband/ripple/actions?workflow=ci) [![Latest Stable Version](https://camo.githubusercontent.com/5bc7b58e2594550c254b046d2187c2da18c51fe94751b5e46edb8b1a35f2cfda/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a616d62616e642f726970706c65)](https://packagist.org/packages/jamband/ripple) [![Total Downloads](https://camo.githubusercontent.com/291ae7178e1e7cc9b71dd8ce24254d4bcc6ef92c173e0bec57f7473f315f0450/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a616d62616e642f726970706c65)](https://packagist.org/packages/jamband/ripple)

Get a track/album information from the URL.

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

[](#requirements)

PHP 8.2 or later

Installation
------------

[](#installation)

```
composer require jamband/ripple

```

Usage
-----

[](#usage)

```
// basic
$ripple = new Jamband\Ripple\Ripple();
$ripple->request('https://example.bandcamp.com/track/title');
$ripple->provider(); // Bandcamp
$ripple->url(); // https://example.bandcamp.com/track/title
$ripple->id(); // 123
$ripple->title(); // Title, by Artist
$ripple->image(); // https://img.example.com/img/123.jpg
```

```
// embed
$ripple = new Jamband\Ripple\Ripple();
$ripple->options(['embed' => ['Bandcamp' => 'size=large/']]);
$ripple->request('https://example.bandcamp.com/track/title');
$embed = $ripple->embed(); // https://bandcamp.com/EmbeddedPlayer/track=123/size=large/
?>