https://github.com/asbplayer/asbplayer
Browser-based media player and Chrome extension for subtitle sentence mining
https://github.com/asbplayer/asbplayer
anki-flashcards language-learning
Last synced: about 2 months ago
JSON representation
Browser-based media player and Chrome extension for subtitle sentence mining
- Host: GitHub
- URL: https://github.com/asbplayer/asbplayer
- Owner: asbplayer
- License: mit
- Created: 2020-11-21T04:24:02.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2026-05-04T04:56:13.000Z (about 2 months ago)
- Last Synced: 2026-05-04T06:37:39.482Z (about 2 months ago)
- Topics: anki-flashcards, language-learning
- Language: TypeScript
- Homepage: https://app.asbplayer.dev
- Size: 80.7 MB
- Stars: 1,223
- Watchers: 14
- Forks: 174
- Open Issues: 220
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://github.com/asbplayer/asbplayer/actions/workflows/verify.yml)
[](https://github.com/asbplayer/asbplayer/releases)
[](https://github.com/asbplayer/asbplayer?tab=MIT-1-ov-file)
[](https://discord.gg/ad7VAQru7m)
# asbplayer
**asbplayer** is a browser-based media player and Chrome extension developed for language learners who learn their target language through subtitled media. With asbplayer, you can:
- **Easily create high-quality, multimedia flashcards** out of subtitled videos.
- **Load text-selectable subtitles onto most video sources**, including streaming sources. You can use **auto-detected subtitles** on popular streaming services like Netflix and YouTube, or your own **subtitle files**.
- **Seek through subtitles** using a **navigable subtitle list**.
- **Optimize language acquisition** with **playback modes** like:
- **Condensed playback**: Skip unsubtitled sections of video.
- **Fast-forward playback**: Fast-forward through unsubtitled sections of video.
- **Auto-pause**: Automatically pause at the beginning or end of every subtitle.
- **Use customizable keyboard shortcuts** to access most of asbplayer's features.
- **Annotate subtitles** with the help of tools such as [Yomitan](https://yomitan.wiki/)
- **Word styling** (color/underline/outline, etc.) based on a word's status (uncollected/unknown/learning, etc.) synced from Anki and/or tracked locally in asbplayer.
- **Reading annotation** for pronunciation displayed above each word or based on status.
- **Frequency annotation** for rank-based frequency displayed below each word or based on status.
- Many more features for future releases! Some planned features include:
- **Statistics and Comprehension** on your known words for the current video and across videos.
- **Word browser** to manage local and Anki-synced words.
- **Auto pause**, **Condensed playback**, and **Auto mining** on uncollected/unknown/learning words.
- **Accent annotation** such as pitch accent, tones, gender, etc.
## Thanks
Thank you to everyone who has sponsored the project:
[@vivekchoksi](https://www.github.com/vivekchoksi),
[@nzarbayezid](https://www.github.com/nzarbayezid),
[@ManuJapan](https://www.github.com/ManuJapan),
AdamM,
realgoodsmiley,
Alex,
[@m4eko](https://github.com/m4eko),
Simon,
Attenius,
medyas,
[@zaerald](https://github.com/zaerald),
Suna,
[@tony7253](https://github.com/tony7253),
[@voothi](https://github.com/voothi),
kibo,
[@genericdave](https://github.com/genericdave),
Daniel,
Cristian,
Joey Potter,
[@InteractiveNinja](https://github.com/InteractiveNinja),
[@agloo](https://github.com/agloo),
[@Venous771](https://github.com/Venous771),
[@Viterkim](https://github.com/Viterkim),
Julian,
DanglingSabSuu,
[@nikkovc](https://github.com/nikkovc),
[@ganqqwerty](https://github.com/ganqqwerty),
[@mathiaslovnes](https://github.com/mathiaslovnes),
[@MF-Billings](https://github.com/MF-Billings),
[@festivity9139](https://github.com/festivity9139),
Phos,
AstralDice,
[@east825](https://github.com/east825),
[@Astr0ddity](https://github.com/Astr0ddity),
[@NirDafnai](https://github.com/NirDafnai),
[@henryfl](https://github.com/henryfl),
トム,
Peter,
[@825i](https://github.com/825i),
ags,
Vannde3,
Champ,
marcman3001,
[@vladysor](https://github.com/vladysor)
and to those who have donated privately.
Thank you to all those who have contributed to asbplayer:
[@Renji-XD](https://www.github.com/Renji-XD),
[@MatiasIslaA](https://www.github.com/MatiasIslaA),
[@cyphar](https://www.github.com/cyphar),
[@alexbofa](https://www.github.com/alexbofa),
[@Zyphdoz](https://github.com/Zyphdoz),
[@artjomsR](https://github.com/artjomsR),
[@iam6lake](https://github.com/iam6lake),
[@bpwhelan](https://github.com/bpwhelan),
[@pooky-programs](https://github.com/pooky-programs),
[@m-edlund](https://github.com/m-edlund),
[@nekorushi](https://github.com/nekorushi),
[@Viterkim](https://github.com/Viterkim),
[@s-cork](https://github.com/s-cork),
[@shekhirin](https://github.com/shekhirin),
[@ShanaryS](https://github.com/ShanaryS),
[@kayden1940](https://github.com/kayden1940),
[@eltociear](https://github.com/eltociear),
[@MarvNC](https://github.com/MarvNC),
[@mcgrizzz](https://github.com/mcgrizzz),
[@mwojick](https://github.com/mwojick),
[@kowasaur](https://github.com/kowasaur),
[@NirDafnai](https://github.com/NirDafnai),
[@miroshQa](https://github.com/miroshQa),
[@RicBent](https://github.com/RicBent),
[@fuyuka1d3su](https://github.com/fuyuka1d3su),
[@SpazzTL](https://github.com/SpazzTL),
[@mseh1128](https://github.com/mseh1128),
[@LuqueDaniel](https://github.com/LuqueDaniel),
[@agloo](https://github.com/agloo),
[@Bennycopter](https://github.com/Bennycopter),
[@extremq](https://github.com/extremq),
[@iamllama](https://github.com/iamllama),
[@danthemango](https://github.com/danthemango),
[@L-M-Sherlock](https://github.com/L-M-Sherlock),
[@Hit2Skill](https://github.com/Hit2Skill),
[@khajiitvaper2017](https://github.com/khajiitvaper2017),
[@saifkaral](https://github.com/saifkaral),
[@xwxb](https://github.com/xwxb),
[@yqmmm](https://github.com/yqmmm),
[@jprostko](https://github.com/jprostko)
Thank you to all those who have translated asbplayer:
**Mana Tsutsumi** (Japanese, initial translation),
**Kai Böse** (German),
**Triline**, **[@nekorushi](https://github.com/nekorushi)** (Polish),
**NeverWinterSwor** (Simplified Chinese),
**[@AkihaZhang](https://github.com/AkihaZhang)** (Simlified Chinese),
**Yagxter**, **[@chatterine](https://github.com/chatterine)** (Brazilian Portuguese),
**Leo Gonzalez** (Spanish),
**[@NovaKing007](https://github.com/NovaKing007)** (Spanish),
**Yuri ([@ganqqwerty](https://github.com/ganqqwerty))** (Russian),
**Kellen (kputuhuk)** (Russian),
**Vladislav Kochetkov (vakochetkov)** (Russian),
**[@825i](https://github.com/825i)** (Finnish),
**[@Jaybird1291](https://github.com/jaybird1291)** (French),
**Tigerbabe aka Gyaru Jinsei Juku** (Korean),
**yaacha** (Indonesian)
If you are a non-English native, and would like to help translate asbplayer, join the [Crowdin project](https://crowdin.com/project/asbplayer). If your language isn't there, feel free to create an issue to add it on the [issues page](https://github.com/asbplayer/asbplayer/issues).
## Contributing
Before contributing, please read the [contribution guidelines](https://github.com/asbplayer/asbplayer/blob/main/CONTRIBUTING.md).
## User guide
asbplayer's complete user guide is [here](https://docs.asbplayer.dev/docs/intro).
## Getting Started
> [!NOTE]
> asbplayer is both a subtitle control and flashcard creation tool. If you are not interested in flashcards, and only want to use asbplayer's subtitle features, just follow step 5.
1. Install and set up a dictionary tool for your target language that allows you to do instant lookups. Popular ones are [Yomitan](https://chromewebstore.google.com/detail/yomitan/likgccmbimhjbgkjambclfkhldnlhbnn) (see [supported languages](https://yomitan.wiki/other/supported-languages/)) and [VocabSieve](https://github.com/FreeLanguageTools/vocabsieve) (tuned for European languages. Works with Asian languages too but doesn't automatically detect word boundaries).
2. Install [Anki](https://apps.ankiweb.net/), and create a deck and note type. More details on [Refold's guide](https://refold.la/roadmap/stage-1/a/anki-setup).
3. Install the [AnkiConnect](https://ankiweb.net/shared/info/2055492159) plugin for Anki.
4. [Configure](https://app.asbplayer.dev/?view=settings) asbplayer to create cards via AnkiConnect using your deck and note type.
5. Enhance a video using asbplayer and subtitle files.
- **For streaming video:** After installing the [browser extension](https://github.com/asbplayer/asbplayer/releases/latest), drag-and-drop a subtitle file into the streaming video you want to mine.
- **For local files:** Drag-and-drop media/subtitle files into the [asbplayer website](https://app.asbplayer.dev).
You may have to [adjust the subtitle offset](https://docs.asbplayer.dev/docs/guides/subtitle-timing) to get the subtitles in sync.
6. When a subtitle appears that you want to mine, use Ctrl + Shift + X to open the flashcard creator.
7. Fill in the definition and word fields and then export the card. To fill in the definition field you may use the dictionary you installed in step 1.
## Contact
Submit bugs or feature requests from the [issues page](https://github.com/asbplayer/asbplayer/issues). Join the [Discord](https://discord.gg/ad7VAQru7m) server to talk with me and other language learners.
## Notes for AMO source code reviewers
### Environment
```
node 22.17.1
yarn 3.2.0
```
### Building
```
# Install dependencies
yarn
# Builds Firefox extension to extension/.output/asbplayer--firefox.zip
yarn workspace @project/extension run wxt zip -b firefox
# Builds Firefox for Android extension to extension/.output/asbplayer--firefox-android.zip
yarn workspace @project/extension run wxt zip -b firefox-android --mv2
```