Skip to main content

Settings

Anki

AnkiConnect URL

URL to the AnkiConnect server running as on addon inside Anki.

Deck

Anki deck where cards are sent.

Note Type

Anki note type to use for cards. A note type defines a "model" and a "view" for the cards. More specifically, a set of card fields, and an HTML template that determines how to render those fields on the card's front and back.

Card Fields

Each card field setting determines what content gets mapped to which field of the configured note type. The field label - Sentence, Definition, Word, Image, Audio, or URL - is the content - and the field value is the field inside the note type.

Fields will appear in the Anki Export Dialog in the order that they appear in the settings. The order can be changed using the ⋮ menuMove Down or Move Up.

FieldContent
Sentence (all tracks)All subtitles at the mined timestamp
DefinitionThe user-provided word definition
WordThe user-provided word
AudioAudio recorded from video source
ImageScreenshot of video source
SourceSubtitle file or video name and timestamp
URLCurrent URL if card was mined from streaming video
Subtitle Track 1Subtitles from track 1 at the mined timestamp
Subtitle Track 2Subtitles from track 2 at the mined timestamp
Subtitle Track 3Subtitles from track 3 at the mined timestamp
Custom FieldsUser-provided values

Tags

Default tags to supply with each card.

Mining

Mining button default action

"Mining button" refers to the leftmost button that appears in the Overlay UI, and the button that appears next to subtitles in the Subtitle List. This setting configures what those buttons do.

SettingBehavior
Show Anki dialogRecord target subtitle in mining history and show Anki Export Dialog
Update last cardRecord target subtitle in mining history and update the last card in the configured deck with all asbplayer-provided context - all fields except the user-provided definition, word, and custom fields
Export cardRecord target subtitle in mining history and export a card only with asbplayer-provided context - all fields except the user-provided definition, word, and custom fields
NoneRecord target subtitle in mining history

Post-mining playback state

Configures the desired playback state after triggering a mining action.

Play audio while recording from local video

asbplayer uses the browser's built-in MediaRecorder API to record audio from local video files. This setting configures whether sound should play during recording.

Re-encode audio as mp3

Recorded audio is not encoded as an mp3 by default. This setting will cause audio to be re-encoded as an mp3. In general there's no reason to turn this setting off, especially for users who want to review their cards on iOS.

Copy mined subtitles to clipboard

If enabled, copies the target subtitle to clipboard anytime mining action is triggered.

Audio padding start

How many milliseconds before the target subtitle to start recording audio.

Audio padding end

How many milliseconds after the target subtitle to stop recording audio.

Max image width/height

Max width/height in pixels of screenshots. 0 means "no limit."

Surrounding subtitles count radius

At the bottom of Anki Export Dialog there's a slider which can be used to adjust the selected time interval. The slider includes surrounding subtitles as additional context. This setting controls limits the number of those surrounding subtitles.

Surrounding subtitles time radius

At the bottom of Anki Export Dialog there's a slider which can be used to adjust the selected time interval. The slider includes surrounding subtitles as additional context. This setting controls the size of the allowed time interval around the target subtitle, for those surrounding subtitles.

Subtitle appearance

Subtitle track

asbplayer can load multiple subtitle tracks simultaneously. This dropdown selects the track(s) to which the settings below will apply. The default selection is "All." Modifying any appearance setting with "All" selected, modifies that setting for all tracks simultaneously. When you configure a track-specific value for a setting, that setting disappears from the "All" page.

SettingDescriptionCSS property
Subtitle colorColorcolor
Subtitle sizeSize in pxfont-size
Subtitle outline color/thicknessColor/thickness of stroke-webkit-text-stroke
Subtitle shadow color/thicknessColor/thickness of shadowtext-shadow
Subtitle background color/opacityBackground color/opacitybackground
Subtitle font familyFont. A dropdown of available fonts appears when local font access is granted.font-family
Subtitle blurApplies a blur effect to subtitles. Unblurs on hover.filter:blur(...)
CSS:<style key>String value of any custom CSS property added using the Add Custom CSS dropdown.Custom property
Subtitle widthWidth of subtitle container as percentage of video element width.width

Subtitle alignment

Whether to place subtitles at the top or bottom of the video element.

Subtitle position offset from top

Distance from the top of the video element of all top subtitle tracks.

Subtitle position offset from bottom

Distance from the bottom of the video element of all bottom subtitle tracks.

Image-based subtitle scale factor

Scales the size of image-based subtitles. Image-based subtitles are ripped from BluRay discs and come in files with a .sup extension.

Keyboard shortcuts

Keyboard shortcuts can be used to access most of asbplayer's features.

BehaviorWebsite shortcut?Extension shortcut?
Mine current subtitle
Mine current subtitle and open Anki dialog
Update last-created Anki card with asbplayer-captured screenshot, audio, etc.
Export card to Anki, bypassing dialog.
Manually take screenshot, overriding the one that is automatically taken when mining
Manually start/stop audio recording, even when a subtitle file is loaded.
Select subtitle tracks to load.
Play/pause
Toggle auto-pause
Toggle condensed playback
Toggle fast forward playback
Toggle repeat mode
Toggle subtitles
Toggle subtitle track 1 in video
Toggle subtitle track 2 in video
Toggle subtitle track 3 in video
Toggle subtitle track 1 in asbplayer
Toggle subtitle track 2 in asbplayer
Toggle subtitle track 3 in asbplayer
Unblur subtitle track 1 in asbplayer
Unblur subtitle track 2 in asbplayer
Unblur subtitle track 3 in asbplayer
Seek backward 10 seconds
Seek forward 10 seconds
Seek to previous subtitle
Seek to next subtitle
Seek to beginning of current/previous subtitle
Adjust subtitle offset so that previous subtitle is at current timestamp
Adjust subtitle offset so that next subtitle is at current timestamp
Adjust subtitle offset by +100ms
Adjust subtitle offset by -100ms
Reset subtitle offset
Increase playback rate
Decrease playback rate
Toggle side panel

Extension shortcuts

Some shortcut behaviors require privileged browser extension APIs, requiring the extension to implement the shortcut as a browser command rather than using vanilla key event listeners. Furthermore, when the browser extension is installed, settings are shared between the extension and the website, and so even on the website, some keyboard shortcuts are marked as "extension shortcuts." These shortcuts can only be edited in the browser's extension shortcuts editor.

  • Chrome: chrome://extensions/shortcuts
  • Firefox: about:addonsManage Extension Shortcuts

Streaming video (extension only)

Streaming video settings are available only when the browser extension is installed.

When loading subtitles, also open subtitle list via the app in a separate tab

Anytime subtitles are loaded into a video element, opens the website, and syncs the loaded subtitles with the website in a separate tab.

Enable controls overlay

Display the overlay UI on video elements with loaded subtitles.

Display subtitles

Display loaded subtitles on video elements.

Record audio when mining

When mining a subtitle, record the audio covered by the subtitle for inclusion in the flashcard.

Take screenshot when mining

When mining a subtitle, take a screenshot for inclusion in the flashcrd.

Clean screenshot when mining

When mining a subtitle and screenshots are enabled, keep the screenshot "clean" by removing any HTML elements on top of the video element before taking the screenshot.

Screenshot capture delay

How long to wait after the target subtitle appears before taking the screenshot.

Allow subtitle file drag-and-drop

Allow subtitle files to be drag-and-dropped into video elements.

Auto-load detected subtitles

If subtitle auto-detection is supported on the current website, load them automatically. If multiple tracks are detected, load the track for the preferred language. The preferred language is the one that was last loaded with the "remember these track choices" box checked.

Condensed playback minimum skip interval

When condensed playback is enabled, skip to the next subtitle only if the next subtitle is at least this amount of time away.

App URL

Determines where the extension fetches some configuration, and what URL to open when syncing subtitles to the website running in a separate tab. Essentially the website URL.

Misc

Theme

Display all asbplayer in a light or dark theme.

Remember subtitle offset

When enabled, timing offset is "sticky." Subtitles are loaded with the last-used offset.

Auto-copy current subtitle to clipboard

Automatically copies subtitle to clipboard when it appears on screen. Useful for sending subtitles to apps that can monitor the clipboard.

Always play after invoking 'Seek to beginning of current/previous subtitle'

Instead of retaining the current playback state, always play when using the keyboard shortcut that seeks to the beginning of the current/previous subtitle. Saves a keypress.

Mining history storage limit

Limits the number of cards that can be saved in the mining history.

Subtitle regex filter

Substrings matched by this regex will be replaced by the value of Subtitle regex filter text replacement

Subtitle regex filter text replacement

Substrings matched by the regex above are replaced with the value of this setting. If left empty, matched substrings are simply removed.

Subtitle HTML

How to handle HTML that appears in subtitle files.

Language

Language to display UI in.

Note: not all strings have been localized in every language that asbplayer supports. Unlocalized will be displayed in English. Feel free to help out with localization at the Crowdin project.

Auto-pause preference

When auto-pause is enabled, whether to auto-pause at the start or end of subtitles.

Auto-pause when mousing over subtitles

Auto-pause behavior when mousing over subtitles. "Enabled with auto-resume" means that playback will automatically resume when mousing off of subtitles.

Playback speed adjust step

Time increment to use when using the "increase/decrease playback rate" keyboard shortcuts.

Fast-forward mode playback rate

How fast to fast-forward when fast-forward mode is enabled.

Enable WebSocket client

Enables the WebSocket client. Allows asbplayer to be controlled using the WebSocket interface.

WebSocket Server URL

The URL of the WebSocket server to connect to when enabling the WebSocket client. Usually this would be a locally-running instance of the pre-packaged WebSocket server.

Import/export settings

Imports or exports settings as a json file. Settings files exported from older versions of asbplayer are not guaranteed to be importable into newer versions of asbplayer.

Profiles

A settings profile is a completely different set of settings values. The active settings profile can be changed from the settings UI or from the Load Subtitles and Anki Export dialogs.