Skip to content

Latest commit

 

History

History
361 lines (228 loc) · 7.9 KB

README.md

File metadata and controls

361 lines (228 loc) · 7.9 KB

blobopera

Tool to download, upload, import, export and analyze Blob Opera data.

Usage:

$ blobopera [OPTIONS] COMMAND [ARGS]...

Options:

  • --public-host TEXT: [default: artsandculture.google.com]
  • --private-host TEXT: [default: cilex-aeiopera.uc.r.appspot.com]
  • --static-host TEXT: [default: gacembed.withgoogle.com]
  • --shortener-host TEXT: [default: g.co]
  • --install-completion: Install completion for the current shell.
  • --show-completion: Show completion for the current shell, to copy it or customize the installation.
  • --help: Show this message and exit.

Commands:

  • jitter: Inspect the default set of audio jitter...
  • libretto: Inspect the default corpus of libretto texts.
  • recording: Operate with recording files and scores.

blobopera jitter

Inspect the default set of audio jitter templates.

Usage:

$ blobopera jitter [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • convert: Convert a file with jitter templates between...
  • download: Download the default file with jitter...
  • generate: Generate pseudorandom jitters from a file...

blobopera jitter convert

Convert a file with jitter templates between internal formats.

Usage:

$ blobopera jitter convert [OPTIONS] INPUT OUTPUT

Arguments:

  • INPUT: [required]
  • OUTPUT: [required]

Options:

  • --format [JSON|BINARY]: [required]
  • --help: Show this message and exit.

blobopera jitter download

Download the default file with jitter templates from the server.

Usage:

$ blobopera jitter download [OPTIONS] OUTPUT

Arguments:

  • OUTPUT: [required]

Options:

  • --format [JSON|BINARY|RAW]: [default: RAW]
  • --help: Show this message and exit.

blobopera jitter generate

Generate pseudorandom jitters from a file with jitter templates.

Usage:

$ blobopera jitter generate [OPTIONS] INPUT OUTPUT

Arguments:

  • INPUT: [required]
  • OUTPUT: [required]

Options:

  • --count INTEGER RANGE
  • --seed INTEGER
  • --help: Show this message and exit.

blobopera libretto

Inspect the default corpus of libretto texts.

Usage:

$ blobopera libretto [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • convert: Convert a corpus of recorded librettos...
  • download: Download the corpus of default recorded...
  • export: Export phonemes of recorded libretto in a...

blobopera libretto convert

Convert a corpus of recorded librettos between internal formats.

Usage:

$ blobopera libretto convert [OPTIONS] INPUT OUTPUT

Arguments:

  • INPUT: [required]
  • OUTPUT: [required]

Options:

  • --format [JSON|BINARY]: [required]
  • --help: Show this message and exit.

blobopera libretto download

Download the corpus of default recorded librettos from the server.

Usage:

$ blobopera libretto download [OPTIONS] OUTPUT

Arguments:

  • OUTPUT: [required]

Options:

  • --format [JSON|BINARY|RAW]: [default: RAW]
  • --help: Show this message and exit.

blobopera libretto export

Export phonemes of recorded libretto in a human-friendly format.

Usage:

$ blobopera libretto export [OPTIONS] INPUT OUTPUT

Arguments:

  • INPUT: [required]
  • OUTPUT: [required]

Options:

  • --help: Show this message and exit.

blobopera recording

Operate with recording files and scores.

Usage:

$ blobopera recording [OPTIONS] COMMAND [ARGS]...

Options:

  • --help: Show this message and exit.

Commands:

  • convert: Convert a recording file between internal...
  • download: Download a recording file from the server.
  • export: Export a recording to a musical score file.
  • import: Import a recording from a musical score file.
  • upload: Upload a recording file to the server.

blobopera recording convert

Convert a recording file between internal formats.

Usage:

$ blobopera recording convert [OPTIONS] INPUT OUTPUT

Arguments:

  • INPUT: [required]
  • OUTPUT: [required]

Options:

  • --format [JSON|BINARY]: [required]
  • --help: Show this message and exit.

blobopera recording download

Download a recording file from the server.

This command tries to download a recording file from the server with the given handle, be it a recording identifier, a link or a short link.

Usage:

$ blobopera recording download [OPTIONS] HANDLE OUTPUT

Arguments:

  • HANDLE: [required]
  • OUTPUT: [required]

Options:

  • --format [JSON|BINARY|RAW]: [default: RAW]
  • --help: Show this message and exit.

blobopera recording export

Export a recording to a musical score file.

This command tries to recreate a musical score from a given recording file, converting phonemes to lyrics whenever possible (not supported for the MIDI format) and mapping times and pitches to actual notes and rests.

Usage:

$ blobopera recording export [OPTIONS] INPUT OUTPUT

Arguments:

  • INPUT: [required]
  • OUTPUT: [required]

Options:

  • --format [MUSICXML|MIDI|RAW]: [default: MUSICXML]
  • --help: Show this message and exit.

blobopera recording import

Import a recording from a musical score file.

This command tries to create a recording file from a musical score, resorting to the provided options to adjust the result.

Options: Theme: the festive theme adds fluffy red and white hats to singers and shows a falling snow animation through the entire scene.

Format: the output format used for the recording file.

Language: this language will be used to interpret the score lyrics and
calculate the most accurate phonemes for each syllable; the random
language builds random syllables from vowel + consonant pairs for
every note.

Default: a phoneme used to fill parts that don't have lyrics at all;
silence will mute the affected voices, and any other value will
make them sing a single vowel with the note pitches.

Parts: for pieces with a number of parts other than four, these
options will define which parts are used for which voices; 0 means
the first (topmost) part, 1 the second, -1 the last, -2 the
penultimate, et cetera.

Tempo: this value modifies the global tempo by the specified amount;
0.5 would slow down the piece to half its original speed, and 2.0
would make it twice as quicker.

Location: the location (i.e. background image) of the recording, like
e.g. Seoul or London.

Usage:

$ blobopera recording import [OPTIONS] INPUT OUTPUT

Arguments:

  • INPUT: [required]
  • OUTPUT: [required]

Options:

  • --format [BINARY|JSON]: [default: BINARY]
  • --theme [NORMAL|CHRISTMAS|NEWYEARS]: [default: NORMAL]
  • --language [GENERIC|RANDOM]: [default: GENERIC]
  • --fill [SILENCE|A|E|I|O|U]: [default: U]
  • --location [BLOBPERAHOUSE|LONDON|NEWYORK|HACKNEY|PARIS|CAPETOWN|MEXICOCITY|SEOUL]: [default: BLOBPERAHOUSE]
  • --soprano-part INTEGER: [default: 0]
  • --alto-part INTEGER: [default: 1]
  • --tenor-part INTEGER: [default: -2]
  • --bass-part INTEGER: [default: -1]
  • --tempo FLOAT: [default: 1.0]
  • --help: Show this message and exit.

blobopera recording upload

Upload a recording file to the server.

This command tries to upload the given recording file to the server and return its handle in one of these variants:

IDENTIFIER: displays the raw recording identifier as returned by the server.

LINK: displays a full link to the recording player, including the encoded recording identifier as a parameter.

SHORT: displays a shortened version of the aforementioned link.

Usage:

$ blobopera recording upload [OPTIONS] INPUT

Arguments:

  • INPUT: [required]

Options:

  • --handle [IDENTIFIER|LINK|SHORT]: [default: SHORT]
  • --help: Show this message and exit.