Skip to content

Latest commit

 

History

History
110 lines (83 loc) · 6.65 KB

README-en.md

File metadata and controls

110 lines (83 loc) · 6.65 KB
Raw

RomajiConverter.WinUI

Win11 style romaji converter developed using WinUI 3 framework

中文使用文档

Here's the user-facing document, if you're more focused on development-related content, jump here

Preview(Win11)

Supported system versions

  • Supported versions of project settings: Windows 10 1809 (Build 17763) or above
  • Developer-tested system versions: Windows 10 22H2 (19045), Windows 11 22H2 (22621)
  • If your version of Windows is not in the above scope, you can view the project RomajiConverter（Support Win7 or above）
  • If you need an Android App, check this RomajiConverter.App

Function

  • Convert kana and kanji to romaji
  • Support direct conversion of Japanese lyrics with Chinese translation (by copying or importing)
  • Support the import of currently playing lyrics on NetEase Cloud Music PC Client
  • Support import lyrics from links (NetEase Cloud, QQ Music, KuGou)
  • Provide multiple pronunciations of a word as an alternative
  • You can edit the conversion result and export it as a PNG image

UI Description

  1. Enter your Japanese text in the text box on the left
    • Or get the lyrics of the song currently being played from the NetEase Cloud Music PC client via the Get CloudMusic Lyrics button, which does not support pure music and the sound in the podcast
    • Or use the Import Lyics From Url button to enter the song sharing url obtained from NetEase Cloud, QQ Music, and KuGou's PC client to import lyrics
  2. Select Consider variants, it will try to convert unrecognized kanji characters to traditional or simplified until get the romaji correctly. If this option is not selected, the original text will be converted directly
  3. In non-Detail Mode, click the Convert button to get the converted text, and you can change the format of the converted text in the Text Display Option above
  4. In Detail Mode, click Convert will generate a preview of the conversion, the display elements can be changed via the Display Option above, if you find a conversion error, you can double-click the box to enter edit mode to modify it, you can choose the pronunciation alternates generated by the app, or you can enter text freely. Click on the blank space or Enter to exit the editing mode, and then click Generate Text to get the converted text
  5. You can click the Save button to save the current conversion preview, and then click the Open button to continue editing
  6. You can click the Export Image button to save the current conversion preview as an image, and the image will be styled in the same way as the conversion preview (without boxes and dividers), and will also be controlled by the Display Options. As for the font, color, and spacing, you need to click the Settings button to set it
  7. The text on the interface supports size scaling, method: Ctrl + scroll wheel

Bug

  • The conversion of kanji and polyphonic kana (e.g. は) is not necessarily accurate, and the actual pronunciation prevails
  • Although the function of identifying the simplified and traditional variants is provided, it may not be accurate, so please ensure that the lyrics are in correct Japanese
  • Double-clicking on a border sometimes fails to enter edit mode, so just try again

Common Problem

本能が云(い)う、嫌々(いやいや)  =>  honnou ga云(i)u、iyaiya(iyaiya)
どこかで微(かす)か伝うメーデー  =>  doko ka de bi(kasu)ka tsutau mee dee
  • The reason for the above situation where the kanji characters are not converted and the pronunciation is wrong is that the uploader of the lyrics has already marked the pronunciation in parentheses. In this case, just use the pronunciation in parentheses

Download and update

  • Download please check Release, choose the latest version to download for your system
  • Selecting the framework-dependent version requires installing .net core 8.0 desktop runtime, while the self-contained version does not

Update log

1.2.4

  • Fixed the issue that the editing result was not saved when saving the lyrics json

1.2.3

  • Added word margin to the Image Option
  • Optimized the function of importing lyrics from url

1.2.2

  • Added the function of importing lyrics from url, supporting NetEase Cloud, QQ Music, and KuGou

1.2.1

  • Fixed an unexpected error when converting romaji
  • Fixed the issue that some songs could not get NetEase Cloud Music lyrics
  • This version re-implements the Lrc parser, if you still can't get NetEase Cloud Music lyrics, please feedback, and change to the old parser in the settings then try again

1.2.0

  • Fixed a problem where conversion of long vowel symbol to hiragana was incorrect (ー became ゜)

    example before fix after fix
    アイロニー あいろに゜ あいろにー

  • Re-implement the conversion logic from kana to romaji, effect:

    • For non-foreign words, the long vowel symbol will be converted to specific pronunciation kana
    • Fixed a problem where some long vowel symbol were converted to romaji incorrectly
    example before fix after fix
    秒 びょー びょう
    秒 byo- byou
    一方通行 いっぽー つーこー いっぽう つうこう
    一方通行 ippo- tsuukoo ippou tsuukou

  • Fixed a problem with the conversion of extened kana that are mainly used for loanwords

    example before fix after fix
    フェ fue fe
    ファ fua fa
    ティ tei ti
    ...

  • Extract some of the code into the core project and add unit tests

1.1.0

  • Added the alternative function, double-click the border to pop up the alternative options for all pronunciations of the word, you can directly select it, or you can modify it freely (press the Enter key after entering the text). When you select an alternative, if the option is app-generated, it also supports option synchronization for romaji and hiragana
  • Added border display settings, which can be used with the alternate function
  • Optimized the romaji conversion logic, and supported replacing the unidic dictionary resource (unidic folder)
  • Optimized memory usage (not very noticeable)

1.0.0

  • Migrated from a WPF project to WinUI 3 with all the original functionality