mirror of
https://github.com/ksyasuda/SubMiner.git
synced 2026-04-09 04:19:27 -07:00
Compare commits
2 Commits
c24f99899b
...
8338f27794
| Author | SHA1 | Date | |
|---|---|---|---|
|
8338f27794
|
|||
|
b029d65c90
|
16
README.md
16
README.md
@@ -65,6 +65,10 @@ Local stats dashboard — watch time, anime library, vocabulary growth, mining t
|
|||||||
|
|
||||||
Browse sibling episode files and the active mpv queue in one overlay modal. Open it with `Ctrl+Alt+P` to append episodes from the current directory, jump to queued items, remove entries, or reorder the playlist without leaving playback.
|
Browse sibling episode files and the active mpv queue in one overlay modal. Open it with `Ctrl+Alt+P` to append episodes from the current directory, jump to queued items, remove entries, or reorder the playlist without leaving playback.
|
||||||
|
|
||||||
|
<div align="center">
|
||||||
|
<img src="docs-site/public/screenshots/playlist-browser.png" width="800" alt="Stats dashboard showing watch time, cards mined, streaks, and tracking data">
|
||||||
|
</div>
|
||||||
|
|
||||||
<br>
|
<br>
|
||||||
|
|
||||||
### Integrations
|
### Integrations
|
||||||
@@ -107,7 +111,7 @@ Browse sibling episode files and the active mpv queue in one overlay modal. Open
|
|||||||
## Requirements
|
## Requirements
|
||||||
|
|
||||||
| | Required | Recommended | Optional |
|
| | Required | Recommended | Optional |
|
||||||
| -------------- | --------------------------------------- | ---------------------------------------- | ----------------------------------------------------------- |
|
| -------------- | --------------------------------------- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------- |
|
||||||
| **Player** | [`mpv`](https://mpv.io) with IPC socket | — | — |
|
| **Player** | [`mpv`](https://mpv.io) with IPC socket | — | — |
|
||||||
| **Processing** | — | `ffmpeg` (audio clips & screenshots) | `mecab` + `mecab-ipadic` (annotation POS filtering), `guessit` (AniSkip), `alass` / `ffsubsync` (subtitle sync) |
|
| **Processing** | — | `ffmpeg` (audio clips & screenshots) | `mecab` + `mecab-ipadic` (annotation POS filtering), `guessit` (AniSkip), `alass` / `ffsubsync` (subtitle sync) |
|
||||||
| **Media** | — | — | `yt-dlp`, `chafa`, `ffmpegthumbnailer` |
|
| **Media** | — | — | `yt-dlp`, `chafa`, `ffmpegthumbnailer` |
|
||||||
@@ -237,7 +241,11 @@ See the [build-from-source guide](https://docs.subminer.moe/installation#from-so
|
|||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
### 2. Check Dependencies
|
### 2. First Launch
|
||||||
|
|
||||||
|
Run the app. On first launch SubMiner starts in the system tray, creates a default config, and opens a setup popup to finish config, install the mpv plugin, and configure Yomitan dictionaries.
|
||||||
|
|
||||||
|
### 3. Verify Setup
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
subminer doctor # verify mpv, ffmpeg, config, and socket
|
subminer doctor # verify mpv, ffmpeg, config, and socket
|
||||||
@@ -246,10 +254,6 @@ subminer doctor # verify mpv, ffmpeg, config, and socket
|
|||||||
> [!NOTE]
|
> [!NOTE]
|
||||||
> On Windows, use `bun run subminer doctor` or run `SubMiner.exe` directly — first-run setup will guide you through dependency checks.
|
> On Windows, use `bun run subminer doctor` or run `SubMiner.exe` directly — first-run setup will guide you through dependency checks.
|
||||||
|
|
||||||
### 3. First Launch
|
|
||||||
|
|
||||||
Run the app. On first launch SubMiner starts in the system tray, creates a default config, and opens a setup popup to finish config, install the mpv plugin, and configure Yomitan dictionaries.
|
|
||||||
|
|
||||||
### 4. Mine
|
### 4. Mine
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
|||||||
@@ -388,21 +388,12 @@ AnkiConnect listens on `http://127.0.0.1:8765` by default. SubMiner will connect
|
|||||||
|
|
||||||
For enrichment configuration (sentence, audio, screenshot fields), see [Anki Integration](/anki-integration).
|
For enrichment configuration (sentence, audio, screenshot fields), see [Anki Integration](/anki-integration).
|
||||||
|
|
||||||
## Verify Installation
|
## First-Run Setup
|
||||||
|
|
||||||
After installing, run the built-in diagnostic to confirm dependencies are in place:
|
On first launch SubMiner creates a default config file automatically and opens a setup popup. You do **not** need to create the config manually — SubMiner handles it.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
subminer doctor
|
# Play a file (default plugin config auto-starts visible overlay and waits for annotation readiness; first launch opens first-run setup popup)
|
||||||
```
|
|
||||||
|
|
||||||
This checks for the app binary, mpv, ffmpeg, config file, and socket path. Fix any failures before continuing.
|
|
||||||
|
|
||||||
> [!NOTE]
|
|
||||||
> On Windows, use `bun run subminer doctor` or run `SubMiner.exe` directly. Replace `SubMiner.AppImage` with `SubMiner.exe` in the direct app commands below.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Play a file (default plugin config auto-starts visible overlay and waits for annotation readiness; first launch may open first-run setup popup)
|
|
||||||
subminer video.mkv
|
subminer video.mkv
|
||||||
|
|
||||||
# Optional explicit overlay start for setups with plugin auto_start=no
|
# Optional explicit overlay start for setups with plugin auto_start=no
|
||||||
@@ -419,12 +410,6 @@ SubMiner.AppImage --start --dev
|
|||||||
SubMiner.AppImage --help # Show all CLI options
|
SubMiner.AppImage --help # Show all CLI options
|
||||||
```
|
```
|
||||||
|
|
||||||
You should see the overlay appear over mpv. If subtitles are loaded in the video, they will appear as interactive text in the overlay.
|
|
||||||
|
|
||||||
## First-Run Setup
|
|
||||||
|
|
||||||
On first launch SubMiner creates a default config file automatically and opens a setup popup. You do **not** need to create the config manually — SubMiner handles it.
|
|
||||||
|
|
||||||
The setup popup walks you through:
|
The setup popup walks you through:
|
||||||
|
|
||||||
- **Config file**: auto-created at `~/.config/SubMiner/config.jsonc` (Linux/macOS) or `%APPDATA%\SubMiner\config.jsonc` (Windows)
|
- **Config file**: auto-created at `~/.config/SubMiner/config.jsonc` (Linux/macOS) or `%APPDATA%\SubMiner\config.jsonc` (Windows)
|
||||||
@@ -437,6 +422,21 @@ The `Finish setup` button stays disabled until the plugin is installed and at le
|
|||||||
> [!TIP]
|
> [!TIP]
|
||||||
> You can re-open the setup popup at any time with `subminer --setup` or `SubMiner.AppImage --setup`.
|
> You can re-open the setup popup at any time with `subminer --setup` or `SubMiner.AppImage --setup`.
|
||||||
|
|
||||||
|
You should see the overlay appear over mpv. If subtitles are loaded in the video, they will appear as interactive text in the overlay.
|
||||||
|
|
||||||
|
## Verify Setup
|
||||||
|
|
||||||
|
After completing first-run setup, run the built-in diagnostic to confirm everything is in place:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
subminer doctor
|
||||||
|
```
|
||||||
|
|
||||||
|
This checks for the app binary, mpv, ffmpeg, config file, and socket path. Fix any failures before continuing.
|
||||||
|
|
||||||
|
> [!NOTE]
|
||||||
|
> On Windows, use `bun run subminer doctor` or run `SubMiner.exe` directly. Replace `SubMiner.AppImage` with `SubMiner.exe` in the direct app commands below.
|
||||||
|
|
||||||
## Optional Extras
|
## Optional Extras
|
||||||
|
|
||||||
### Rofi Theme (Linux Only)
|
### Rofi Theme (Linux Only)
|
||||||
|
|||||||
BIN
docs-site/public/screenshots/playlist-browser.png
Normal file
BIN
docs-site/public/screenshots/playlist-browser.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 746 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 64 KiB After Width: | Height: | Size: 96 KiB |
Reference in New Issue
Block a user