{"id":35576147,"url":"https://github.com/cap-go/capacitor-video-thumbnails","last_synced_at":"2026-02-20T06:01:26.104Z","repository":{"id":332104938,"uuid":"1127827337","full_name":"Cap-go/capacitor-video-thumbnails","owner":"Cap-go","description":"Generate video thumbnails from local or remote video files - Capacitor plugin","archived":false,"fork":false,"pushed_at":"2026-02-06T05:19:43.000Z","size":180,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-18T19:50:09.320Z","etag":null,"topics":["capacitor","capacitor-plugin"],"latest_commit_sha":null,"homepage":"https://capgo.app","language":"JavaScript","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":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,"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":"2026-01-04T17:09:19.000Z","updated_at":"2026-02-06T05:19:47.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Cap-go/capacitor-video-thumbnails","commit_stats":null,"previous_names":["cap-go/capacitor-video-thumbnails"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/Cap-go/capacitor-video-thumbnails","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cap-go%2Fcapacitor-video-thumbnails","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cap-go%2Fcapacitor-video-thumbnails/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cap-go%2Fcapacitor-video-thumbnails/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cap-go%2Fcapacitor-video-thumbnails/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Cap-go","download_url":"https://codeload.github.com/Cap-go/capacitor-video-thumbnails/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Cap-go%2Fcapacitor-video-thumbnails/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29642905,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-20T05:21:04.652Z","status":"ssl_error","status_checked_at":"2026-02-20T05:21:04.238Z","response_time":59,"last_error":"SSL_read: 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":"2026-01-04T19:18:25.004Z","updated_at":"2026-02-20T06:01:26.084Z","avatar_url":"https://github.com/Cap-go.png","language":"JavaScript","funding_links":["https://github.com/sponsors/Cap-go","https://opencollective.com/capgo"],"categories":[],"sub_categories":[],"readme":"# @capgo/capacitor-video-thumbnails\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_video_thumbnails\"\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_video_thumbnails\"\u003e Missing a feature? We'll build the plugin for you 💪\u003c/a\u003e\u003c/h2\u003e\n\u003c/div\u003e\n\nGenerate video thumbnails from local or remote video files.\n\n## Why Capacitor Video Thumbnails?\n\nExtract thumbnail images from videos at specific time positions:\n\n- **Local \u0026 Remote Videos** - Works with both file:// paths and http(s):// URLs\n- **Custom Time Position** - Extract frame at any millisecond timestamp\n- **Quality Control** - Adjustable JPEG compression quality\n- **HTTP Headers Support** - Custom headers for authenticated video sources\n- **Cross-platform** - Consistent API across iOS, Android, and Web\n\nPerfect for video galleries, media players, video editors, and any app that needs video preview images.\n\n## Documentation\n\nThe most complete doc is available here: https://capgo.app/docs/plugins/video-thumbnails/\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-video-thumbnails\nnpx cap sync\n```\n\n## Requirements\n\n- iOS: iOS 15.0+\n- Android: API 24+ (Android 7.0+)\n- Web: Modern browsers with HTML5 video support\n\n## API\n\n\u003cdocgen-index\u003e\n\n* [`getThumbnail(...)`](#getthumbnail)\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\nCapacitor Video Thumbnails Plugin interface for generating video thumbnails.\n\n### getThumbnail(...)\n\n```typescript\ngetThumbnail(options: VideoThumbnailsOptions) =\u003e Promise\u003cVideoThumbnailsResult\u003e\n```\n\nGenerate a thumbnail image from a video file at a specific time position.\n\n| Param         | Type                                                                      | Description                            |\n| ------------- | ------------------------------------------------------------------------- | -------------------------------------- |\n| **`options`** | \u003ccode\u003e\u003ca href=\"#videothumbnailsoptions\"\u003eVideoThumbnailsOptions\u003c/a\u003e\u003c/code\u003e | - Options for generating the thumbnail |\n\n**Returns:** \u003ccode\u003ePromise\u0026lt;\u003ca href=\"#videothumbnailsresult\"\u003eVideoThumbnailsResult\u003c/a\u003e\u0026gt;\u003c/code\u003e\n\n**Since:** 8.0.0\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**Since:** 8.0.0\n\n--------------------\n\n\n### Interfaces\n\n\n#### VideoThumbnailsResult\n\nResult of thumbnail generation.\n\n| Prop         | Type                | Description                                                                                                     |\n| ------------ | ------------------- | --------------------------------------------------------------------------------------------------------------- |\n| **`uri`**    | \u003ccode\u003estring\u003c/code\u003e | The local URI path to the generated thumbnail image. This can be used directly in img tags or Image components. |\n| **`width`**  | \u003ccode\u003enumber\u003c/code\u003e | Width of the generated thumbnail in pixels.                                                                     |\n| **`height`** | \u003ccode\u003enumber\u003c/code\u003e | Height of the generated thumbnail in pixels.                                                                    |\n\n\n#### VideoThumbnailsOptions\n\nOptions for generating a video thumbnail.\n\n| Prop            | Type                                                            | Description                                                                                                                                                                      |\n| --------------- | --------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| **`sourceUri`** | \u003ccode\u003estring\u003c/code\u003e                                             | The URI of the video file. Can be a local file path or a remote URL. For local files, use file:// protocol or absolute path. For remote files, use http:// or https:// protocol. |\n| **`time`**      | \u003ccode\u003enumber\u003c/code\u003e                                             | The time position in milliseconds from which to extract the thumbnail. Defaults to 0 (first frame).                                                                              |\n| **`quality`**   | \u003ccode\u003enumber\u003c/code\u003e                                             | Quality of the generated image, from 0.0 (lowest) to 1.0 (highest). Defaults to 1.0.                                                                                             |\n| **`headers`**   | \u003ccode\u003e\u003ca href=\"#record\"\u003eRecord\u003c/a\u003e\u0026lt;string, string\u0026gt;\u003c/code\u003e | HTTP headers to include when fetching remote video URIs. Only applicable for remote URLs.                                                                                        |\n\n\n### Type Aliases\n\n\n#### Record\n\nConstruct a type with a set of properties K of type T\n\n\u003ccode\u003e{\r [P in K]: T;\r }\u003c/code\u003e\n\n\u003c/docgen-api\u003e\n\n## Credits\n\nThis was inspired from (Expo SDK)[https://docs.expo.dev/versions/latest/sdk/video-thumbnails/]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcap-go%2Fcapacitor-video-thumbnails","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcap-go%2Fcapacitor-video-thumbnails","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcap-go%2Fcapacitor-video-thumbnails/lists"}