<img src="https://raw.githubusercontent.com/asbplayer/asbplayer/main/extension/public/icon/icon128.png" width="75" height="75" style="border-radius: 16px" alt="asbplayer" />

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
• Word styling (color/underline/outline, etc.) based on a word's status (uncollected/unknown/learning, etc.) synced from Anki, WaniKani, and/or tracked locally in asbplayer.
• Reading annotation for reading displayed above each word or based on status.
• Accent annotation such as pitch accent.
• Frequency annotation for rank-based frequency displayed below each word or based on status.
• Statistics and Comprehension on your known words for the current media.
• Word browser to manage local and view words synced from external sources.
• Many more features for future releases! Some planned features include:
  • Auto pause, Condensed playback, and Auto mining on uncollected/unknown/learning words.
  • Statistics and Comprehension on your known words across media.

Thanks

Thank you to everyone who has sponsored the project:

@vivekchoksi, @nzarbayezid, @ManuJapan, AdamM, realgoodsmiley, Alex, @m4eko, Simon, Attenius, medyas, @zaerald, Suna, @tony7253, @voothi, kibo, @genericdave, Daniel, Cristian, Joey Potter, @InteractiveNinja, @agloo, @Venous771, @Viterkim, Julian, DanglingSabSuu, @nikkovc, @ganqqwerty, @mathiaslovnes, @MF-Billings, @festivity9139, Phos, AstralDice, @east825, @Astr0ddity, @NirDafnai, @henryfl, トム, Peter, @825i, ags, Vannde3, Champ, marcman3001, @vladysor

and to those who have donated privately.

Thank you to all those who have contributed to asbplayer:

@Renji-XD, @MatiasIslaA, @cyphar, @alexbofa, @Zyphdoz, @artjomsR, @iam6lake, @bpwhelan, @pooky-programs, @m-edlund, @nekorushi, @Viterkim, @s-cork, @shekhirin, @ShanaryS, @kayden1940, @eltociear, @MarvNC, @mcgrizzz, @mwojick, @kowasaur, @NirDafnai, @miroshQa, @RicBent, @fuyuka1d3su, @SpazzTL, @mseh1128, @LuqueDaniel, @agloo, @Bennycopter, @extremq, @iamllama, @danthemango, @L-M-Sherlock, @Hit2Skill, @khajiitvaper2017, @saifkaral, @xwxb, @yqmmm, @jprostko, @rodrigo-suarezmajor, @Roka20012, @RonzyOnGIT, @Dr-TNineS, @thntx

Thank you to all those who have translated asbplayer:

Mana Tsutsumi (Japanese, initial translation), Kai Böse (German), Triline, @nekorushi (Polish), NeverWinterSwor (Simplified Chinese), @AkihaZhang (Simlified Chinese), Yagxter, @chatterine (Brazilian Portuguese), Leo Gonzalez (Spanish), @NovaKing007 (Spanish), Yuri (@ganqqwerty) (Russian), Kellen (kputuhuk) (Russian), Vladislav Kochetkov (vakochetkov) (Russian), @825i (Finnish), @Jaybird1291 (French), Tigerbabe aka Gyaru Jinsei Juku (Korean), yaacha (Indonesian), @NeriSal (Italian)

If you are a non-English native, and would like to help translate asbplayer, join the Crowdin project. If your language isn't there, feel free to create an issue to add it on the issues page.

Contributing

Before contributing, please read the contribution guidelines.

User guide

asbplayer's complete user guide is here.

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 (see supported languages) and VocabSieve (tuned for European languages. Works with Asian languages too but doesn't automatically detect word boundaries).
2. Install Anki, and create a deck and note type. More details on Refold's guide.
3. Install the AnkiConnect plugin for Anki.
4. Configure 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, 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.

   You may have to adjust the subtitle offset 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. Join the Discord 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-<version>-firefox.zip
yarn workspace @project/extension run wxt zip -b firefox

# Builds Firefox for Android extension to extension/.output/asbplayer-<version>-firefox-android.zip
yarn workspace @project/extension run wxt zip -b firefox-android --mv2