Watch
1
0
Fork
You've already forked asbplayer-fork
0
forked from keir/asbplayer
Mirror of git@github.com:asbplayer/asbplayer.git (auto-pull every 8h)
  • TypeScript 98.3%
  • Go 0.5%
  • JavaScript 0.3%
  • CSS 0.3%
  • Shell 0.3%
  • Other 0.3%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-18 12:11:44 -07:00
.github Link docs sidebar Contributing straight to CONTRIBUTING.md and drop the duplicate page (#1354) 2026-10-18 12:11:44 -07:00
client Bump loc (#1343) 2026-10-14 07:15:22 +09:00
common Fix for app-bar-sized gap showing at bottom of refreshed PWA (#1344) 2026-10-14 08:44:44 +09:00
docs Link docs sidebar Contributing straight to CONTRIBUTING.md and drop the duplicate page (#1354) 2026-10-18 12:11:44 -07:00
extension Speculative fix for controls showing at bottom of PWA when it's refreshed (#1341) 2026-10-14 07:05:55 +09:00
loc Add option to trim black bars from screenshots (#1197) 2026-09-30 00:41:49 -04:00
patches Dev/migrate to pnpm (#1167) 2026-09-26 02:15:06 -07:00
plugins/anki rename anki plugin to addon and clean addon readme (#1349) 2026-10-14 20:59:14 -07:00
scripts Link docs sidebar Contributing straight to CONTRIBUTING.md and drop the duplicate page (#1354) 2026-10-18 12:11:44 -07:00
.envrc dev: add nix flake and python tooling 2026-08-29 22:00:33 -07:00
.gitattributes Initial attempt at agentic workflow 2026-08-27 01:01:23 +09:00
.gitignore Dev/migrate to pnpm (#1167) 2026-09-26 02:15:06 -07:00
.nvmrc Dev/migrate to pnpm (#1167) 2026-09-26 02:15:06 -07:00
.prettierignore WXT Migration (#707) 2025-05-24 17:48:12 -07:00
.prettierrc.json Vite migration (#650) 2025-02-09 05:17:20 -08:00
CONTRIBUTING.md Update contribution guidelines (#1347) 2026-10-15 08:45:35 +09:00
CONTRIBUTORS feat(jimaku): add custom regex for episode detection 2026-10-11 15:39:15 +09:00
eslint.config.js Better logging and type imports (#1121) 2026-08-18 21:38:31 -04:00
flake.lock Dev/migrate to pnpm (#1167) 2026-09-26 02:15:06 -07:00
flake.nix rename anki plugin to addon and clean addon readme (#1349) 2026-10-14 20:59:14 -07:00
LICENSE LICENSE 2026-09-23 15:45:12 -04:00
package.json Discord blog notifications include full content (#1310) 2026-10-05 16:09:16 +09:00
pnpm-lock.yaml Add log viewer and log exports (#1265) 2026-09-30 03:36:26 -04:00
pnpm-workspace.yaml Dev/migrate to pnpm (#1167) 2026-09-26 02:15:06 -07:00
README.md Update docs (#1309) 2026-10-04 20:58:39 -04:00

asbplayer

GitHub Workflow Status (with event) Github All Releases GitHub License Discord

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. A generic fallback subtitle detection algorithm allows asbplayer to detect subtitles on 85% of all other streaming services.
  • 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.
    • Repeat: Automatically repeat subtitles indefinitely or for a specified number of times.
  • 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.
    • Glossary annotation for a short definition or explanation of the word.
    • 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:
      • Adaptive Playback that uses playback modes and the annotation data to optimize your learning experience.
      • Auto mining on uncollected/unknown/learning words.
      • Rich Anki Card Creation for generating high-quality flashcards from annotated subtitles.
      • 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, @Otto-Deviant1904, @Ayase-the-Dark, shiki, kansha-gratitude

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, @Otto-Deviant1904, @Ayase-the-Dark, @aramrw, @steckums, @eXaminator, @rajpiskala, @gpressutto5, @chadzimmerman

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 (Simplified Chinese), senorli (Simplified 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 such as Yomitan.

  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 24.21.0 pnpm 11.27.0

Building

# Install dependencies
pnpm install

# Builds Firefox extension to extension/.output/asbplayer-<version>-firefox.zip
pnpm --filter @project/extension run wxt zip -b firefox

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

License

asbplayer is licensed under the GNU Affero General Public License version 3 or later (AGPL-3.0-or-later). Portions of this software are licensed under the MIT License.