Memento is a FOSS, mpv-based video player for studying Japanese.
- Grammar aware subtitle search
- Yomichan-style Kanji cards
- Support for Yomichan dictionaries
- Anki card creation through AnkiConnect
- Support for mpv upscalers, plugins, and configuration files
- JMdict (Japanese vocabulary)
- JMnedict (Japanese names)
- KireiCake (Japanese slang)
- KANJIDIC (Japanese kanji)
- Innocent Corpus (Term and kanji frequencies across 5000+ novels)
- Kanjium (Pitch dictionary, see related project page for details)
This means there is a mistake in your card template. When this happens, AnkiConnect will report that all potential cards are not addable. Double check your card template to see if the front of the card is missing something.
Prior to mpv v0.35.0, it was impossible to set the visibility of primary and secondary subtitles independent of one another. If you haven't compiled Memento yourself and are using the provided binaries for v1.0.0 or later, this section doesn't apply to you.
Go to Settings โ Options โ Search, uncheck "Hide mpv subtitles when subtitle search is visible", and check "Hide subtitle search when playing media".
If the searchable subtitles become harder to read, consider adding a background. This can be done in Interface settings. Make sure you set the alpha/opacity channel to 255 in order to avoid your background being transparent.
When the Memento is paused, manually toggle subtitle visibility to reveal the secondary subtitle. Subtitle visibility is bound to v by default.
This error can be fixed by installing the Microsoft Visual C++ 2010 Service Pack 1 Redistributable Package (x86).
If you're version of youtube-dl is out of date, you may experience degraded streaming performance or websites not working entirely.
Memento's version of youtube-dl can be updated by doing the following:
- Download yt-dlp
- Rename the file to
youtube-dl.exe
- Put
youtube-dl.exe
in Memento's install directory. For the portable version of Memento, this is located in the same folder as the executable. For the installed version, this is located atC:\Program Files\Memento
by default.
This means that mpv cannot find your youtube-dl installation.
To install youtube-dl, paste these commands into Terminal:
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
Move the Memento application to a directory that doesn't have spaces in the path
like /Applications
. Unfortunately, this is an limitation of MeCab and there is
no workaround that can be implemented.
- Qt5 (>= 5.15)
- QtCore
- QtGui
- QtWidgets
- QtNetwork
- QtSvg
- QtDBus (Linux)
- X11Extras (Linux)
- mpv
- sqlite3
- MeCab
- With either ipadic or NAIST-jdic installed as a system dictionary on Linux and macOS. This only applies to self-compiled versions, not appimages or app bundles.
- Json-C
- libzip
- youtube-dl or yt-dlp (optional)
- Python (optional)
For the best experience, install Noto Sans JP and the Kanji Stroke Order fonts.
I do not guarantee that any branch will successfully build or be bug-free. If you want to build a stable version of Memento, compile a release from source.
To install Memento on Linux, type the following commands:
make
sudo make install
- Install MSYS2
- Open MSYS2 MinGW 64-bit
- Make sure MSYS2 is up to date by running this command multiple times until it stops doing anything:
pacman -Syuu
- Install the necessary tools and dependencies:
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-qt5 mingw-w64-x86_64-mpv mingw-w64-x86_64-mecab mingw-w64-x86_64-json-c mingw-w64-x86_64-libzip
- Clone the repository:
git clone https://github.com/ripose-jp/Memento.git
- Build Memento:
cd Memento ./windows/build.sh x86_64
- The resulting file will be in
build/Memento_x86_64
Important: Clang is the only officially supported compiler for building Memento on macOS.
- Install Homebrew with this command:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
- Install the necessary tools and dependencies:
brew install git cmake sqlite3 qt5 mpv mecab mecab-ipadic json-c libzip
- Clone the repository:
git clone https://github.com/ripose-jp/Memento.git
- Build Memento:
cd Memento make
- The resulting executable will be:
Memento/build/src/Memento
-
Follow steps 1 - 3 of the macOS build instructions.
-
dylibbundler
is also needed when creating an app bundle, so install it with:
brew install dylibbundler
-
Open the Keychain Access app.
-
Go to Keychain Access > Certificate Assistant > Create a Certificate... in the menubar.
-
Put the name of your certificate in the 'Name' field, set the 'Certificate Type' to 'Code Signing', and click 'Create'.
-
Return to your terminal and input:
cd Memento make appbundle CERT_NAME='<name entered in the last step>'
-
The resulting app bundle will located at:
Memento/build/src/Memento.app
To build with OCR support, make sure that Python is installed and run:
pip install manga-ocr
Any problems you may have getting manga-ocr
installed using pip
is beyond the scope of this project. I wish you the best of luck.
Add -DOCR_SUPPORT=ON
to the CMAKE_ARGS
environment variable:
export CMAKE_ARGS='-DOCR_SUPPORT=ON'
From here follow normal build instructions for your platform.
Note:
Theoretically OCR is supported on Windows.
Assuming Memento was built against msys2's version of Python, you will have to
set the environment variable PYTHONHOME
to C:\msys64\mingw64
.
Most mpv shaders, plugins, and configuration files will work without modification.
It is important to note that mpv and Memento's configuration directories are separate. This means mpv configuration files, scripts, etc. intended to modify Memento's behavior should be placed in Memento's configuration directory.
The Memento configuration directory is located at:
~/.config/memento
Version 0.5.1 and later
%APPDATA%\Local\memento
Version 0.5.0-1 and earlier
[installation directory]\config
~/Library/Preferences/memento
If any mpv binds or plugins do not work, please create an issue in the issue tracker.
Before making a pull request, please read CONTRIBUTING.md.
If you hate Memento, try Animebook.
https://github.com/animebook/animebook.github.io
- MpvWidget code is based off of libmpv example code by w4m
- Some code based off of Baka-MPlayer
- Hardware acceleration achieved on Linux using mpc-qt code
- UI inspired by and dictionaries provided by Yomichan.
- OCR backend written kha-white and contributors
- Fullscreen icons sourced from here
- Various icons sourced from here
- Pause, play, skip, and seek icons sourced from here and used under the CC 3.0 License
mingw-bundledlls.py
based on this script with a slightly expanded blacklist