mirror of
https://github.com/ksyasuda/SubMiner.git
synced 2026-05-26 12:55:16 -07:00
sudacode
8de2613e4b
- Known-word cache matches now set isKnown=true even for tokens excluded by POS filters - POS exclusion gate suppresses N+1, frequency, and JLPT only; known status is computed before the gate - Jellyfin subtitle preload continues after cleanup failures instead of aborting - Update config docs and option description to document the known-word bypass behavior
714 lines
45 KiB
JSON
714 lines
45 KiB
JSON
/**
|
|
* SubMiner Example Configuration File
|
|
*
|
|
* This file is auto-generated from src/config/definitions.ts.
|
|
* Copy to %APPDATA%/SubMiner/config.jsonc on Windows, or $XDG_CONFIG_HOME/SubMiner/config.jsonc (or ~/.config/SubMiner/config.jsonc) on Linux/macOS.
|
|
*/
|
|
{
|
|
|
|
// ==========================================
|
|
// Visible Overlay Auto-Start
|
|
// Show the visible subtitle overlay automatically after managed mpv playback starts SubMiner.
|
|
// SubMiner can still auto-start in the background when this is false.
|
|
// ==========================================
|
|
"auto_start_overlay": true, // Show the visible subtitle overlay automatically when the bundled mpv plugin starts SubMiner. Values: true | false
|
|
|
|
// ==========================================
|
|
// Texthooker Server
|
|
// Configure texthooker startup launch and browser opening behavior.
|
|
// ==========================================
|
|
"texthooker": {
|
|
"launchAtStartup": false, // Launch texthooker server automatically when SubMiner starts. Values: true | false
|
|
"openBrowser": false // Open the texthooker page in the default browser when the server starts. Values: true | false
|
|
}, // Configure texthooker startup launch and browser opening behavior.
|
|
|
|
// ==========================================
|
|
// WebSocket Server
|
|
// Built-in WebSocket server broadcasts subtitle text to connected clients.
|
|
// Auto mode disables built-in server if mpv_websocket is detected.
|
|
// ==========================================
|
|
"websocket": {
|
|
"enabled": false, // Built-in subtitle websocket server mode. Values: auto | true | false
|
|
"port": 6677 // Built-in subtitle websocket server port.
|
|
}, // Built-in WebSocket server broadcasts subtitle text to connected clients.
|
|
|
|
// ==========================================
|
|
// Annotation WebSocket
|
|
// Dedicated annotated subtitle websocket for bundled texthooker and token-aware clients.
|
|
// Independent from websocket.auto and defaults to port 6678.
|
|
// ==========================================
|
|
"annotationWebsocket": {
|
|
"enabled": false, // Annotated subtitle websocket server enabled state. Values: true | false
|
|
"port": 6678 // Annotated subtitle websocket server port.
|
|
}, // Dedicated annotated subtitle websocket for bundled texthooker and token-aware clients.
|
|
|
|
// ==========================================
|
|
// Logging
|
|
// Controls logging verbosity.
|
|
// Set to debug for full runtime diagnostics.
|
|
// Hot-reload: logging.level applies live while SubMiner is running.
|
|
// ==========================================
|
|
"logging": {
|
|
"level": "info" // Minimum log level for runtime logging. Values: debug | info | warn | error
|
|
}, // Controls logging verbosity.
|
|
|
|
// ==========================================
|
|
// Controller Support
|
|
// Gamepad support for the visible overlay while keyboard-only mode is active.
|
|
// Use Alt+C to pick a preferred controller and remap actions inline with learn mode.
|
|
// Trigger input mode can be auto, digital-only, or analog-thresholded depending on the controller.
|
|
// Override controller.buttonIndices when your pad reports non-standard raw button numbers.
|
|
// ==========================================
|
|
"controller": {
|
|
"enabled": false, // Enable overlay controller support through the Chrome Gamepad API. Values: true | false
|
|
"preferredGamepadId": "", // Preferred controller id saved from the controller config modal.
|
|
"preferredGamepadLabel": "", // Preferred controller display label saved for diagnostics.
|
|
"smoothScroll": true, // Use smooth scrolling for controller-driven popup scroll input. Values: true | false
|
|
"scrollPixelsPerSecond": 900, // Base popup scroll speed for controller stick input.
|
|
"horizontalJumpPixels": 160, // Popup page-jump distance for controller jump input.
|
|
"stickDeadzone": 0.2, // Deadzone applied to controller stick axes.
|
|
"triggerInputMode": "auto", // How controller triggers are interpreted: auto, pressed-only, or thresholded analog. Values: auto | digital | analog
|
|
"triggerDeadzone": 0.5, // Minimum analog trigger value required when trigger input uses auto or analog mode.
|
|
"repeatDelayMs": 320, // Delay before repeating held controller actions.
|
|
"repeatIntervalMs": 120, // Repeat interval for held controller actions.
|
|
"buttonIndices": {
|
|
"select": 6, // Raw button index used for the controller select/minus/back button.
|
|
"buttonSouth": 0, // Raw button index used for controller south/A button input.
|
|
"buttonEast": 1, // Raw button index used for controller east/B button input.
|
|
"buttonWest": 2, // Raw button index used for controller west/X button input.
|
|
"buttonNorth": 3, // Raw button index used for controller north/Y button input.
|
|
"leftShoulder": 4, // Raw button index used for controller left shoulder input.
|
|
"rightShoulder": 5, // Raw button index used for controller right shoulder input.
|
|
"leftStickPress": 9, // Raw button index used for controller L3 input.
|
|
"rightStickPress": 10, // Raw button index used for controller R3 input.
|
|
"leftTrigger": 6, // Raw button index used for controller L2 input.
|
|
"rightTrigger": 7 // Raw button index used for controller R2 input.
|
|
}, // Semantic button-name reference mapping used for legacy configs and debug output. Updating it does not rewrite existing raw binding descriptors.
|
|
"bindings": {
|
|
"toggleLookup": {
|
|
"kind": "button", // Discrete binding input source kind. When kind is "axis", set both axisIndex and direction. Values: none | button | axis
|
|
"buttonIndex": 0 // Raw button index captured for this discrete controller action.
|
|
}, // Controller binding descriptor for toggling lookup. Use Alt+C learn mode or set a raw button/axis descriptor manually. If kind is "axis", direction is required.
|
|
"closeLookup": {
|
|
"kind": "button", // Discrete binding input source kind. When kind is "axis", set both axisIndex and direction. Values: none | button | axis
|
|
"buttonIndex": 1 // Raw button index captured for this discrete controller action.
|
|
}, // Controller binding descriptor for closing lookup. Use Alt+C learn mode or set a raw button/axis descriptor manually. If kind is "axis", direction is required.
|
|
"toggleKeyboardOnlyMode": {
|
|
"kind": "button", // Discrete binding input source kind. When kind is "axis", set both axisIndex and direction. Values: none | button | axis
|
|
"buttonIndex": 3 // Raw button index captured for this discrete controller action.
|
|
}, // Controller binding descriptor for toggling keyboard-only mode. Use Alt+C learn mode or set a raw button/axis descriptor manually. If kind is "axis", direction is required.
|
|
"mineCard": {
|
|
"kind": "button", // Discrete binding input source kind. When kind is "axis", set both axisIndex and direction. Values: none | button | axis
|
|
"buttonIndex": 2 // Raw button index captured for this discrete controller action.
|
|
}, // Controller binding descriptor for mining the active card. Use Alt+C learn mode or set a raw button/axis descriptor manually. If kind is "axis", direction is required.
|
|
"quitMpv": {
|
|
"kind": "button", // Discrete binding input source kind. When kind is "axis", set both axisIndex and direction. Values: none | button | axis
|
|
"buttonIndex": 6 // Raw button index captured for this discrete controller action.
|
|
}, // Controller binding descriptor for quitting mpv. Use Alt+C learn mode or set a raw button/axis descriptor manually. If kind is "axis", direction is required.
|
|
"previousAudio": {
|
|
"kind": "none" // Discrete binding input source kind. When kind is "axis", set both axisIndex and direction. Values: none | button | axis
|
|
}, // Controller binding descriptor for previous Yomitan audio. Use Alt+C learn mode or set a raw button/axis descriptor manually. If kind is "axis", direction is required.
|
|
"nextAudio": {
|
|
"kind": "button", // Discrete binding input source kind. When kind is "axis", set both axisIndex and direction. Values: none | button | axis
|
|
"buttonIndex": 5 // Raw button index captured for this discrete controller action.
|
|
}, // Controller binding descriptor for next Yomitan audio. Use Alt+C learn mode or set a raw button/axis descriptor manually. If kind is "axis", direction is required.
|
|
"playCurrentAudio": {
|
|
"kind": "button", // Discrete binding input source kind. When kind is "axis", set both axisIndex and direction. Values: none | button | axis
|
|
"buttonIndex": 4 // Raw button index captured for this discrete controller action.
|
|
}, // Controller binding descriptor for playing the current Yomitan audio. Use Alt+C learn mode or set a raw button/axis descriptor manually. If kind is "axis", direction is required.
|
|
"toggleMpvPause": {
|
|
"kind": "button", // Discrete binding input source kind. When kind is "axis", set both axisIndex and direction. Values: none | button | axis
|
|
"buttonIndex": 9 // Raw button index captured for this discrete controller action.
|
|
}, // Controller binding descriptor for toggling mpv play/pause. Use Alt+C learn mode or set a raw button/axis descriptor manually. If kind is "axis", direction is required.
|
|
"leftStickHorizontal": {
|
|
"kind": "axis", // Analog binding input source kind. Values: none | axis
|
|
"axisIndex": 0, // Raw axis index captured for this analog controller action.
|
|
"dpadFallback": "horizontal" // Optional D-pad fallback used when this analog controller action should also read D-pad input. Values: none | horizontal | vertical
|
|
}, // Axis binding descriptor used for left/right token selection. Use Alt+C learn mode or set a raw axis descriptor manually.
|
|
"leftStickVertical": {
|
|
"kind": "axis", // Analog binding input source kind. Values: none | axis
|
|
"axisIndex": 1, // Raw axis index captured for this analog controller action.
|
|
"dpadFallback": "vertical" // Optional D-pad fallback used when this analog controller action should also read D-pad input. Values: none | horizontal | vertical
|
|
}, // Axis binding descriptor used for primary popup scrolling. Use Alt+C learn mode or set a raw axis descriptor manually.
|
|
"rightStickHorizontal": {
|
|
"kind": "axis", // Analog binding input source kind. Values: none | axis
|
|
"axisIndex": 3, // Raw axis index captured for this analog controller action.
|
|
"dpadFallback": "none" // Optional D-pad fallback used when this analog controller action should also read D-pad input. Values: none | horizontal | vertical
|
|
}, // Axis binding descriptor reserved for alternate right-stick mappings. Use Alt+C learn mode or set a raw axis descriptor manually.
|
|
"rightStickVertical": {
|
|
"kind": "axis", // Analog binding input source kind. Values: none | axis
|
|
"axisIndex": 4, // Raw axis index captured for this analog controller action.
|
|
"dpadFallback": "none" // Optional D-pad fallback used when this analog controller action should also read D-pad input. Values: none | horizontal | vertical
|
|
} // Axis binding descriptor used for popup page jumps. Use Alt+C learn mode or set a raw axis descriptor manually.
|
|
}, // Raw controller binding descriptors saved by Alt+C learn mode. For discrete axis bindings, kind "axis" requires axisIndex and direction.
|
|
"profiles": {} // Per-controller binding and button-index overrides keyed by the controller id reported by the Gamepad API.
|
|
}, // Gamepad support for the visible overlay while keyboard-only mode is active.
|
|
|
|
// ==========================================
|
|
// Startup Warmups
|
|
// Background warmup controls for MeCab, Yomitan, dictionaries, and Jellyfin session.
|
|
// Disable individual warmups to defer load until first real usage.
|
|
// lowPowerMode defers all warmups except Yomitan extension.
|
|
// ==========================================
|
|
"startupWarmups": {
|
|
"lowPowerMode": false, // Defer startup warmups except Yomitan extension. Values: true | false
|
|
"mecab": true, // Warm up MeCab tokenizer at startup. Values: true | false
|
|
"yomitanExtension": true, // Warm up Yomitan extension at startup. Values: true | false
|
|
"subtitleDictionaries": true, // Warm up subtitle dictionaries at startup. Values: true | false
|
|
"jellyfinRemoteSession": false // Warm up Jellyfin remote session at startup. Values: true | false
|
|
}, // Background warmup controls for MeCab, Yomitan, dictionaries, and Jellyfin session.
|
|
|
|
// ==========================================
|
|
// Updates
|
|
// Automatic update check behavior.
|
|
// Manual checks from the tray or launcher are always allowed.
|
|
// ==========================================
|
|
"updates": {
|
|
"enabled": true, // Run automatic update checks in the background. Values: true | false
|
|
"checkIntervalHours": 24, // Minimum hours between automatic update checks.
|
|
"notificationType": "system", // How SubMiner announces available updates. Values: system | osd | both | none
|
|
"channel": "stable" // Release channel used for update checks. Values: stable | prerelease
|
|
}, // Automatic update check behavior.
|
|
|
|
// ==========================================
|
|
// Keyboard Shortcuts
|
|
// Overlay keyboard shortcuts. Set a shortcut to null to disable.
|
|
// Hot-reload: shortcut changes apply live and update the session help modal on reopen.
|
|
// ==========================================
|
|
"shortcuts": {
|
|
"toggleVisibleOverlayGlobal": "Alt+Shift+O", // Global accelerator that toggles overlay visibility from anywhere on the system. Use null to disable.
|
|
"copySubtitle": "CommandOrControl+C", // Accelerator that copies the current subtitle line to the clipboard.
|
|
"copySubtitleMultiple": "CommandOrControl+Shift+C", // Accelerator that copies consecutive subtitle lines while the multi-copy window stays open.
|
|
"updateLastCardFromClipboard": "CommandOrControl+V", // Accelerator that updates the last mined Anki card using the current clipboard contents.
|
|
"triggerFieldGrouping": "CommandOrControl+G", // Accelerator that triggers Kiku field grouping on duplicate cards.
|
|
"triggerSubsync": "Ctrl+Alt+S", // Accelerator that triggers subsync against the active subtitle file.
|
|
"mineSentence": "CommandOrControl+S", // Accelerator that mines the current sentence as a new Anki card.
|
|
"mineSentenceMultiple": "CommandOrControl+Shift+S", // Accelerator that mines consecutive sentences while the multi-mine window stays open.
|
|
"multiCopyTimeoutMs": 3000, // Timeout for multi-copy/mine modes.
|
|
"toggleSecondarySub": "CommandOrControl+Shift+V", // Accelerator that toggles the secondary subtitle bar visibility.
|
|
"markAudioCard": "CommandOrControl+Shift+A", // Accelerator that marks the last mined card as an audio card.
|
|
"openCharacterDictionary": "CommandOrControl+Alt+A", // Accelerator that opens the character dictionary modal.
|
|
"openRuntimeOptions": "CommandOrControl+Shift+O", // Accelerator that opens the runtime options modal.
|
|
"openJimaku": "Ctrl+Shift+J", // Accelerator that opens the Jimaku subtitle search modal.
|
|
"openSessionHelp": "CommandOrControl+Slash", // Accelerator that opens the session help / keybinding cheatsheet.
|
|
"openControllerSelect": "Alt+C", // Accelerator that opens the controller selection and learn-mode modal.
|
|
"openControllerDebug": "Alt+Shift+C", // Accelerator that opens the controller debug modal with live axis/button readouts.
|
|
"toggleSubtitleSidebar": "Backslash" // Accelerator that toggles the subtitle sidebar visibility.
|
|
}, // Overlay keyboard shortcuts. Set a shortcut to null to disable.
|
|
|
|
// ==========================================
|
|
// Keybindings (MPV Commands)
|
|
// Default and custom keybindings that are merged with built-in defaults.
|
|
// Set command to null to disable a default keybinding.
|
|
// Hot-reload: keybinding changes apply live and update the session help modal on reopen.
|
|
// ==========================================
|
|
"keybindings": [
|
|
{
|
|
"key": "Space", // Key setting.
|
|
"command": [
|
|
"cycle",
|
|
"pause"
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "KeyF", // Key setting.
|
|
"command": [
|
|
"cycle",
|
|
"fullscreen"
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "KeyJ", // Key setting.
|
|
"command": [
|
|
"cycle",
|
|
"sid"
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "Shift+KeyJ", // Key setting.
|
|
"command": [
|
|
"cycle",
|
|
"secondary-sid"
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "ArrowRight", // Key setting.
|
|
"command": [
|
|
"seek",
|
|
5
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "ArrowLeft", // Key setting.
|
|
"command": [
|
|
"seek",
|
|
-5
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "ArrowUp", // Key setting.
|
|
"command": [
|
|
"seek",
|
|
60
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "ArrowDown", // Key setting.
|
|
"command": [
|
|
"seek",
|
|
-60
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "Shift+KeyH", // Key setting.
|
|
"command": [
|
|
"sub-seek",
|
|
-1
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "Shift+KeyL", // Key setting.
|
|
"command": [
|
|
"sub-seek",
|
|
1
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "Shift+BracketRight", // Key setting.
|
|
"command": [
|
|
"__sub-delay-next-line"
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "Shift+BracketLeft", // Key setting.
|
|
"command": [
|
|
"__sub-delay-prev-line"
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "Ctrl+Alt+KeyC", // Key setting.
|
|
"command": [
|
|
"__youtube-picker-open"
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "Ctrl+Alt+KeyP", // Key setting.
|
|
"command": [
|
|
"__playlist-browser-open"
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "Ctrl+Shift+KeyH", // Key setting.
|
|
"command": [
|
|
"__replay-subtitle"
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "Ctrl+Shift+KeyL", // Key setting.
|
|
"command": [
|
|
"__play-next-subtitle"
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "KeyQ", // Key setting.
|
|
"command": [
|
|
"quit"
|
|
] // Command setting.
|
|
},
|
|
{
|
|
"key": "Ctrl+KeyW", // Key setting.
|
|
"command": [
|
|
"quit"
|
|
] // Command setting.
|
|
}
|
|
], // Default and custom keybindings that are merged with built-in defaults.
|
|
|
|
// ==========================================
|
|
// Secondary Subtitles
|
|
// Dual subtitle track options.
|
|
// Used by managed subtitle loading as secondary language preferences for local and YouTube playback.
|
|
// Hot-reload: defaultMode updates live while SubMiner is running.
|
|
// ==========================================
|
|
"secondarySub": {
|
|
"secondarySubLanguages": [], // Language code priority list used to auto-select a secondary subtitle track when available.
|
|
"autoLoadSecondarySub": false, // Automatically load a matching secondary subtitle when the primary subtitle loads. Values: true | false
|
|
"defaultMode": "hover" // Default visibility mode for the secondary subtitle bar. Values: hidden | visible | hover
|
|
}, // Dual subtitle track options.
|
|
|
|
// ==========================================
|
|
// Subtitle Sync
|
|
// Subsync engine and executable paths.
|
|
// Hot-reload: subsync changes apply to the next subtitle sync run.
|
|
// ==========================================
|
|
"subsync": {
|
|
"alass_path": "", // Optional absolute path to the alass binary used by subsync. Leave empty to auto-discover from PATH.
|
|
"ffsubsync_path": "", // Optional absolute path to the ffsubsync binary used by subsync. Leave empty to auto-discover from PATH.
|
|
"ffmpeg_path": "", // Optional absolute path to the ffmpeg binary used by subsync. Leave empty to auto-discover from PATH.
|
|
"replace": true // Replace the active subtitle file when sync completes. Values: true | false
|
|
}, // Subsync engine and executable paths.
|
|
|
|
// ==========================================
|
|
// Subtitle Position
|
|
// Initial vertical subtitle position from the bottom.
|
|
// ==========================================
|
|
"subtitlePosition": {
|
|
"yPercent": 10 // Vertical position of the subtitle overlay expressed as a percentage from the bottom of the screen.
|
|
}, // Initial vertical subtitle position from the bottom.
|
|
|
|
// ==========================================
|
|
// Subtitle Appearance
|
|
// Primary and secondary subtitle styling.
|
|
// Hot-reload: subtitle style changes apply live without restarting SubMiner.
|
|
// ==========================================
|
|
"subtitleStyle": {
|
|
"primaryDefaultMode": "visible", // Default primary subtitle bar visibility mode. hidden hides it, visible shows it, hover reveals it on hover. Values: hidden | visible | hover
|
|
"css": {
|
|
"font-family": "Hiragino Sans, M PLUS 1, Source Han Sans JP, Noto Sans CJK JP", // Font family setting.
|
|
"color": "#cad3f5", // Color setting.
|
|
"background-color": "transparent", // Background color setting.
|
|
"font-size": "35px", // Font size setting.
|
|
"font-weight": "600", // Font weight setting.
|
|
"font-style": "normal", // Font style setting.
|
|
"line-height": "1.35", // Line height setting.
|
|
"letter-spacing": "-0.01em", // Letter spacing setting.
|
|
"word-spacing": "0", // Word spacing setting.
|
|
"font-kerning": "normal", // Font kerning setting.
|
|
"text-rendering": "geometricPrecision", // Text rendering setting.
|
|
"text-shadow": "0 2px 6px rgba(0,0,0,0.9), 0 0 12px rgba(0,0,0,0.55)", // Text shadow setting.
|
|
"backdrop-filter": "blur(6px)", // Backdrop filter setting.
|
|
"--subtitle-hover-token-color": "#f4dbd6", // Subtitle hover token color setting.
|
|
"--subtitle-hover-token-background-color": "transparent" // Subtitle hover token background color setting.
|
|
}, // CSS declaration object applied to primary subtitles after normal subtitle style defaults.
|
|
"enableJlpt": false, // Enable JLPT vocabulary level underlines. When disabled, JLPT tagging lookup and underlines are skipped. Values: true | false
|
|
"preserveLineBreaks": false, // Preserve line breaks in visible overlay subtitle rendering. When false, line breaks are flattened to spaces for a single-line flow. Values: true | false
|
|
"autoPauseVideoOnHover": true, // Automatically pause mpv playback while hovering subtitle text, then resume on leave. Values: true | false
|
|
"autoPauseVideoOnYomitanPopup": true, // Automatically pause mpv playback while Yomitan popup is open, then resume when popup closes. Values: true | false
|
|
"nameMatchEnabled": false, // Enable subtitle token coloring for matches from the SubMiner character dictionary. Values: true | false
|
|
"nameMatchColor": "#f5bde6", // Hex color used when a subtitle token matches an entry from the SubMiner character dictionary.
|
|
"nPlusOneColor": "#c6a0f6", // Color used for the single N+1 target token subtitle highlight.
|
|
"knownWordColor": "#a6da95", // Color used for known-word subtitle highlights.
|
|
"jlptColors": {
|
|
"N1": "#ed8796", // N1 setting.
|
|
"N2": "#f5a97f", // N2 setting.
|
|
"N3": "#f9e2af", // N3 setting.
|
|
"N4": "#8bd5ca", // N4 setting.
|
|
"N5": "#8aadf4" // N5 setting.
|
|
}, // Jlpt colors setting.
|
|
"frequencyDictionary": {
|
|
"enabled": false, // Enable frequency-dictionary-based highlighting based on token rank. Values: true | false
|
|
"sourcePath": "", // Optional absolute path to a frequency dictionary directory. If empty, built-in discovery search paths are used.
|
|
"topX": 1000, // Only color tokens with frequency rank <= topX (default: 1000).
|
|
"mode": "single", // single: use one color for all matching tokens. banded: use color ramp by frequency band. Values: single | banded
|
|
"matchMode": "headword", // headword: frequency lookup uses dictionary form. surface: lookup uses subtitle-visible token text. Values: headword | surface
|
|
"singleColor": "#f5a97f", // Color used when frequencyDictionary.mode is `single`.
|
|
"bandedColors": [
|
|
"#ed8796",
|
|
"#f5a97f",
|
|
"#f9e2af",
|
|
"#8bd5ca",
|
|
"#8aadf4"
|
|
] // Five colors used for rank bands when mode is `banded` (from most common to least within topX).
|
|
}, // Frequency dictionary setting.
|
|
"secondary": {
|
|
"css": {
|
|
"font-family": "Hiragino Sans, M PLUS 1, Source Han Sans JP, Noto Sans CJK JP", // Font family setting.
|
|
"color": "#cad3f5", // Color setting.
|
|
"background-color": "transparent", // Background color setting.
|
|
"font-size": "24px", // Font size setting.
|
|
"font-weight": "600", // Font weight setting.
|
|
"font-style": "normal", // Font style setting.
|
|
"line-height": "1.35", // Line height setting.
|
|
"letter-spacing": "-0.01em", // Letter spacing setting.
|
|
"word-spacing": "0", // Word spacing setting.
|
|
"font-kerning": "normal", // Font kerning setting.
|
|
"text-rendering": "geometricPrecision", // Text rendering setting.
|
|
"text-shadow": "0 2px 6px rgba(0,0,0,0.9), 0 0 12px rgba(0,0,0,0.55)", // Text shadow setting.
|
|
"backdrop-filter": "blur(6px)" // Backdrop filter setting.
|
|
} // CSS declaration object applied to secondary subtitles after normal subtitle style defaults.
|
|
} // Secondary setting.
|
|
}, // Primary and secondary subtitle styling.
|
|
|
|
// ==========================================
|
|
// Subtitle Sidebar
|
|
// Parsed-subtitle sidebar cue list styling, behavior, and toggle key.
|
|
// Hot-reload: subtitle sidebar changes apply live without restarting SubMiner.
|
|
// ==========================================
|
|
"subtitleSidebar": {
|
|
"enabled": true, // Enable the subtitle sidebar feature for parsed subtitle sources. Values: true | false
|
|
"autoOpen": false, // Automatically open the subtitle sidebar once during overlay startup. Values: true | false
|
|
"layout": "overlay", // Render the subtitle sidebar as a floating overlay or reserve space inside mpv. Values: overlay | embedded
|
|
"toggleKey": "Backslash", // KeyboardEvent.code used to toggle the subtitle sidebar open and closed.
|
|
"pauseVideoOnHover": true, // Pause mpv while hovering the subtitle sidebar, then resume on leave. Values: true | false
|
|
"autoScroll": true, // Auto-scroll the active subtitle cue into view while playback advances. Values: true | false
|
|
"css": {
|
|
"font-family": "Hiragino Sans, M PLUS 1, Source Han Sans JP, Noto Sans CJK JP", // Font family setting.
|
|
"color": "#cad3f5", // Color setting.
|
|
"background-color": "rgba(73, 77, 100, 0.9)", // Background color setting.
|
|
"font-size": "16px", // Font size setting.
|
|
"opacity": "0.95", // Opacity setting.
|
|
"--subtitle-sidebar-max-width": "420px", // Subtitle sidebar max width setting.
|
|
"--subtitle-sidebar-timestamp-color": "#a5adcb", // Subtitle sidebar timestamp color setting.
|
|
"--subtitle-sidebar-active-line-color": "#f5bde6", // Subtitle sidebar active line color setting.
|
|
"--subtitle-sidebar-active-background-color": "rgba(138, 173, 244, 0.22)", // Subtitle sidebar active background color setting.
|
|
"--subtitle-sidebar-hover-background-color": "rgba(54, 58, 79, 0.84)" // Subtitle sidebar hover background color setting.
|
|
} // CSS declaration object applied to the subtitle sidebar. Includes color, background-color, and all font properties.
|
|
}, // Parsed-subtitle sidebar cue list styling, behavior, and toggle key.
|
|
|
|
// ==========================================
|
|
// Shared AI Provider
|
|
// Canonical OpenAI-compatible provider transport settings shared by Anki and YouTube subtitle fixing.
|
|
// ==========================================
|
|
"ai": {
|
|
"enabled": false, // Enable shared OpenAI-compatible AI provider features. Values: true | false
|
|
"apiKey": "", // Static API key for the shared OpenAI-compatible AI provider.
|
|
"apiKeyCommand": "", // Shell command used to resolve the shared AI provider API key.
|
|
"model": "openai/gpt-4o-mini", // Default model identifier requested from the shared AI provider.
|
|
"baseUrl": "https://openrouter.ai/api", // Base URL for the shared OpenAI-compatible AI provider.
|
|
"systemPrompt": "You are a translation engine. Return only the translated text with no explanations.", // Default system prompt sent with shared AI provider requests.
|
|
"requestTimeoutMs": 15000 // Timeout in milliseconds for shared AI provider requests.
|
|
}, // Canonical OpenAI-compatible provider transport settings shared by Anki and YouTube subtitle fixing.
|
|
|
|
// ==========================================
|
|
// AnkiConnect Integration
|
|
// Automatic Anki updates and media generation options.
|
|
// Hot-reload: ankiConnect.ai.enabled, knownWords, nPlusOne, fields.word/audio/image/sentence/miscInfo, behavior.autoUpdateNewCards, isLapis.sentenceCardModel, and isKiku.fieldGrouping update live while SubMiner is running.
|
|
// Shared AI provider transport settings are read from top-level ai and typically require restart.
|
|
// Most other AnkiConnect settings still require restart.
|
|
// ==========================================
|
|
"ankiConnect": {
|
|
"enabled": true, // Enable AnkiConnect integration. Values: true | false
|
|
"url": "http://127.0.0.1:8765", // Base URL of the AnkiConnect HTTP server.
|
|
"pollingRate": 3000, // Polling interval in milliseconds.
|
|
"proxy": {
|
|
"enabled": true, // Enable local AnkiConnect-compatible proxy for push-based auto-enrichment. Values: true | false
|
|
"host": "127.0.0.1", // Bind host for local AnkiConnect proxy.
|
|
"port": 8766, // Bind port for local AnkiConnect proxy.
|
|
"upstreamUrl": "http://127.0.0.1:8765" // Upstream AnkiConnect URL proxied by local AnkiConnect proxy.
|
|
}, // Proxy setting.
|
|
"tags": [
|
|
"SubMiner"
|
|
], // Tags to add to cards mined or updated by SubMiner. Provide an empty array to disable automatic tagging.
|
|
"fields": {
|
|
"word": "Expression", // Card field for the mined word or expression text.
|
|
"audio": "ExpressionAudio", // Card field that receives generated sentence audio.
|
|
"image": "Picture", // Card field that receives the captured screenshot or animated image.
|
|
"sentence": "Sentence", // Card field that receives the source sentence text.
|
|
"miscInfo": "MiscInfo", // Card field that receives the miscellaneous info pattern (see ankiConnect.metadata.pattern).
|
|
"translation": "SelectionText" // Card field that receives the current selection or translated text.
|
|
}, // Fields setting.
|
|
"ai": {
|
|
"enabled": false, // Enable AI provider usage for Anki translation/enrichment flows. Values: true | false
|
|
"model": "", // Optional model override for Anki AI translation/enrichment flows.
|
|
"systemPrompt": "" // Optional system prompt override for Anki AI translation/enrichment flows.
|
|
}, // Ai setting.
|
|
"media": {
|
|
"generateAudio": true, // Generate sentence audio for mined cards. Values: true | false
|
|
"generateImage": true, // Generate screenshot or animated image for mined cards. Values: true | false
|
|
"imageType": "static", // Image capture type: "static" for a single still frame, "avif" for an animated AVIF. Values: static | avif
|
|
"imageFormat": "jpg", // Encoding format used when imageType is "static". Values: jpg | png | webp
|
|
"imageQuality": 92, // Quality (0-100) used for lossy static image encoders.
|
|
"animatedFps": 10, // Target frame rate for animated AVIF captures.
|
|
"animatedMaxWidth": 640, // Maximum width applied to animated AVIF captures.
|
|
"animatedCrf": 35, // Animated AVIF CRF quality target. Lower values produce larger, higher-quality files.
|
|
"syncAnimatedImageToWordAudio": true, // For animated AVIF images, prepend a frozen first frame matching the existing word-audio duration so motion starts with sentence audio. Values: true | false
|
|
"audioPadding": 0.5, // Seconds of padding appended to both ends of generated sentence audio.
|
|
"fallbackDuration": 3, // Fallback clip duration in seconds when subtitle timing data is unavailable.
|
|
"maxMediaDuration": 30 // Maximum allowed media clip duration in seconds.
|
|
}, // Media setting.
|
|
"knownWords": {
|
|
"highlightEnabled": false, // Enable fast local highlighting for words already known in Anki. Values: true | false
|
|
"refreshMinutes": 1440, // Minutes between known-word cache refreshes.
|
|
"addMinedWordsImmediately": true, // Immediately append newly mined card words into the known-word cache. Values: true | false
|
|
"matchMode": "headword", // Known-word matching strategy for subtitle annotations. Cache matches always receive known-word highlighting even when POS filters suppress other annotation types. Values: headword | surface
|
|
"decks": {} // Decks and fields for known-word cache. Object mapping deck names to arrays of field names to extract, e.g. { "Kaishi 1.5k": ["Word", "Word Reading"] }.
|
|
}, // Known words setting.
|
|
"behavior": {
|
|
"overwriteAudio": true, // When updating an existing card, overwrite the audio field instead of skipping it. Values: true | false
|
|
"overwriteImage": true, // When updating an existing card, overwrite the image field instead of skipping it. Values: true | false
|
|
"mediaInsertMode": "append", // Whether new media is appended after or prepended before existing field contents on update. Values: append | prepend
|
|
"highlightWord": true, // Bold the mined word inside the sentence field on the saved Anki card. Values: true | false
|
|
"notificationType": "osd", // Notification surface used to announce mining and update outcomes. Values: osd | system | both | none
|
|
"autoUpdateNewCards": true // Automatically update newly added cards. Values: true | false
|
|
}, // Behavior setting.
|
|
"nPlusOne": {
|
|
"enabled": false, // Enable N+1 subtitle highlighting (highlights the one unknown word in a sentence). Requires known-word cache data. Values: true | false
|
|
"minSentenceWords": 3 // Minimum sentence word count required for N+1 targeting (default: 3).
|
|
}, // N plus one setting.
|
|
"metadata": {
|
|
"pattern": "[SubMiner] %f (%t)" // Template used to render the miscInfo field. Placeholders include %f (filename) and %t (timestamp).
|
|
}, // Metadata setting.
|
|
"isLapis": {
|
|
"enabled": false, // Enable Lapis-specific mining behaviors and sentence card model targeting. Values: true | false
|
|
"sentenceCardModel": "Lapis" // Note type name used by Lapis sentence cards.
|
|
}, // Is lapis setting.
|
|
"isKiku": {
|
|
"enabled": false, // Enable Kiku-specific mining behaviors (duplicate handling, field grouping). Values: true | false
|
|
"fieldGrouping": "disabled", // Kiku duplicate-card field grouping mode. Values: auto | manual | disabled
|
|
"deleteDuplicateInAuto": true // When Kiku field grouping is "auto", delete the duplicate source card after grouping completes. Values: true | false
|
|
} // Is kiku setting.
|
|
}, // Automatic Anki updates and media generation options.
|
|
|
|
// ==========================================
|
|
// Jimaku
|
|
// Jimaku API configuration and defaults.
|
|
// Hot-reload: Jimaku changes apply to the next Jimaku request.
|
|
// ==========================================
|
|
"jimaku": {
|
|
"apiBaseUrl": "https://jimaku.cc", // Base URL of the Jimaku subtitle search API.
|
|
"languagePreference": "ja", // Preferred language used in Jimaku search. Values: ja | en | none
|
|
"maxEntryResults": 10 // Maximum Jimaku search results returned.
|
|
}, // Jimaku API configuration and defaults.
|
|
|
|
// ==========================================
|
|
// YouTube Playback Settings
|
|
// Defaults for managed subtitle language preferences and YouTube subtitle loading.
|
|
// Hot-reload: primarySubLanguages applies to the next YouTube subtitle load.
|
|
// ==========================================
|
|
"youtube": {
|
|
"primarySubLanguages": [
|
|
"ja",
|
|
"jpn"
|
|
] // Comma-separated primary subtitle language priority for managed subtitle auto-selection.
|
|
}, // Defaults for managed subtitle language preferences and YouTube subtitle loading.
|
|
|
|
// ==========================================
|
|
// Anilist
|
|
// Anilist API credentials and update behavior.
|
|
// Includes optional auto-sync for a merged MRU-based character dictionary in bundled Yomitan.
|
|
// Character dictionaries are keyed by AniList media ID (no season/franchise merge).
|
|
// ==========================================
|
|
"anilist": {
|
|
"enabled": false, // Enable AniList post-watch progress updates. Values: true | false
|
|
"accessToken": "", // Optional explicit AniList access token override; leave empty to use locally stored token from setup.
|
|
"characterDictionary": {
|
|
"enabled": false, // Enable automatic Yomitan character dictionary sync for currently watched AniList media. Values: true | false
|
|
"refreshTtlHours": 168, // Legacy setting; merged character dictionary retention is now usage-based and this value is ignored.
|
|
"maxLoaded": 3, // Maximum number of most-recently-used anime snapshots included in the merged Yomitan character dictionary.
|
|
"evictionPolicy": "delete", // Legacy setting; merged character dictionary eviction is usage-based and this value is ignored. Values: disable | delete
|
|
"profileScope": "all", // Yomitan profile scope for dictionary enable/disable updates. Values: all | active
|
|
"collapsibleSections": {
|
|
"description": false, // Open the Description section by default in character dictionary glossary entries. Values: true | false
|
|
"characterInformation": false, // Open the Character Information section by default in character dictionary glossary entries. Values: true | false
|
|
"voicedBy": false // Open the Voiced by section by default in character dictionary glossary entries. Values: true | false
|
|
} // Collapsible sections setting.
|
|
} // Character dictionary setting.
|
|
}, // Anilist API credentials and update behavior.
|
|
|
|
// ==========================================
|
|
// Yomitan
|
|
// Optional external Yomitan profile integration.
|
|
// Setting yomitan.externalProfilePath switches SubMiner to read-only external-profile mode.
|
|
// For GameSentenceMiner on Linux, the default overlay profile is usually ~/.config/gsm_overlay.
|
|
// In external-profile mode SubMiner will not import, delete, or modify Yomitan dictionaries/settings.
|
|
// ==========================================
|
|
"yomitan": {
|
|
"externalProfilePath": "" // Optional external Yomitan Electron profile path to use in read-only mode for shared dictionaries/settings. Example: ~/.config/gsm_overlay
|
|
}, // Optional external Yomitan profile integration.
|
|
|
|
// ==========================================
|
|
// MPV Launcher
|
|
// SubMiner-managed mpv launch and bundled plugin options.
|
|
// Set mpv.socketPath to the IPC socket used by the launcher, Electron app, and bundled plugin.
|
|
// autoStartSubMiner starts SubMiner in the background; auto_start_overlay only controls visible overlay display.
|
|
// Set mpv.launchMode to choose normal, maximized, or fullscreen SubMiner-managed mpv playback.
|
|
// Leave mpv.executablePath blank to auto-discover mpv.exe from SUBMINER_MPV_PATH or PATH.
|
|
// ==========================================
|
|
"mpv": {
|
|
"executablePath": "", // Optional absolute path to mpv.exe for Windows launch flows. Leave empty to auto-discover from SUBMINER_MPV_PATH or PATH.
|
|
"launchMode": "normal", // Default window state for SubMiner-managed mpv launches. Values: normal | maximized | fullscreen
|
|
"socketPath": "/tmp/subminer-socket", // mpv IPC socket path used by SubMiner-managed playback and the bundled mpv plugin.
|
|
"backend": "auto", // Window tracking backend passed to the bundled mpv plugin. Auto detects the current platform. Values: auto | hyprland | sway | x11 | macos | windows
|
|
"autoStartSubMiner": true, // Start SubMiner in the background when SubMiner-managed mpv loads a file. Values: true | false
|
|
"pauseUntilOverlayReady": true, // Pause mpv on visible-overlay auto-start until SubMiner signals subtitle tokenization readiness. Values: true | false
|
|
"subminerBinaryPath": "", // Optional SubMiner app binary path passed to the bundled mpv plugin. Leave empty to use the launcher-detected app path.
|
|
"aniskipEnabled": true, // Enable AniSkip intro detection and skip markers in the bundled mpv plugin. Values: true | false
|
|
"aniskipButtonKey": "TAB" // mpv key used to trigger the AniSkip button while the skip marker is visible.
|
|
}, // SubMiner-managed mpv launch and bundled plugin options.
|
|
|
|
// ==========================================
|
|
// Jellyfin
|
|
// Optional Jellyfin integration for auth, browsing, and playback launch.
|
|
// Access token is stored in local encrypted token storage after login/setup.
|
|
// jellyfin.accessToken remains an optional explicit override in config.
|
|
// ==========================================
|
|
"jellyfin": {
|
|
"enabled": false, // Enable optional Jellyfin integration and CLI control commands. Values: true | false
|
|
"serverUrl": "", // Base Jellyfin server URL (for example: http://localhost:8096).
|
|
"recentServers": [], // Recently authenticated Jellyfin server URLs shown in setup.
|
|
"username": "", // Default Jellyfin username used during CLI login.
|
|
"defaultLibraryId": "", // Optional default Jellyfin library ID for item listing.
|
|
"remoteControlEnabled": true, // Enable Jellyfin remote cast control mode. Values: true | false
|
|
"remoteControlAutoConnect": true, // Auto-connect to the configured remote control target. Values: true | false
|
|
"autoAnnounce": false, // When enabled, automatically trigger remote announce/visibility check on websocket connect. Values: true | false
|
|
"pullPictures": false, // Enable Jellyfin poster/icon fetching for launcher menus. Values: true | false
|
|
"iconCacheDir": "/tmp/subminer-jellyfin-icons", // Directory used by launcher for cached Jellyfin poster icons.
|
|
"directPlayPreferred": true, // Try direct play before server-managed transcoding when possible. Values: true | false
|
|
"directPlayContainers": [
|
|
"mkv",
|
|
"mp4",
|
|
"webm",
|
|
"mov",
|
|
"flac",
|
|
"mp3",
|
|
"aac"
|
|
], // Container allowlist for direct play decisions.
|
|
"transcodeVideoCodec": "h264" // Preferred transcode video codec when direct play is unavailable.
|
|
}, // Optional Jellyfin integration for auth, browsing, and playback launch.
|
|
|
|
// ==========================================
|
|
// Discord Rich Presence
|
|
// Optional Discord Rich Presence activity card updates for current playback/study session.
|
|
// Uses official SubMiner Discord app assets for polished card visuals.
|
|
// ==========================================
|
|
"discordPresence": {
|
|
"enabled": true, // Enable optional Discord Rich Presence updates. Values: true | false
|
|
"presenceStyle": "default", // Presence card text preset: "default" (clean bilingual), "meme" (Mining and crafting), "japanese" (fully JP), or "minimal". Values: default | meme | japanese | minimal
|
|
"updateIntervalMs": 3000, // Minimum interval between presence payload updates.
|
|
"debounceMs": 750 // Debounce delay used to collapse bursty presence updates.
|
|
}, // Optional Discord Rich Presence activity card updates for current playback/study session.
|
|
|
|
// ==========================================
|
|
// Immersion Tracking
|
|
// Enable/disable immersion tracking.
|
|
// Set dbPath to override the default sqlite database location.
|
|
// Policy tuning is available for queue, flush, and retention values.
|
|
// ==========================================
|
|
"immersionTracking": {
|
|
"enabled": true, // Enable immersion tracking for mined subtitle metadata. Values: true | false
|
|
"dbPath": "", // Optional SQLite database path for immersion tracking. Empty value uses the default app data path.
|
|
"batchSize": 25, // Buffered telemetry/event writes per SQLite transaction.
|
|
"flushIntervalMs": 500, // Max delay before queue flush in milliseconds.
|
|
"queueCap": 1000, // In-memory write queue cap before overflow policy applies.
|
|
"payloadCapBytes": 256, // Max JSON payload size per event before truncation.
|
|
"maintenanceIntervalMs": 86400000, // Maintenance cadence (prune + rollup + vacuum checks).
|
|
"retentionMode": "preset", // Retention mode (`preset` uses preset values, `advanced` uses explicit values). Values: preset | advanced
|
|
"retentionPreset": "balanced", // Retention preset when `retentionMode` is `preset`. Values: minimal | balanced | deep-history
|
|
"retention": {
|
|
"eventsDays": 0, // Raw event retention window in days. Use 0 to keep all.
|
|
"telemetryDays": 0, // Telemetry retention window in days. Use 0 to keep all.
|
|
"sessionsDays": 0, // Session retention window in days. Use 0 to keep all.
|
|
"dailyRollupsDays": 0, // Daily rollup retention window in days. Use 0 to keep all.
|
|
"monthlyRollupsDays": 0, // Monthly rollup retention window in days. Use 0 to keep all.
|
|
"vacuumIntervalDays": 0 // Minimum days between VACUUM runs. Use 0 to disable.
|
|
}, // Retention setting.
|
|
"lifetimeSummaries": {
|
|
"global": true, // Maintain global lifetime stats rows. Values: true | false
|
|
"anime": true, // Maintain per-anime lifetime stats rows. Values: true | false
|
|
"media": true // Maintain per-media lifetime stats rows. Values: true | false
|
|
} // Lifetime summaries setting.
|
|
}, // Enable/disable immersion tracking.
|
|
|
|
// ==========================================
|
|
// Stats Dashboard
|
|
// Local immersion stats dashboard served on localhost and available as an in-app overlay.
|
|
// Uses the immersion tracking database for overview, trends, sessions, and vocabulary views.
|
|
// ==========================================
|
|
"stats": {
|
|
"toggleKey": "Backquote", // Key code to toggle the stats overlay.
|
|
"markWatchedKey": "KeyW", // Key code to mark the current video as watched and advance to the next playlist entry.
|
|
"serverPort": 6969, // Port for the stats HTTP server.
|
|
"autoStartServer": true, // Automatically start the stats server on launch. Values: true | false
|
|
"autoOpenBrowser": false // Automatically open the stats dashboard in a browser when the server starts. Values: true | false
|
|
} // Local immersion stats dashboard served on localhost and available as an in-app overlay.
|
|
}
|