Skip to main content

CLI and GUI launcher for the Mirumoji project, an open-source, self-hostable Japanese language immersion tool.

Project description

Overview

Mirumoji is an open-source, self-hosted Japanese immersion toolkit. Drop in any video, anime episode, drama or audio clip and it gives you: clickable tokenized subtitles with dictionary pop-ups, Whisper-powered transcription, instant SRT/clip extraction, and one-click Anki deck export — all in Docker, all running on your own machine.

Optional OpenAI Integration - Customizable GPT Breakdowns of Subtitles -

Optional Modal Integration - Install a CPU only version and run all GPU tasks on the cloud -


Preview

You can see a preview of the application's frontend (No backend running) Here

Features

Interactive Video Player

alt-text

Upload your local anime/J-Drama espisodes or any Japanese video and .SRT subtitles.

Clickable Japanese Subtitles

alt-text

Subtitles are tokenized (kuromoji.js), allowing you to click individual words with integrated offline JMDict for definitions.

OpenAI Integration

alt-text

Modify System Message and User Prompt with {sentence} and {word} variables.

Local Media Processing

Video Conversion

Upload videos in various formats; they can be converted to MP4 for optimal playback.

SRT Generation

Generate subtitles for your videos. Runs FasterWhisper with modified parameters to increase accuracy for longer media such as Anime/ J-Drama episodes.

Audio Transcription

alt-text

Transcribe Japanese audio from recordings or uploaded files.

Profile-Based Data Management:

Persistent Storage

alt-img

Profile configurations and all other profile-related data is stored and managed via SQLite database by the backend.

Clip Saving

alt-img

Save important video segments with their associated word breakdowns and export as an Anki Deck


Setup

Both the frontend and backend have pre-built Docker images and are set up to work with Docker Compose.

The easiest setup is to run the launcher for your platform. For detailed instructions please refer to the Setup Guide

You can also choose to build the images locally with the Dockerfiles provided.


Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mirumoji-2.4.3.tar.gz (19.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mirumoji-2.4.3-py3-none-any.whl (21.3 kB view details)

Uploaded Python 3

File details

Details for the file mirumoji-2.4.3.tar.gz.

File metadata

  • Download URL: mirumoji-2.4.3.tar.gz
  • Upload date:
  • Size: 19.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for mirumoji-2.4.3.tar.gz
Algorithm Hash digest
SHA256 3eadfc8c2807efa038476c6483cc5f405f8f96aea3564a3332aa0fe453aa7e38
MD5 b48f2446ec2ec003e87db403f33b1a4b
BLAKE2b-256 2e4569a9b0aab343667b9ee776230863ce9fc9bce810cfa9d00628d4e6a4e8e6

See more details on using hashes here.

Provenance

The following attestation bundles were made for mirumoji-2.4.3.tar.gz:

Publisher: cli-pypi_release.yaml on svdC1/mirumoji

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mirumoji-2.4.3-py3-none-any.whl.

File metadata

  • Download URL: mirumoji-2.4.3-py3-none-any.whl
  • Upload date:
  • Size: 21.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for mirumoji-2.4.3-py3-none-any.whl
Algorithm Hash digest
SHA256 5ede665459c8be0b19dc725e4bd92a4bf09f90dcd38983b633e18bd193669518
MD5 0c6aceae0578db8d79122271303d1b5a
BLAKE2b-256 435dfa9607b8e3477d7babddc4f30efc1a049ce66a58e0cf738b0130f7bf27ad

See more details on using hashes here.

Provenance

The following attestation bundles were made for mirumoji-2.4.3-py3-none-any.whl:

Publisher: cli-pypi_release.yaml on svdC1/mirumoji

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page