{"id":15282493,"url":"https://github.com/jamband/ripple","last_synced_at":"2025-04-12T23:04:38.616Z","repository":{"id":56996106,"uuid":"42361178","full_name":"jamband/ripple","owner":"jamband","description":"Get a track/album information from the URL","archived":false,"fork":false,"pushed_at":"2024-04-20T05:43:56.000Z","size":371,"stargazers_count":8,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-04-20T06:35:02.984Z","etag":null,"topics":["bandcamp","music","oembed","php","soundcloud","vimeo","youtube"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jamband.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-09-12T15:08:38.000Z","updated_at":"2024-06-08T10:38:32.865Z","dependencies_parsed_at":"2023-10-04T22:47:07.053Z","dependency_job_id":"570e82f6-d535-437c-aa8b-e6a3d960a843","html_url":"https://github.com/jamband/ripple","commit_stats":{"total_commits":186,"total_committers":1,"mean_commits":186.0,"dds":0.0,"last_synced_commit":"4fc9317b3bdba207a39303e63d112a0d8e9f5a11"},"previous_names":[],"tags_count":38,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamband%2Fripple","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamband%2Fripple/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamband%2Fripple/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamband%2Fripple/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jamband","download_url":"https://codeload.github.com/jamband/ripple/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239992854,"owners_count":19730774,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bandcamp","music","oembed","php","soundcloud","vimeo","youtube"],"created_at":"2024-09-30T14:26:29.646Z","updated_at":"2025-02-22T09:31:21.236Z","avatar_url":"https://github.com/jamband.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ripple\n\n[![Build Status](https://github.com/jamband/ripple/workflows/ci/badge.svg)](https://github.com/jamband/ripple/actions?workflow=ci) [![Latest Stable Version](https://img.shields.io/packagist/v/jamband/ripple)](https://packagist.org/packages/jamband/ripple) [![Total Downloads](https://img.shields.io/packagist/dt/jamband/ripple)](https://packagist.org/packages/jamband/ripple)\n\nGet a track/album information from the URL.\n\n## Requirements\n\nPHP 8.1 or later\n\n## Installation\n\n```\ncomposer require jamband/ripple\n```\n\n## Usage\n\n```php\n// basic\n$ripple = new Jamband\\Ripple\\Ripple();\n$ripple-\u003erequest('https://example.bandcamp.com/track/title');\n$ripple-\u003eprovider(); // Bandcamp\n$ripple-\u003eurl(); // https://example.bandcamp.com/track/title\n$ripple-\u003eid(); // 123\n$ripple-\u003etitle(); // Title, by Artist\n$ripple-\u003eimage(); // https://img.example.com/img/123.jpg\n```\n\n```php\n// embed\n$ripple = new Jamband\\Ripple\\Ripple();\n$ripple-\u003eoptions(['embed' =\u003e ['Bandcamp' =\u003e 'size=large/']]);\n$ripple-\u003erequest('https://example.bandcamp.com/track/title');\n$embed = $ripple-\u003eembed(); // https://bandcamp.com/EmbeddedPlayer/track=123/size=large/\n?\u003e\n\u003ciframe width=\"300\" height=\"300\" src=\"\u003c?= $embed ?\u003e\" allow=\"fullscreen\"\u003e\u003c/iframe\u003e\n```\n\n```php\n// custom curl options\n$ripple = new Jamband\\Ripple\\Ripple();\n$ripple-\u003eoptions(['curl' =\u003e [\n    // CURLOPT_TIMEOUT =\u003e 8,\n    // CURLOPT_USERAGENT =\u003e '...',\n    // ...\n]]);\n$ripple-\u003erequest('https://example.bandcamp.com/track/title');\n```\n\n```php\n// mock response\n$ripple = new Jamband\\Ripple\\Ripple();\n$ripple-\u003eoptions(['response' =\u003e '...']);\n$ripple-\u003erequest('https://example.bandcamp.com/track/title');\n```\n\n## Valid URLs\n\n```\nBandcamp:\nhttps://{subdomain}.bandcamp.com/track/{title}\nhttps://{subdomain}.bandcamp.com/album/{title}\nhttps://{subdomain}.bandcamp.com/releases\nhttps?://{domain}/track/{title}\nhttps?://{domain}/album/{title}\nhttps?://{domain}/releases\n\nSoundCloud:\nhttps://soundcloud.com/{account}/{title}\nhttps://soundcloud.com/{account}/sets/{title}\n\nVimeo:\nhttps://vimeo.com/{id}\n\nYouTube:\nhttps://www.youtube.com/watch?v={id}\nhttps://www.youtube.com/playlist?list={id}\nhttps://youtu.be/{id}\n```\n\n## Supported Providers\n\n- Bandcamp\n- SoundCloud\n- Vimeo\n- YouTube\n\n## License\nRipple is licensed under the MIT license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamband%2Fripple","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjamband%2Fripple","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamband%2Fripple/lists"}