Skip to content

Latest commit

 

History

History
259 lines (228 loc) · 19.1 KB

README.md

File metadata and controls

259 lines (228 loc) · 19.1 KB

jidoujisho

A full-featured immersion language learning suite for mobile.

latest release latest commit actions stars downloads license translate donate


‍🧪 Latest Release: 2.9.0-preview3

📚 Resources:
🏠 Wiki · ❓ FAQ · 🩺 Troubleshooting · 🚀 Getting Started · 🃏 Flashcard Creation · 🗃️ Workflow Setup · 🎥 Viewing Media · 💡 Tips and Tricks · 🧑‍💻 Development · 👥 Contribution · 📑 API Documentation

🗒️ Release Notes:
(Legacy) 0.3 · 0.4 · 0.5 · 0.6 · 0.7 · 0.8 · 0.9 · 0.10 · 0.11 · 0.12 · 0.13 · 0.14 · 0.15 · 0.16 · 0.17 · 0.18 · 0.19 · 0.20 · 0.21 · 0.22 · 0.23 · 0.24 · 0.25 · 0.26
(Chisa) 1.0 · 1.1
(Yuuna) 2.0 · 2.1 · 2.2 · 2.3 · 2.4 · 2.5 · 2.6 · 2.7 · 2.8

📱 Language learning in the palm of your hand

jidoujisho is a video player, reading aid, dictionary and card creation toolkit with features specifically helpful for language learners.

  • 📖 Tap and drag selection of subtitles and paragraphs allows for instant dictionary lookups
  • 🃏 Export flashcards to AnkiDroid, complete with image and audio of the current context
  • 📺 Watch videos or listen to audio with subtitles from local device storage, YouTube or stream from a Jellyfin library or a direct URL
  • 📚 Read books anywhere and offline, via an embedded, self-hosted ッツ Ebook Reader
  • 🖼️ Read and mine manga pre-processed with Mokuro, and export or crop the current image
  • 🕸️ WebSocket support allows convenient use alongside texthookers for visual novels, games and more
  • 🎶 Get lyrics and easily make dictionary lookups for the current playing song in your music app
  • 🤖 Interact with ChatGPT in your target language to get grammar information, example sentences and more
  • 📘 Use Yomichan dictionaries with pitch and frequency information, and selectively collapse and expand dictionaries by default
  • Frictionless sentence mining and flashcard creation workflow with support for modular enhancements and automations

🎞️ A glimpse of jidoujisho in action

⚕️ Current state of the project

jidoujisho is eagerly looking for contributors. If you are interested in maintaining a dictionary format, media source, an enhancement or quick action or even a new language for the application, user and developer documentation is coming soon.

Originally built for the Japanese language learning community, jidoujisho is free and open source software, and is available to download here on GitHub.

Please note that the development of the app switches between changes being implemented and being left alone for daily use. Update frequency may depend on the gravity of any issues that arise. Hiatuses provide practical insight on usage and where development should go next.

📖 Using the application

🚨 Supported Formats

  • jidoujisho will take video and audio formats as supported by VLC. SDR video is recommended over HDR. Subtitles may be embedded within the video being played and selected during playback.
  • If you have trouble with storage space on your device, you may use the app as an external player for Jellyfin and stream from your PC media library, complete with progress tracking and external subtitles support.
  • If you wish to use external subtitles, they may be in SRT, ASS or SSA format and you may import them during playback through the menu. You may switch between different audio and subtitle tracks. Image-based subtitles such as PGS are not currently supported.
  • Closed captions and auto-generated captions are available when watching YouTube videos. Here is a fair sample of YouTube videos with such subtitles showcasing some very practical application use cases. Users are strongly advised not to use automatic captions if they cannot reliably discern their correctness.
  • ッツ Ebook Reader allows reading of books in EPUB or HTMLZ format.
  • Mokuro volumes must be in HTML format, and have images in the relative directory.
  • Make sure your Android WebView is updated before use. This will resolve common issues that may occur with ッツ Ebook Reader or Mokuro.
  • Users may import Yomichan dictionaries for Japanese, some can be found here. Note that Yomichan dictionaries using structured-content are currently unsupported.
  • Other supported formats include Migaku and DSL dictionaries.

🚀 Getting Started

A primer on the basics of the application is as follows.

  • 📲 Download and install the latest release onto your Android device
  • ⏯️ Watch a video with the Player selecting from your local media library or picking a YouTube video
  • 📚 Start a novel with the Reader to launch ッツ Ebook Reader to read an EPUB or HTMLZ file
  • 🖼️ Read pre-processed manga in HTML with the Mokuro media source
  • 📋 Tap a word for instant dictionary lookups, and open the Card Creator or use Instant Export
  • ❎ You can dismiss dictionary popups by swiping horizontally, using a volume button or tapping on the current selection
  • ↕️ You may swipe vertically in the player to open the transcript in the player, and pick a time or read subtitles
  • ↔️ Swipe horizontally in the player to repeat the current subtitle audio

📲 Exporting to AnkiDroid

  • 📤 You may also export the current context to an AnkiDroid card, including the current image and audio
  • ⚠️ If AnkiDroid is not running in the background, you will be prompted to install or launch it
  • 🗃 The AnkiDroid deck you last export to will be remembered for your next export
  • 📝 You may edit the card fields before exporting to AnkiDroid
  • ⚛️ Customisation of the Anki export is possible by creating your own export profile

🙌 User Tips

  • 🇯🇵 Can't find Japanese subtitles for your media? Try finding what you need at kitsunekko or Nekomoekisatten
  • 🔮 Customise your workflow by trying out different enhancements and quick actions
  • 🈲 Monolingually transitioning? Collapse your bilingual dictionaries by default, and split your export fields between expanded and collapsed meanings.
  • 📡 You can use Jellyfin to stream media from your PC, complete with progress tracking and external subtitle support
  • 🖐️ Double tap on a character when reading a meaning to quickly select it as a word and recursively search
  • 📑 External subtitles with the same name as the selected video file will be loaded by default
  • 📰 You can get example sentences from Massif, Tatoeba or ImmersionKit if a sentence you find is too hard
  • ⏲️ If your subtitles are off, you can set the delay or pad the exported audio time with an allowance
  • Export a range of multiple subtitles by holding onto a subtitle aside from the current one in the transcript
  • 📹 The quality closest to the last selected quality will be selected by default for YouTube videos
  • 💬 If your video has burned-in subtitles, you may use the blur widget under player options to hide them
  • ✂️ Reading manga? You can crop an image before exporting a card
  • 🎧 Listening to an audiobook? You can read with subtitles during playback by opening the transcript and clicking on the upper-right icon
  • 🔔 You can listen in the background by turning on background play with live subtitle previews in media notifications with controls
  • 🪡 Limit export to a single dictionary by selecting the button on the rightmost tag of a dictionary entry
  • 📜 Tap on a field's icon in the Card Creator to lock the field, which can be useful if exporting the same sentence multiple times
  • 🤖 Users may chat in various languages supported by ChatGPT. Users are advised not to heavily rely on an AI language model if they cannot accurately distinguish its correctness and accuracy.

👥 Contribution and attribution

arianneorpilla
arianneorpilla
m-edlund
m-edlund
Aegyo
Aegyo
Aquafina-water-bottle
Aquafina-water-bottle
Natsume-197
Natsume-197
MarvNC
MarvNC

jidoujisho is written in Dart and powered by Flutter, and is made available under the GNU General Public License 3.0.

Database enabled by Isar and Hive. Reader via a self-hosted ッツ Ebook Reader. Mokuro for manga reading. Video streaming via YouTube. Chat service via ChatGPT.

Image search via Bing. Audio search via Forvo and JapanesePod101. Example sentences from Massif, Tatoeba and ImmersionKit. Lyrics from Google and Uta-Net.

Natural language processing tools include Ve and MeCab for Japanese. Special thanks to the Yomichan project.

If you like what I've done so far, you can help me out by testing the application on various devices so that I can gauge the compatibility of the application with different versions of Android, making a donation or collaborating with me on further improvements.

The logo of the application is both by suzy and Aaron Marbella, support their awesome work if you can!