Install manually, without Terminal

Prefer not to run a command? Download the extension as a ZIP file and add it to your browser yourself. It takes about two minutes. Pick your device below and follow the pictures.

Download the extension

⬇ Download MiraiSub (.zip)

The file comes only from miraisub.com. Never install a MiraiSub file you got from somewhere else.

  1. Download the ZIP file

    Click the download button above. The file subapp-private.zip is saved to your Downloads folder.

    miraisub.com/install/manual/⬇ MiraiSub .zipsubapp-private.zip4 MB · Downloads

  2. Extract the ZIP file

    Open the Downloads folder, right-click subapp-private.zip and choose “Extract All…”, then “Extract”. A folder named subapp-private appears. Move it somewhere you will keep (for example Documents): the browser loads the extension from this folder, so do not delete it.

    DownloadsDownloadssubapp-private.zipExtract All…subapp-private

  3. Open the extensions page

    In the address bar type chrome://extensions and press Enter. In Edge type edge://extensions, in Brave brave://extensions, in Opera opera://extensions. Cốc Cốc also accepts chrome://extensions.

    Extensions page by browser
    Google Chromechrome://extensions
    Microsoft Edgeedge://extensions
    Bravebrave://extensions
    Operaopera://extensions
    Cốc Cốcchrome://extensions
    chrome://extensionsEnter ↵

  4. Turn on Developer mode

    Switch on “Developer mode”. In Chrome, Brave and Cốc Cốc the switch is in the top-right corner; in Edge it is in the left menu. It only lets you load an extension from a folder.

    chrome://extensionsExtensionsDeveloper mode……

  5. Click “Load unpacked”

    A new row of buttons appears. Click “Load unpacked”.

    chrome://extensionsExtensionsDeveloper modeLoad unpacked···…

  6. Choose the subapp-private folder

    Select the subapp-private folder you extracted (the one that contains manifest.json, not the ZIP file) and confirm. MiraiSub now shows in the list and its welcome page opens.

    DownloadsDownloadssubapp-privatesubapp-private.zipSelect Folder

  7. Pin MiraiSub and sign in

    Click the puzzle icon next to the address bar and pin MiraiSub. Open it, sign in or enter your license key, then play any video: subtitles appear on the player.

    miraisub.comExtensionsMiraiSub

Updating to a new version

  1. Download the new ZIP from this page.
  2. Extract it and replace the contents of your old subapp-private folder (same place).
  3. Open the extensions page and click the reload ↻ icon on the MiraiSub card. Your sign-in and settings are kept.

Common problems

“Manifest file is missing or unreadable”

You picked the wrong folder or the ZIP file itself. Choose the folder that directly contains manifest.json; if it is nested, open it one level deeper.

The browser shows a warning about developer mode extensions

That is normal for any extension loaded from a folder. Close the message; MiraiSub keeps working.

MiraiSub disappeared after I deleted or moved the folder

The browser reads the extension from that folder. Put the folder back (or extract the ZIP again) and load it once more.

I don’t see “Load unpacked”

Developer mode is still off. Turn it on, then the button appears.

Prefer one command? Use the Terminal installer