Memento

Memento 是一款基于 mpv 的开源视频播放器，专为学习日语而设计。

功能特点

• 语法感知字幕搜索
• Yomichan 风格的汉字卡片
• 支持 Yomichan 词典
• 通过 AnkiConnect 创建 Anki 卡片
• 支持 mpv 画质提升器、插件和配置文件

词典

• JMdict (日语词汇)
  • JMdict_dutch.zip
  • JMdict_english.zip
  • JMdict_french.zip
  • JMdict_german.zip
  • JMdict_hungarian.zip
  • JMdict_russian.zip
  • JMdict_slovenian.zip
  • JMdict_spanish.zip
  • JMdict_swedish.zip
• JMnedict (日语名称)
  • JMnedict.zip
• KireiCake (日语俚语)
  • kireicake.zip
• KANJIDIC (日语汉字)
  • KANJIDIC_english.zip
  • KANJIDIC_french.zip
  • KANJIDIC_portuguese.zip
  • KANJIDIC_spanish.zip
• Innocent Corpus (5000多本小说中的词语和汉字频率)
  • innocent_corpus.zip
• Kanjium (音调词典，详情请参阅相关项目页面)
  • kanjium_pitch_accents.zip

故障排除

无法添加卡片：仅显示"在 Anki 中显示"按钮

这意味着您的卡片模板存在错误。 出现这种情况时，AnkiConnect 会报告所有潜在卡片都无法添加。 请仔细检查您的卡片模板，看看卡片正面是否缺少某些内容。

副字幕无法工作

在 mpv v0.35.0 之前的版本中，无法独立设置主字幕和副字幕的可见性。 如果您没有自行编译 Memento，而是使用 v1.0.0 或更高版本的预编译二进制文件，则此部分不适用于您。

方法 1

前往设置 → 选项 → 搜索，取消勾选"当字幕搜索可见时隐藏 mpv 字幕"，并勾选"播放媒体时隐藏字幕搜索"。 如果可搜索字幕变得难以阅读，可以考虑添加背景。 这可以在界面设置中完成。 确保将透明度/不透明度通道设置为255，以避免背景变得透明。

方法2

当Memento暂停时，手动切换字幕可见性以显示次要字幕。 字幕可见性默认绑定到v键。

Windows：尝试流式播放时缺少MSVCR100.dll

此错误可以通过安装Microsoft Visual C++ 2010 Service Pack 1 Redistributable Package (x86)来修复。

Windows：更新youtube-dl/yt-dlp

如果你的youtube-dl版本过时，可能会导致流式播放性能下降或网站完全无法工作。

可以通过以下步骤更新Memento的youtube-dl版本：

1. 下载yt-dlp
2. 将文件重命名为youtube-dl.exe
3. 将youtube-dl.exe放入Memento的安装目录。对于便携版Memento，它位于与可执行文件相同的文件夹中。对于安装版，默认位于C:\Program Files\Memento。

macOS：流式视频无法播放

这意味着mpv无法找到你的youtube-dl安装。

要安装youtube-dl，请在终端中粘贴以下命令：

curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o ~/Library/Preferences/memento/youtube-dl
chmod a+rx ~/Library/Preferences/memento/youtube-dl

macOS：无法初始化MeCab

将Memento应用程序移动到路径中没有空格的目录，如/Applications。不幸的是，这是MeCab的限制，无法实现其他解决方法。

Linux：音频和图像无法添加到Anki

这只适用于使用Anki Flatpak的用户。

默认情况下，Anki Flatpak无法访问/tmp目录。 Memento在将音频和图像文件提供给Anki时，会暂时将它们存储在这里。 你可以通过安装Flatseal来给Anki访问/tmp目录的权限。 打开Flatseal，选择Anki，然后在其他文件下添加/tmp目录。

依赖项

• Qt
  • Base
  • SVG
• mpv
• sqlite3
• Json-C
• libzip
• youtube-dl或yt-dlp（可选）
• MeCab（可选）
  • 在Linux和macOS上，需要安装ipadic或NAIST-jdic作为系统字典。这只适用于自编译版本，不适用于appimage或app bundles。
• Python（可选）

为获得最佳体验，请安装Noto Sans JP 和Kanji Stroke Order字体。

构建

我不保证任何分支都能成功构建或没有Bug。 如果你想构建稳定版的Memento，请从源代码编译发布版本。

Linux

要在Linux上安装Memento，请输入以下命令：

make
sudo make install

Windows

1. 安装MSYS2
2. 打开MSYS2 MinGW 64-bit
3. 确保MSYS2是最新的，多次运行此命令直到它停止执行任何操作：

   pacman -Syuu
   

4. 安装必要的工具和依赖项：

   pacman -S git make mingw-w64-x86_64-gcc mingw-w64-x86_64-ninja mingw-w64-x86_64-cmake mingw-w64-x86_64-python mingw-w64-x86_64-sqlite3 mingw-w64-x86_64-qt6 mingw-w64-x86_64-mpv mingw-w64-x86_64-mecab mingw-w64-x86_64-json-c mingw-w64-x86_64-libzip
   

5. 克隆仓库：

   git clone https://github.com/ripose-jp/Memento.git
   

6. 构建Memento：

   cd Memento
   ./windows/build.sh x86_64
   

7. 生成的文件将位于

   build/Memento_x86_64
   

macOS

重要提示： Clang是在macOS上构建Memento唯一官方支持的编译器。

1. 使用以下命令安装 Homebrew：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
   

2. 安装必要的工具和依赖：

   brew install git cmake sqlite3 qt6 mpv mecab mecab-ipadic json-c libzip
   

3. 克隆仓库：

   git clone https://github.com/ripose-jp/Memento.git
   

4. 构建 Memento：

   cd Memento
   make
   

5. 生成的可执行文件将位于：

   Memento/build/src/Memento
   

macOS 应用程序包

1. 按照 macOS 构建说明的步骤 1-3 进行操作。

2. 创建应用程序包时还需要 dylibbundler，请使用以下命令安装：

brew install dylibbundler

3. 打开 钥匙串访问 应用程序。

4. 在菜单栏中选择 钥匙串访问 > 证书助理 > 创建证书...。

5. 在"名称"字段中输入证书名称，将"证书类型"设置为"代码签名"，然后点击"创建"。

6. 返回终端并输入：

   cd Memento
   make appbundle CERT_NAME='<上一步输入的名称>'
   

7. 生成的应用程序包将位于：

   Memento/build/src/Memento.app
   

添加 OCR 支持

要构建带有 OCR 支持的版本，确保已安装 Python，然后运行：

pip install manga-ocr

使用 pip 安装 manga-ocr 时遇到的任何问题超出了本项目的范围。祝你好运。

将 -DOCR_SUPPORT=ON 添加到 CMAKE_ARGS 环境变量中：

export CMAKE_ARGS='-DOCR_SUPPORT=ON'

然后按照你所使用平台的正常构建说明进行操作。

注意： 理论上 OCR 在 Windows 上也受支持。 假设 Memento 是基于 msys2 版本的 Python 构建的，你需要将环境变量 PYTHONHOME 设置为 C:\msys64\mingw64。

配置

大多数 mpv 着色器、插件和配置文件无需修改即可使用。

需要注意的是，mpv 和 Memento 的配置目录是分开的。这意味着用于修改 Memento 行为的 mpv 配置文件、脚本等应该放在 Memento 的配置目录中。

Memento 配置目录位于：

Linux

~/.config/memento

Windows

0.5.1 版本及以后

%APPDATA%\Local\memento

0.5.0-1 版本及以前

[安装目录]\config

macOS

~/Library/Preferences/memento

如果有任何 mpv 绑定或插件不工作，请在问题追踪器中创建一个 issue。

贡献

在提交拉取请求之前，请阅读 CONTRIBUTING.md。

Animebook

如果你不喜欢 Memento，可以试试 Animebook。

https://github.com/animebook/animebook.github.io

致谢

• MpvWidget 代码基于 w4m 的 libmpv 示例代码
  • https://github.com/mpv-player/mpv-examples/tree/master/libmpv/qt_opengl
• 部分代码基于 Baka-MPlayer
  • https://github.com/u8sand/Baka-MPlayer
• Linux 上的硬件加速使用 mpc-qt 代码实现
  • https://github.com/mpc-qt/mpc-qt
• UI 灵感来自 Yomichan，字典由 Yomichan 提供
  • https://foosoft.net/projects/yomichan/
• OCR 后端由 kha-white 和贡献者编写
  • https://github.com/kha-white/manga-ocr
• 全屏图标来源于
  • https://www.iconfinder.com/iconsets/material-core
• 各种图标来源于
  • https://www.iconfinder.com/iconsets/ionicons
• 暂停、播放、跳过和寻找图标来源于此处，并根据 CC 3.0 许可 使用
  • https://www.iconfinder.com/iconsets/play-rounded
• mingw-bundledlls.py 基于此脚本，略微扩展了黑名单
  • https://github.com/mpreisler/mingw-bundledlls
• Flatpak 清单主要基于 mpv Flatpak
  • https://github.com/flathub/io.mpv.Mpv