suibianp / ust2lrc

A tool to generate basic/advanced lyric file from existing UTAU project.

ust2lrc

Introduction

A tool to generate simple/enhanced lyric file from existing UTAU project.

This application is programmed with compability in mind, i.e., using only platform-independent C standard libraries. However, kindly notice that strdup() is only merged into mainline ISO C standard since C2x.

Throretically, it could be utilised as an UTAU plugin as well, whose plugin.txt will be released later. FYI, as a plugin, statement of "notes=all" in plugin.txt or selecting all before execution is compulsory, or the lyric of [#NEXT] will overwrite the lyric of its preceding note.

Functionality

This program runs in a shell environment. In Windows it could be executed in command prompt or ust file drag-and-drop.

Usage syntax: ust2lrc <ust file> [[-a|-b] [<delimiters> [<threshold>]]]
Examples

• ust2lrc source.ust -a R,r 240
  
• ust2lrc this.ust -a "a R,i R,u R,e R,o R"
  
• ust2lrc "C:\Program Files\input.ust"
  
• ust2lrc D:\whatever.ust -b

-a refers to enhanced lyric output, where the delimiters of each lyric line (possibly with their length threshold) are specified in the succeeding arguments.
-b refers to simple lyric output, with each note treated as a separate lyric line.

You may want to use quotes or escape characters to pass an argument containing white character(s).

If the third argument is not specified, the program will interact with the user to acquire necessary arguments via command line.

Acknowledgements

Gloomy Ghost（蚊香豹） for CMake compile script
Ray Lum（瑞洛凩） for the constructive idea of interactive operation
Rye-Catcher for kind guidance regarding memory allocation
shine_5402（数字君） for suggestions on economic and elegant programming
UTAU ユーザー互助会@ ウィキ for general knowledge about UTAU plugin development