Skip to content

Cadlaxa/OpenUtau-Dictionary-Editor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

739f453 · Sep 13, 2024
Jul 14, 2024
Sep 13, 2024
Jul 30, 2024
Apr 15, 2024
Sep 13, 2024
Jul 11, 2024

Repository files navigation

English 華語

OpenUtau-Dictionary-Editor

A python GUI toolkit for creating and editing Aesthetic YAML dictionaries for OpenUtau 🥰😍

ou dict prev layout
  • To use this GUI Toolkit, for Windows I recommend using the portable .exe file and for MacOs and Linux I recommend using the .pyw file and use python version 3.10 and above 3.9 and below is untested and it may not work properly.
  • installing the modules for MacOs and Linux:
    pip install -r requirements.txt
    
  • pip is not on the path yet do python get-pip.py then pip install:
    python get-pip.py
    

📍 Download the latest version here:

Download Latest Release

📍 language support

  • OpenUtau Dictionary Editor uses a preformated yaml file for GUI translation. All users are welcome to translate the text found in Templates/Localizations/en_US.yaml to other languages and submit a pull request.

Features

Open/Append YAML Dictionaries

image

  • By clicking the [Open YAML File] button, you can open a premade OpenUTAU YAML dictionary to edit them directly with this GUI toolkit. The [Append YAML File] button's function is to merge multiple YAML files so that users can merge them together.

Create a YAML Dictionary from Scratch

image

  • You can add the graphemes and phonemes onto the Manual Entry section. Pressing the [Add Entry] button will add them to the Entries viewer. Using the [Delete Entry] button or the delete button on your keyboard will delete the selected entry. By clicking the entries first then shift + click to other entries will highlight them so that users can batch delete the entries using the [Delete Entry] button or the delete keyboard button.
  • Note: If creating a dictionary from scratch, choose a yaml template from the combobox picker

Using G2P for Faster Dictionary Editing/Creation

image

  • You can turn on G2P Suggestions on the Others tab and it will generate phonemes automatically when you type the words on the word entry
  • Currently the G2p models are the same with Openutau + Millefeuille French G2p model by UFR

Using OpenUtau YAML Templates or Custom Template

image

  • Using the combobox picker, users can choose their OpenUtau YAML template to create their dictionary. Also, users can add their own templates by placing them in the [Templates] folder so the GUI toolkit will recognize the files via the templates.ini and use them for dictionary creation.
  • Tip: if you're creating a custom dict from scratch, add your template from the templates folder so that you can use it on the picker and add your entries, if you have already made a custom dict, just import them to the editor then use 'Current Template' so that it add the entries to the current imported yaml file and still preserve the custom symbols

Sorting the Entries

image

  • Users can sort their entries alphabetically either A-Z or Z-A

Converting CMUdict to OU YAML dictionary

image

  • Function to convert the CMUdict.txt into a functional OpenUTAU dictionary. Note that the CMUdict mustn't have a ;;; or the GUI toolkit will throw an error.

Editing the Symbols and saving them as a Template

image

  • Users can edit the symbols of the yaml dictionary by clicking the Edit symbols, add or delete the symbols (phonemes and phoneme type) and saving them for future use.

Using the Entries Viewer

image

  • In the Entries Viewer, users can interact with the entries by clicking, deleting, adding, and arranging the entries.
  • Clicking the Entries to Edit

    image
  • Users can Ctrl + click and Shift + click to select multiple entries in the viewer.
  • Double Clicking the Cell for Direct Entry Edit

    image
    • By double clicking the selected entry or right-click > edit, users can directly edit the entry.
  • Dragging the Entries to Change Their Positions

    image
  • Users can drag and drop the entries to change their positions manually.

Using the Regex Function

image

  • Users can use the Regex search and replace to replace the grapheme or the phonemes.

Saving and Importing the Dictionary

  • There are currently 3 formats for saving the created/edited dictionary:
    • OpenUtau YAML Format
    • image
    • image
    • CMUDICT Format
    • image
    • image
    • Synthv Format
    • image
    • image

Changing Themes and Color Accents

image

  • Users change the theme and color accents of the GUI toolkit as they please. Currently there are 23 color accents to choose from corresponding with their Light and dark theme.

  • And other features of this GUI Toolkit such as automatic ' ' for the special characters for the grapheme and phonemes, Light mode and Dark mode theming, Entry sorting, Remove number accents, Make phonemes lowercase and more.