utaupy


Nameutaupy JSON
Version 1.19.1 PyPI version JSON
download
home_pagehttps://github.com/oatsu-gh/utaupy
SummaryPython3 module for UTAU and singing-databases
upload_time2024-09-28 15:47:35
maintaineroatsu
docs_urlNone
authoroatsu
requires_pythonNone
licenseNone
keywords utau
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            # utaupy
[![PyPI](https://img.shields.io/pypi/v/utaupy.svg)](https://pypi.python.org/pypi/utaupy)

UTAU周辺のデータ処理を行うPythonのパッケージです。READMEは書いてる途中です。
PythonでUTAUプラグインを作りたい場合は、C# 用の **[utauPlugin](https://github.com/delta-kimigatame/utauPlugin)** をPythonに移植した **[pyUtau](https://github.com/UtaUtaUtau/pyUtau)** のほうがいいかもしれません。ビブラートやピッチの扱いが便利そうです。

## 利用規約

LICENSE ファイルをご覧ください。

## 処理できるファイル

- .ust (UTAU)
- .txt (UTAU Plugin Script)
- .txt (録音リスト)
- .ini (setParam および UTAU音源原音設定)
- .lab (歌唱データベース用音素ラベル)
- .table (ローマ字かな対応表)
- .svp (Synthesizer V R2)
- .csv (REAPER リージョン・マーカー用)



## 機能概要

- INI, UST, LAB ファイルのデータをクラスオブジェクトとして扱います。
- INI, UST, LAB ファイルを変換できます。ただし不可逆の処理が多いです。



# Methods

---

## utaupy.ust

---

### Ust

UST ファイルを取り扱うためのクラス

### load(path)

USTファイルを読み取り、Ust オブジェクトにする。

```Python
ustobj = utaupy.ust.load(path)
print(type(ustobj))
# <class 'utaupy.ust.Ust'>
```

---

## utaupy.otoini

UTAUの原音設定ファイルを扱うモジュール。setParamでの利用を想定。

---

### class utaupy.otoini.OtoIni(collections.UserList)

oto.ini ファイルを扱うためのクラス。

---

### class utaupy.otoini.Oto(collections.UserDict)

oto.ini に含まれる各原音のパラメータを扱うクラス。

---

## utaupy.table

かなローマ字変換表などを扱うモジュール。

## utaupy.convert

Ust オブジェクト、OtoIni オブジェクト、Label オブジェクトなどを変換するモジュール。

## utaupy.reaper

REAPER (DAW) のリージョン・マーカー用CSVファイルを扱うモジュール。

## utaupy.utau

UTAUエディタで行う操作の代替と、UTAU音源の原音値取得などをするモジュール。「パラメータ自動調整」などができる。

## utaupy.utauplugin

UTAUプラグインをつくるためのモジュール。utaupy.utauplugin.UtauPlugin クラスは utaupy.ust.Ust を継承し、プラグイン用に最適化した子クラス。

使用例として半音上げプラグインを貼っておきます。

```Python
import utaupy

def notenum_plus1(utauplugin):
    """
    utauplugin: utaupy.utauplugin.UtauPlugin class object
    全てのノートを半音上げる
    """
    # 全ノートを取得
    notes = utauplugin.notes
    # 半音上げ
    for note in notes:
        note.notenum += 1

if __name__ == '__main__':
    # automatically
    # read the utau plugin script
    # load as utaupy.utauplugin.UtauPlugin class object
    # overwrite the utau plugin script
    utaupy.utauplugin.run(notenum_plus1)
```





## 連絡先

- Twitter: @oatsu_c

- GitHub: oatsu-gh

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/oatsu-gh/utaupy",
    "name": "utaupy",
    "maintainer": "oatsu",
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": "oatsu.dev@gmail.com",
    "keywords": "UTAU",
    "author": "oatsu",
    "author_email": "oatsu.dev@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/75/25/052bcff7212b97df1ff7f1903122133d24a245cb10b23e2e96356f3f800d/utaupy-1.19.1.tar.gz",
    "platform": null,
    "description": "# utaupy\r\n[![PyPI](https://img.shields.io/pypi/v/utaupy.svg)](https://pypi.python.org/pypi/utaupy)\r\n\r\nUTAU\u5468\u8fba\u306e\u30c7\u30fc\u30bf\u51e6\u7406\u3092\u884c\u3046Python\u306e\u30d1\u30c3\u30b1\u30fc\u30b8\u3067\u3059\u3002README\u306f\u66f8\u3044\u3066\u308b\u9014\u4e2d\u3067\u3059\u3002\r\nPython\u3067UTAU\u30d7\u30e9\u30b0\u30a4\u30f3\u3092\u4f5c\u308a\u305f\u3044\u5834\u5408\u306f\u3001C# \u7528\u306e **[utauPlugin](https://github.com/delta-kimigatame/utauPlugin)** \u3092Python\u306b\u79fb\u690d\u3057\u305f **[pyUtau](https://github.com/UtaUtaUtau/pyUtau)** \u306e\u307b\u3046\u304c\u3044\u3044\u304b\u3082\u3057\u308c\u307e\u305b\u3093\u3002\u30d3\u30d6\u30e9\u30fc\u30c8\u3084\u30d4\u30c3\u30c1\u306e\u6271\u3044\u304c\u4fbf\u5229\u305d\u3046\u3067\u3059\u3002\r\n\r\n## \u5229\u7528\u898f\u7d04\r\n\r\nLICENSE \u30d5\u30a1\u30a4\u30eb\u3092\u3054\u89a7\u304f\u3060\u3055\u3044\u3002\r\n\r\n## \u51e6\u7406\u3067\u304d\u308b\u30d5\u30a1\u30a4\u30eb\r\n\r\n- .ust (UTAU)\r\n- .txt (UTAU Plugin Script)\r\n- .txt (\u9332\u97f3\u30ea\u30b9\u30c8)\r\n- .ini (setParam \u304a\u3088\u3073 UTAU\u97f3\u6e90\u539f\u97f3\u8a2d\u5b9a)\r\n- .lab (\u6b4c\u5531\u30c7\u30fc\u30bf\u30d9\u30fc\u30b9\u7528\u97f3\u7d20\u30e9\u30d9\u30eb)\r\n- .table (\u30ed\u30fc\u30de\u5b57\u304b\u306a\u5bfe\u5fdc\u8868)\r\n- .svp (Synthesizer V R2)\r\n- .csv (REAPER \u30ea\u30fc\u30b8\u30e7\u30f3\u30fb\u30de\u30fc\u30ab\u30fc\u7528)\r\n\r\n\r\n\r\n## \u6a5f\u80fd\u6982\u8981\r\n\r\n- INI, UST, LAB \u30d5\u30a1\u30a4\u30eb\u306e\u30c7\u30fc\u30bf\u3092\u30af\u30e9\u30b9\u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u3068\u3057\u3066\u6271\u3044\u307e\u3059\u3002\r\n- INI, UST, LAB \u30d5\u30a1\u30a4\u30eb\u3092\u5909\u63db\u3067\u304d\u307e\u3059\u3002\u305f\u3060\u3057\u4e0d\u53ef\u9006\u306e\u51e6\u7406\u304c\u591a\u3044\u3067\u3059\u3002\r\n\r\n\r\n\r\n# Methods\r\n\r\n---\r\n\r\n## utaupy.ust\r\n\r\n---\r\n\r\n### Ust\r\n\r\nUST \u30d5\u30a1\u30a4\u30eb\u3092\u53d6\u308a\u6271\u3046\u305f\u3081\u306e\u30af\u30e9\u30b9\r\n\r\n### load(path)\r\n\r\nUST\u30d5\u30a1\u30a4\u30eb\u3092\u8aad\u307f\u53d6\u308a\u3001Ust \u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u306b\u3059\u308b\u3002\r\n\r\n```Python\r\nustobj = utaupy.ust.load(path)\r\nprint(type(ustobj))\r\n# <class 'utaupy.ust.Ust'>\r\n```\r\n\r\n---\r\n\r\n## utaupy.otoini\r\n\r\nUTAU\u306e\u539f\u97f3\u8a2d\u5b9a\u30d5\u30a1\u30a4\u30eb\u3092\u6271\u3046\u30e2\u30b8\u30e5\u30fc\u30eb\u3002setParam\u3067\u306e\u5229\u7528\u3092\u60f3\u5b9a\u3002\r\n\r\n---\r\n\r\n### class utaupy.otoini.OtoIni(collections.UserList)\r\n\r\noto.ini \u30d5\u30a1\u30a4\u30eb\u3092\u6271\u3046\u305f\u3081\u306e\u30af\u30e9\u30b9\u3002\r\n\r\n---\r\n\r\n### class utaupy.otoini.Oto(collections.UserDict)\r\n\r\noto.ini \u306b\u542b\u307e\u308c\u308b\u5404\u539f\u97f3\u306e\u30d1\u30e9\u30e1\u30fc\u30bf\u3092\u6271\u3046\u30af\u30e9\u30b9\u3002\r\n\r\n---\r\n\r\n## utaupy.table\r\n\r\n\u304b\u306a\u30ed\u30fc\u30de\u5b57\u5909\u63db\u8868\u306a\u3069\u3092\u6271\u3046\u30e2\u30b8\u30e5\u30fc\u30eb\u3002\r\n\r\n## utaupy.convert\r\n\r\nUst \u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u3001OtoIni \u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u3001Label \u30aa\u30d6\u30b8\u30a7\u30af\u30c8\u306a\u3069\u3092\u5909\u63db\u3059\u308b\u30e2\u30b8\u30e5\u30fc\u30eb\u3002\r\n\r\n## utaupy.reaper\r\n\r\nREAPER (DAW) \u306e\u30ea\u30fc\u30b8\u30e7\u30f3\u30fb\u30de\u30fc\u30ab\u30fc\u7528CSV\u30d5\u30a1\u30a4\u30eb\u3092\u6271\u3046\u30e2\u30b8\u30e5\u30fc\u30eb\u3002\r\n\r\n## utaupy.utau\r\n\r\nUTAU\u30a8\u30c7\u30a3\u30bf\u3067\u884c\u3046\u64cd\u4f5c\u306e\u4ee3\u66ff\u3068\u3001UTAU\u97f3\u6e90\u306e\u539f\u97f3\u5024\u53d6\u5f97\u306a\u3069\u3092\u3059\u308b\u30e2\u30b8\u30e5\u30fc\u30eb\u3002\u300c\u30d1\u30e9\u30e1\u30fc\u30bf\u81ea\u52d5\u8abf\u6574\u300d\u306a\u3069\u304c\u3067\u304d\u308b\u3002\r\n\r\n## utaupy.utauplugin\r\n\r\nUTAU\u30d7\u30e9\u30b0\u30a4\u30f3\u3092\u3064\u304f\u308b\u305f\u3081\u306e\u30e2\u30b8\u30e5\u30fc\u30eb\u3002utaupy.utauplugin.UtauPlugin \u30af\u30e9\u30b9\u306f utaupy.ust.Ust \u3092\u7d99\u627f\u3057\u3001\u30d7\u30e9\u30b0\u30a4\u30f3\u7528\u306b\u6700\u9069\u5316\u3057\u305f\u5b50\u30af\u30e9\u30b9\u3002\r\n\r\n\u4f7f\u7528\u4f8b\u3068\u3057\u3066\u534a\u97f3\u4e0a\u3052\u30d7\u30e9\u30b0\u30a4\u30f3\u3092\u8cbc\u3063\u3066\u304a\u304d\u307e\u3059\u3002\r\n\r\n```Python\r\nimport utaupy\r\n\r\ndef notenum_plus1(utauplugin):\r\n    \"\"\"\r\n    utauplugin: utaupy.utauplugin.UtauPlugin class object\r\n    \u5168\u3066\u306e\u30ce\u30fc\u30c8\u3092\u534a\u97f3\u4e0a\u3052\u308b\r\n    \"\"\"\r\n    # \u5168\u30ce\u30fc\u30c8\u3092\u53d6\u5f97\r\n    notes = utauplugin.notes\r\n    # \u534a\u97f3\u4e0a\u3052\r\n    for note in notes:\r\n        note.notenum += 1\r\n\r\nif __name__ == '__main__':\r\n    # automatically\r\n    # read the utau plugin script\r\n    # load as utaupy.utauplugin.UtauPlugin class object\r\n    # overwrite the utau plugin script\r\n    utaupy.utauplugin.run(notenum_plus1)\r\n```\r\n\r\n\r\n\r\n\r\n\r\n## \u9023\u7d61\u5148\r\n\r\n- Twitter: @oatsu_c\r\n\r\n- GitHub: oatsu-gh\r\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Python3 module for UTAU and singing-databases",
    "version": "1.19.1",
    "project_urls": {
        "Homepage": "https://github.com/oatsu-gh/utaupy"
    },
    "split_keywords": [
        "utau"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "1b042622be5992dc520099da44da4e39299f2eaa28e8bd8859fbfeebb6c1b08b",
                "md5": "68f66f96c31fc3cdfd5a18aa9232431e",
                "sha256": "f97f47c6bd39e1e8ef9dc4fe77c8360e310fefd9013b2399e34a7f9c94224082"
            },
            "downloads": -1,
            "filename": "utaupy-1.19.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "68f66f96c31fc3cdfd5a18aa9232431e",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 50790,
            "upload_time": "2024-09-28T15:47:33",
            "upload_time_iso_8601": "2024-09-28T15:47:33.135798Z",
            "url": "https://files.pythonhosted.org/packages/1b/04/2622be5992dc520099da44da4e39299f2eaa28e8bd8859fbfeebb6c1b08b/utaupy-1.19.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "7525052bcff7212b97df1ff7f1903122133d24a245cb10b23e2e96356f3f800d",
                "md5": "084e1c334d325821d7d1796a3765b84e",
                "sha256": "bd084fed5c12ea78ee72a2480ae05ba8f911079ae29a726d15faa8cf91a9dfdd"
            },
            "downloads": -1,
            "filename": "utaupy-1.19.1.tar.gz",
            "has_sig": false,
            "md5_digest": "084e1c334d325821d7d1796a3765b84e",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 42547,
            "upload_time": "2024-09-28T15:47:35",
            "upload_time_iso_8601": "2024-09-28T15:47:35.306410Z",
            "url": "https://files.pythonhosted.org/packages/75/25/052bcff7212b97df1ff7f1903122133d24a245cb10b23e2e96356f3f800d/utaupy-1.19.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-09-28 15:47:35",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "oatsu-gh",
    "github_project": "utaupy",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [],
    "lcname": "utaupy"
}
oatsu
Elapsed time: 0.31394s