{"id":32477030,"url":"https://github.com/cap-go/capacitor-media-session","last_synced_at":"2026-04-08T14:05:38.129Z","repository":{"id":318729270,"uuid":"1073118546","full_name":"Cap-go/capacitor-media-session","owner":"Cap-go","description":"Capacitor plugin to expose media session controls of the device","archived":false,"fork":false,"pushed_at":"2026-04-06T11:35:19.000Z","size":734,"stargazers_count":5,"open_issues_count":2,"forks_count":3,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-06T13:24:34.055Z","etag":null,"topics":["capacitor","capacitor-plugin"],"latest_commit_sha":null,"homepage":"https://capgo.app","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Cap-go.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null},"funding":{"github":"Cap-go","patreon":null,"open_collective":"capgo","ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2025-10-09T16:37:21.000Z","updated_at":"2026-04-06T11:34:39.000Z","dependencies_parsed_at":"2025-10-13T11:11:54.167Z","dependency_job_id":"c6d86d10-884c-44af-89db-6637ad22c809","html_url":"https://github.com/Cap-go/capacitor-media-session","commit_stats":null,"previous_names":["cap-go/capacitor-media-session"],"tags_count":42,"template":false,"template_full_name":null,"purl":"pkg:github/Cap-go/capacitor-media-session","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cap-go%2Fcapacitor-media-session","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cap-go%2Fcapacitor-media-session/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cap-go%2Fcapacitor-media-session/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cap-go%2Fcapacitor-media-session/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cap-go","download_url":"https://codeload.github.com/Cap-go/capacitor-media-session/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cap-go%2Fcapacitor-media-session/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31558408,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-08T10:21:54.569Z","status":"ssl_error","status_checked_at":"2026-04-08T10:21:38.171Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["capacitor","capacitor-plugin"],"created_at":"2025-10-26T22:49:19.059Z","updated_at":"2026-04-08T14:05:38.112Z","avatar_url":"https://github.com/Cap-go.png","language":"Java","funding_links":["https://github.com/sponsors/Cap-go","https://opencollective.com/capgo"],"categories":[],"sub_categories":[],"readme":"# @capgo/capacitor-media-session\n \u003ca href=\"https://capgo.app/\"\u003e\u003cimg src='https://raw.githubusercontent.com/Cap-go/capgo/main/assets/capgo_banner.png' alt='Capgo - Instant updates for capacitor'/\u003e\u003c/a\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003ch2\u003e\u003ca href=\"https://capgo.app/?ref=plugin_media_session\"\u003e ➡️ Get Instant updates for your App with Capgo\u003c/a\u003e\u003c/h2\u003e\n  \u003ch2\u003e\u003ca href=\"https://capgo.app/consulting/?ref=plugin_media_session\"\u003e Missing a feature? We’ll build the plugin for you 💪\u003c/a\u003e\u003c/h2\u003e\n\u003c/div\u003e\nExpose media session controls for Capacitor apps\n\n## Documentation\n\nThe most complete doc is available here: https://capgo.app/docs/plugins/media-session/\n\n## Compatibility\n\n| Plugin version | Capacitor compatibility | Maintained |\n| -------------- | ----------------------- | ---------- |\n| v8.\\*.\\*       | v8.\\*.\\*                | ✅          |\n| v7.\\*.\\*       | v7.\\*.\\*                | On demand   |\n| v6.\\*.\\*       | v6.\\*.\\*                | ❌          |\n| v5.\\*.\\*       | v5.\\*.\\*                | ❌          |\n\n\u003e **Note:** The major version of this plugin follows the major version of Capacitor. Use the version that matches your Capacitor installation (e.g., plugin v8 for Capacitor 8). Only the latest major version is actively maintained.\n\n## Install\n\n```bash\nnpm install @capgo/capacitor-media-session\nnpx cap sync\n```\n\n## API\n\n\u003cdocgen-index\u003e\n\n* [`setMetadata(...)`](#setmetadata)\n* [`setPlaybackState(...)`](#setplaybackstate)\n* [`setActionHandler(...)`](#setactionhandler)\n* [`setPositionState(...)`](#setpositionstate)\n* [`getPluginVersion()`](#getpluginversion)\n* [Interfaces](#interfaces)\n* [Type Aliases](#type-aliases)\n\n\u003c/docgen-index\u003e\n\n\u003cdocgen-api\u003e\n\u003c!--Update the source file JSDoc comments and rerun docgen to update the docs below--\u003e\n\n### setMetadata(...)\n\n```typescript\nsetMetadata(options: MetadataOptions) =\u003e Promise\u003cvoid\u003e\n```\n\nSets metadata of the currently playing media.\n\n| Param         | Type                                                        |\n| ------------- | ----------------------------------------------------------- |\n| **`options`** | \u003ccode\u003e\u003ca href=\"#metadataoptions\"\u003eMetadataOptions\u003c/a\u003e\u003c/code\u003e |\n\n--------------------\n\n\n### setPlaybackState(...)\n\n```typescript\nsetPlaybackState(options: PlaybackStateOptions) =\u003e Promise\u003cvoid\u003e\n```\n\nUpdates the playback state of the media session.\n\n| Param         | Type                                                                  |\n| ------------- | --------------------------------------------------------------------- |\n| **`options`** | \u003ccode\u003e\u003ca href=\"#playbackstateoptions\"\u003ePlaybackStateOptions\u003c/a\u003e\u003c/code\u003e |\n\n--------------------\n\n\n### setActionHandler(...)\n\n```typescript\nsetActionHandler(options: ActionHandlerOptions, handler: ActionHandler | null) =\u003e Promise\u003cvoid\u003e\n```\n\nRegisters a handler for a media session action.\n\n| Param         | Type                                                                  |\n| ------------- | --------------------------------------------------------------------- |\n| **`options`** | \u003ccode\u003e\u003ca href=\"#actionhandleroptions\"\u003eActionHandlerOptions\u003c/a\u003e\u003c/code\u003e |\n| **`handler`** | \u003ccode\u003e\u003ca href=\"#actionhandler\"\u003eActionHandler\u003c/a\u003e \\| null\u003c/code\u003e       |\n\n--------------------\n\n\n### setPositionState(...)\n\n```typescript\nsetPositionState(options: PositionStateOptions) =\u003e Promise\u003cvoid\u003e\n```\n\nUpdates position state for the active media session.\n\n| Param         | Type                                                                  |\n| ------------- | --------------------------------------------------------------------- |\n| **`options`** | \u003ccode\u003e\u003ca href=\"#positionstateoptions\"\u003ePositionStateOptions\u003c/a\u003e\u003c/code\u003e |\n\n--------------------\n\n\n### getPluginVersion()\n\n```typescript\ngetPluginVersion() =\u003e Promise\u003c{ version: string; }\u003e\n```\n\nGet the native Capacitor plugin version\n\n**Returns:** \u003ccode\u003ePromise\u0026lt;{ version: string; }\u0026gt;\u003c/code\u003e\n\n--------------------\n\n\n### Interfaces\n\n\n#### MetadataOptions\n\n| Prop          | Type                      |\n| ------------- | ------------------------- |\n| **`album`**   | \u003ccode\u003estring\u003c/code\u003e       |\n| **`artist`**  | \u003ccode\u003estring\u003c/code\u003e       |\n| **`artwork`** | \u003ccode\u003eMediaImage[]\u003c/code\u003e |\n| **`title`**   | \u003ccode\u003estring\u003c/code\u003e       |\n\n\n#### MediaImage\n\n| Prop        | Type                |\n| ----------- | ------------------- |\n| **`src`**   | \u003ccode\u003estring\u003c/code\u003e |\n| **`sizes`** | \u003ccode\u003estring\u003c/code\u003e |\n| **`type`**  | \u003ccode\u003estring\u003c/code\u003e |\n\n\n#### PlaybackStateOptions\n\n| Prop                | Type                                                                            |\n| ------------------- | ------------------------------------------------------------------------------- |\n| **`playbackState`** | \u003ccode\u003e\u003ca href=\"#mediasessionplaybackstate\"\u003eMediaSessionPlaybackState\u003c/a\u003e\u003c/code\u003e |\n\n\n#### ActionHandlerOptions\n\n| Prop         | Type                                                              |\n| ------------ | ----------------------------------------------------------------- |\n| **`action`** | \u003ccode\u003e\u003ca href=\"#mediasessionaction\"\u003eMediaSessionAction\u003c/a\u003e\u003c/code\u003e |\n\n\n#### ActionDetails\n\n| Prop           | Type                                                              |\n| -------------- | ----------------------------------------------------------------- |\n| **`action`**   | \u003ccode\u003e\u003ca href=\"#mediasessionaction\"\u003eMediaSessionAction\u003c/a\u003e\u003c/code\u003e |\n| **`seekTime`** | \u003ccode\u003enumber \\| null\u003c/code\u003e                                       |\n\n\n#### PositionStateOptions\n\n| Prop               | Type                |\n| ------------------ | ------------------- |\n| **`duration`**     | \u003ccode\u003enumber\u003c/code\u003e |\n| **`playbackRate`** | \u003ccode\u003enumber\u003c/code\u003e |\n| **`position`**     | \u003ccode\u003enumber\u003c/code\u003e |\n\n\n### Type Aliases\n\n\n#### MediaSessionPlaybackState\n\n\u003ccode\u003e'none' | 'paused' | 'playing'\u003c/code\u003e\n\n\n#### MediaSessionAction\n\n\u003ccode\u003e'play' | 'pause' | 'seekbackward' | 'seekforward' | 'previoustrack' | 'nexttrack' | 'seekto' | 'stop'\u003c/code\u003e\n\n\n#### ActionHandler\n\n\u003ccode\u003e(details: \u003ca href=\"#actiondetails\"\u003eActionDetails\u003c/a\u003e): void\u003c/code\u003e\n\n\u003c/docgen-api\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcap-go%2Fcapacitor-media-session","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcap-go%2Fcapacitor-media-session","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcap-go%2Fcapacitor-media-session/lists"}