{"id":13583489,"url":"https://github.com/mikesteele/dual-captions","last_synced_at":"2025-04-06T21:32:12.355Z","repository":{"id":28442012,"uuid":"96346388","full_name":"mikesteele/dual-captions","owner":"mikesteele","description":"🌐 Subtitles in two languages for YouTube \u0026 Netflix ","archived":true,"fork":false,"pushed_at":"2022-12-01T22:14:37.000Z","size":84254,"stargazers_count":231,"open_issues_count":83,"forks_count":40,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-08-02T15:53:28.138Z","etag":null,"topics":["chrome-extension","kanopy","netflix","youtube"],"latest_commit_sha":null,"homepage":"https://chrome.google.com/webstore/detail/two-captions-for-youtube/lpeonmjfimoijceaalocpgjjchocbiap/related","language":"JavaScript","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/mikesteele.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"custom":"https://paypal.me/mikesteeledev"}},"created_at":"2017-07-05T17:51:48.000Z","updated_at":"2024-07-06T20:36:27.000Z","dependencies_parsed_at":"2022-08-07T13:15:54.917Z","dependency_job_id":null,"html_url":"https://github.com/mikesteele/dual-captions","commit_stats":null,"previous_names":[],"tags_count":49,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikesteele%2Fdual-captions","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikesteele%2Fdual-captions/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikesteele%2Fdual-captions/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mikesteele%2Fdual-captions/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mikesteele","download_url":"https://codeload.github.com/mikesteele/dual-captions/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223264833,"owners_count":17116219,"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":["chrome-extension","kanopy","netflix","youtube"],"created_at":"2024-08-01T15:03:30.961Z","updated_at":"2024-11-06T00:30:21.656Z","avatar_url":"https://github.com/mikesteele.png","language":"JavaScript","funding_links":["https://paypal.me/mikesteeledev"],"categories":["JavaScript"],"sub_categories":[],"readme":"## This project is now archived (12/1/22)\n\nWhen I created this project, it was just for myself to learn French on YouTube. I never imagined it would reach over 30,000 installs and over 200 stars. Thank you for your support over the years. \n\nI cannot commit to maintaining this project going forward due to other priorities in my personal life. Thank you for understanding. The code will be kept up so that others can create and maintain forks if they choose to.\n\n-- Mike\n\n## dual-captions \u003cbr/\u003e Subtitles in two languages for YouTube, Netflix, Disney+ \u0026 Kanopy\n![build](https://travis-ci.com/mikesteele/dual-captions.svg?branch=master)\n\n### :arrow_down: \u003ca href=\"https://chrome.google.com/webstore/detail/two-captions-for-youtube/lpeonmjfimoijceaalocpgjjchocbiap/related\"\u003eDownload on Chrome Web Store\u003c/a\u003e\n### :closed_book: \u003ca href=\"https://github.com/mikesteele/dual-captions/releases\"\u003eView latest release notes\u003c/a\u003e\n\n\u003cimg src=\"https://raw.githubusercontent.com/mikesteele/dual-captions-gifs/master/screenshot-final.png\" width=\"100%\" /\u003e\n\n***\n\n### How does it work?\n\n#### Site integrations\n\nThis extension works by intercepting caption file requests, parsing them, and rendering them onto the page. \n\nThe extension runs an adapter on the host site repeatedly to get up-to-date information about the state of the host. Adapters are functions that use DOM queries. You can find them in `site_integrations`.\n\nThis extension does **not** use any internal APIs on the host site (eg. `window.netflix.appContext`) and it does not change any of the host sites own code. (eg. manipulating the host site's video player bundle)\n\nWhy not?\n\n* It is fragile to inject code into the host site bundle.\n* It is fragile to rely on internal APIs that may change.\n* Adapters that only rely on DOM selectors allow us to fix host site changes quickly.\n* Tiny adapters allow for many websites to be supported.\n\nThe adapter API is still a work in progress and will be documented in the future. \n\nThis \"hands off\" approach has UX trade-offs, like requiring the user select a language on the host site to have the caption file requested. I believe long-term stability is more important than UX.\n\n#### Saving settings across sessions\n\nSince `browser_action`s cannot persist any data after they are closed, this extension uses Redux middleware to store the user's settings with `chrome.storage` on any change. When the popup is re-opened, the store is re-hydrated with the user's saved store settings, and settings are injected into the `content_script`.\n\n### Manual Installation\n\nBuilding the extension locally requires having Node and Yarn installed. See https://nodejs.org/ and https://yarnpkg.com/ for installation steps.\n\n1. Build the extension\n\n````\nchmod u+x ./build-extension.sh\n./build-extension.sh\n````\n\n2. Load the /build/ directory as an unpacked extension in chrome://extensions\n\nYou'll need to enable Developer Mode in chrome://extensions to do this. See https://developer.chrome.com/extensions/getstarted#unpacked for more information.\n\n### Run Tests\n\n```\ncd browser_action\nyarn test\n\ncd content_script\nyarn test\n\ncd site_integrations\nyarn test\n```\n\n### Thanks\n\n* tamama9527 (https://github.com/tamama9527) for Traditional Chinese translations for the UI\n\n### License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmikesteele%2Fdual-captions","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmikesteele%2Fdual-captions","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmikesteele%2Fdual-captions/lists"}