@nodaro/cli 1.3.0 → 1.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +26 -0
- package/dist/index.js +646 -40
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/dist/index.js
CHANGED
|
@@ -5,7 +5,7 @@ import { stdout, stdin } from 'process';
|
|
|
5
5
|
import pc3 from 'picocolors';
|
|
6
6
|
import { writeFileSync, readFileSync, existsSync, mkdirSync, chmodSync } from 'fs';
|
|
7
7
|
import { hostname, platform, homedir } from 'os';
|
|
8
|
-
import { join } from 'path';
|
|
8
|
+
import { extname, basename, join } from 'path';
|
|
9
9
|
import { createServer } from 'http';
|
|
10
10
|
import { randomBytes } from 'crypto';
|
|
11
11
|
import { spawn } from 'child_process';
|
|
@@ -29,7 +29,7 @@ var require_package = __commonJS({
|
|
|
29
29
|
"package.json"(exports$1, module) {
|
|
30
30
|
module.exports = {
|
|
31
31
|
name: "@nodaro/cli",
|
|
32
|
-
version: "1.
|
|
32
|
+
version: "1.4.0",
|
|
33
33
|
description: "Command-line interface for Nodaro \u2014 list and run workflows, inspect jobs and executions, manage projects from the terminal.",
|
|
34
34
|
type: "module",
|
|
35
35
|
license: "Apache-2.0",
|
|
@@ -70,7 +70,7 @@ var require_package = __commonJS({
|
|
|
70
70
|
"@inquirer/confirm": "^6.0.12",
|
|
71
71
|
"@inquirer/input": "^5.0.12",
|
|
72
72
|
"@inquirer/select": "^5.1.4",
|
|
73
|
-
"@nodaro/sdk": "^1.
|
|
73
|
+
"@nodaro/sdk": "^1.6.0",
|
|
74
74
|
"@nodaro/shared": "^1.9.0",
|
|
75
75
|
commander: "^12.1.0",
|
|
76
76
|
picocolors: "^1.1.1",
|
|
@@ -527,11 +527,28 @@ async function watchUntilTerminal(opts) {
|
|
|
527
527
|
if (opts.json) emit(result.data, opts);
|
|
528
528
|
else if (status === "completed") success(`completed in ${elapsed(start)}s`);
|
|
529
529
|
else process.exit(status === "failed" ? 2 : 130);
|
|
530
|
-
return;
|
|
530
|
+
return result;
|
|
531
531
|
}
|
|
532
532
|
await sleep(intervalMs);
|
|
533
533
|
}
|
|
534
534
|
}
|
|
535
|
+
async function reportQueuedJob(result, fetchJob, opts) {
|
|
536
|
+
if (opts.json && !opts.watch) {
|
|
537
|
+
emit(result, opts);
|
|
538
|
+
return void 0;
|
|
539
|
+
}
|
|
540
|
+
success(`job ${result.jobId} queued${opts.note ? ` (${opts.note})` : ""}`);
|
|
541
|
+
if (!opts.watch) {
|
|
542
|
+
dim(`follow: nodaro jobs get ${result.jobId}`);
|
|
543
|
+
return void 0;
|
|
544
|
+
}
|
|
545
|
+
return watchUntilTerminal({
|
|
546
|
+
fetch: fetchJob,
|
|
547
|
+
label: result.jobId,
|
|
548
|
+
intervalMs: opts.pollInterval,
|
|
549
|
+
json: opts.json
|
|
550
|
+
});
|
|
551
|
+
}
|
|
535
552
|
function elapsed(startMs) {
|
|
536
553
|
return ((Date.now() - startMs) / 1e3).toFixed(1);
|
|
537
554
|
}
|
|
@@ -697,7 +714,7 @@ function workflowsCommand() {
|
|
|
697
714
|
return cmd;
|
|
698
715
|
}
|
|
699
716
|
async function watchExecution(client, executionId, opts) {
|
|
700
|
-
|
|
717
|
+
await watchUntilTerminal({
|
|
701
718
|
fetch: () => client.executions.get(executionId),
|
|
702
719
|
label: executionId,
|
|
703
720
|
...opts
|
|
@@ -1567,9 +1584,68 @@ function promptCommand() {
|
|
|
1567
1584
|
});
|
|
1568
1585
|
return cmd;
|
|
1569
1586
|
}
|
|
1587
|
+
var FX_PRESETS = "room|bathroom|car|hall|concert-hall|church|cave|arena|outdoor|telephone|megaphone|echo|custom";
|
|
1588
|
+
var AUDIO_CONTENT_TYPES = {
|
|
1589
|
+
".mp3": "audio/mpeg",
|
|
1590
|
+
".wav": "audio/wav",
|
|
1591
|
+
".m4a": "audio/mp4",
|
|
1592
|
+
".aac": "audio/aac",
|
|
1593
|
+
".ogg": "audio/ogg",
|
|
1594
|
+
".flac": "audio/flac",
|
|
1595
|
+
".webm": "audio/webm"
|
|
1596
|
+
};
|
|
1597
|
+
function buildVoiceFx(opts) {
|
|
1598
|
+
if ((opts.voiceFxMix !== void 0 || opts.voiceFxDelay !== void 0 || opts.voiceFxDecay !== void 0) && !opts.voiceFx) {
|
|
1599
|
+
warn("--voice-fx-mix / --voice-fx-delay / --voice-fx-decay require --voice-fx <preset>");
|
|
1600
|
+
process.exit(1);
|
|
1601
|
+
}
|
|
1602
|
+
return opts.voiceFx ? {
|
|
1603
|
+
preset: opts.voiceFx,
|
|
1604
|
+
...opts.voiceFxMix !== void 0 ? { wetDryMix: opts.voiceFxMix } : {},
|
|
1605
|
+
...opts.voiceFxDelay !== void 0 ? { delayMs: opts.voiceFxDelay } : {},
|
|
1606
|
+
...opts.voiceFxDecay !== void 0 ? { decay: opts.voiceFxDecay } : {}
|
|
1607
|
+
} : void 0;
|
|
1608
|
+
}
|
|
1609
|
+
function readJsonFlag(inline, file, flagBase) {
|
|
1610
|
+
if (inline && file) {
|
|
1611
|
+
warn(`--${flagBase}-json and --${flagBase}-file are mutually exclusive \u2014 pass one`);
|
|
1612
|
+
process.exit(1);
|
|
1613
|
+
}
|
|
1614
|
+
const raw = file ? readFileSync(file, "utf8") : inline;
|
|
1615
|
+
if (raw === void 0) return void 0;
|
|
1616
|
+
try {
|
|
1617
|
+
return JSON.parse(raw);
|
|
1618
|
+
} catch {
|
|
1619
|
+
warn(`--${flagBase}-${file ? "file" : "json"} is not valid JSON`);
|
|
1620
|
+
process.exit(1);
|
|
1621
|
+
}
|
|
1622
|
+
}
|
|
1623
|
+
function renderAnalyzeOutput(outputData) {
|
|
1624
|
+
const out = outputData ?? {};
|
|
1625
|
+
if (out.suggestedTitle) info(`title: ${out.suggestedTitle}`);
|
|
1626
|
+
if (out.languageCode) {
|
|
1627
|
+
const p = out.languageProbability !== void 0 ? ` (confidence ${out.languageProbability.toFixed(2)})` : "";
|
|
1628
|
+
info(`language: ${out.languageCode}${p}`);
|
|
1629
|
+
}
|
|
1630
|
+
const speakers = Array.isArray(out.speakers) ? out.speakers : [];
|
|
1631
|
+
table(
|
|
1632
|
+
speakers.map((s, i) => ({
|
|
1633
|
+
"#": i + 1,
|
|
1634
|
+
id: s.id,
|
|
1635
|
+
"first heard": s.firstStartSec !== void 0 ? `${s.firstStartSec.toFixed(1)}s` : "",
|
|
1636
|
+
words: s.wordCount,
|
|
1637
|
+
snippet: s.snippet
|
|
1638
|
+
})),
|
|
1639
|
+
["#", "id", "first heard", "words", "snippet"]
|
|
1640
|
+
);
|
|
1641
|
+
if (out.vocalsUrl) dim(`vocals stem: ${out.vocalsUrl}`);
|
|
1642
|
+
if (out.backgroundUrl) dim(`background stem: ${out.backgroundUrl}`);
|
|
1643
|
+
dim("next: nodaro voice recast --voices <v1,v2,...> maps entry N to speaker #N (`keep` keeps a speaker's original voice).");
|
|
1644
|
+
dim(" save this job's output_data as a JSON file and pass --analysis-file <path> to skip re-detection.");
|
|
1645
|
+
}
|
|
1570
1646
|
function voiceCommand() {
|
|
1571
1647
|
const cmd = new Command("voice").description("voice tools \u2014 revoice an audio track or a whole talking video");
|
|
1572
|
-
cmd.command("changer").alias("change").description("replace the voice in an audio track (--audio) or a talking video (--video) with a different voice").requiredOption("--voice <id>", "target voice \u2014 premade name (Rachel, Aria, Roger, ...) or an ElevenLabs clone UUID").option("--audio <url>", "audio URL to revoice (audio \u2192 audio)").option("--video <url>", "video URL to revoice (returns the video + the new audio track). Wins over --audio when both are given.").option("--stability <n>", "voice stability 0..1", parseFloat).option("--similarity <n>", "similarity boost 0..1", parseFloat).option("--style <n>", "style exaggeration 0..1 \u2014 amplifies the source's delivery (default 0; higher adds latency / less stable)", parseFloat).option("--remove-background-noise", "clean, voice-only output; omit to keep the music/SFX bed under the new voice").option("--watch", "poll until the job completes").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").addHelpText("after", `
|
|
1648
|
+
cmd.command("changer").alias("change").description("replace the voice in an audio track (--audio) or a talking video (--video) with a different voice").requiredOption("--voice <id>", "target voice \u2014 premade name (Rachel, Aria, Roger, ...) or an ElevenLabs clone UUID").option("--audio <url>", "audio URL to revoice (audio \u2192 audio)").option("--video <url>", "video URL to revoice (returns the video + the new audio track). Wins over --audio when both are given.").option("--model <id>", "speech-to-speech model override").option("--stability <n>", "voice stability 0..1", parseFloat).option("--similarity <n>", "similarity boost 0..1", parseFloat).option("--style <n>", "style exaggeration 0..1 \u2014 amplifies the source's delivery (default 0; higher adds latency / less stable)", parseFloat).option("--use-speaker-boost", "sharpen fidelity to the target speaker (small latency cost)").option("--seed <n>", "deterministic speech-to-speech seed for reproducible output (integer)", (v) => parseInt(v, 10)).option("--remove-background-noise", "clean, voice-only output; omit to keep the music/SFX bed under the new voice").option("--watch", "poll until the job completes").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").addHelpText("after", `
|
|
1573
1649
|
Examples:
|
|
1574
1650
|
$ nodaro voice changer --audio https://.../speech.mp3 --voice Rachel --watch
|
|
1575
1651
|
$ nodaro voice changer --video https://.../talking.mp4 --voice Aria --watch
|
|
@@ -1585,26 +1661,17 @@ Examples:
|
|
|
1585
1661
|
voiceId: opts.voice,
|
|
1586
1662
|
audioUrl: opts.audio,
|
|
1587
1663
|
videoUrl: opts.video,
|
|
1664
|
+
model: opts.model,
|
|
1588
1665
|
stability: opts.stability,
|
|
1589
1666
|
similarityBoost: opts.similarity,
|
|
1590
1667
|
style: opts.style,
|
|
1668
|
+
useSpeakerBoost: opts.useSpeakerBoost,
|
|
1669
|
+
seed: opts.seed,
|
|
1591
1670
|
removeBackgroundNoise: opts.removeBackgroundNoise
|
|
1592
1671
|
});
|
|
1593
|
-
|
|
1594
|
-
|
|
1595
|
-
|
|
1596
|
-
return;
|
|
1597
|
-
}
|
|
1598
|
-
success(`job ${jobId} queued (${opts.video ? "video" : "audio"} mode)`);
|
|
1599
|
-
if (!opts.watch) {
|
|
1600
|
-
dim(`follow: nodaro jobs get ${jobId}`);
|
|
1601
|
-
return;
|
|
1602
|
-
}
|
|
1603
|
-
await watchUntilTerminal({
|
|
1604
|
-
fetch: () => client.jobs.get(jobId),
|
|
1605
|
-
label: jobId,
|
|
1606
|
-
intervalMs: opts.pollInterval,
|
|
1607
|
-
...opts
|
|
1672
|
+
await reportQueuedJob(result, () => client.jobs.get(result.jobId), {
|
|
1673
|
+
...opts,
|
|
1674
|
+
note: `${opts.video ? "video" : "audio"} mode`
|
|
1608
1675
|
});
|
|
1609
1676
|
} catch (err) {
|
|
1610
1677
|
handleError(err);
|
|
@@ -1619,13 +1686,16 @@ Examples:
|
|
|
1619
1686
|
).option(
|
|
1620
1687
|
"--voices-json <json>",
|
|
1621
1688
|
`JSON array for per-voice settings \u2014 entries are a voice id string, a {"voiceId","stability","similarityBoost","style","useSpeakerBoost","seed","volumeMode","volume"} object, or null to keep that speaker's original voice`
|
|
1622
|
-
).option("--model <id>", "speech-to-speech model override").option("--no-preserve-background", "drop the separated music/SFX bed for a clean voice-only result (kept by default)").option("--separation-quality <q>", "voice/music separation quality: fast (default) or best").option("--music-volume-mode <mode>", "preserved background level: match (default), normalize, or manual").option("--music-volume <n>", "background level % (0-200) when --music-volume-mode is manual", parseFloat).option("--remove-background-noise", "denoise for a cleaner voice-only result").option("--voice-fx <preset>",
|
|
1689
|
+
).option("--model <id>", "speech-to-speech model override").option("--output <mode>", "output mode: video (default \u2014 merged, rendered result) or stems (dry per-track stems for an interactive mix; render later with `voice export`)").option("--analysis-json <json>", "a completed `voice analyze` job's output_data, inline \u2014 skips re-detection (the interactive-flow fast-path)").option("--analysis-file <path>", "same as --analysis-json but read from a JSON file").option("--no-preserve-background", "drop the separated music/SFX bed for a clean voice-only result (kept by default)").option("--separation-quality <q>", "voice/music separation quality: fast (default) or best").option("--music-volume-mode <mode>", "preserved background level: match (default), normalize, or manual").option("--music-volume <n>", "background level % (0-200) when --music-volume-mode is manual", parseFloat).option("--remove-background-noise", "denoise for a cleaner voice-only result").option("--voice-fx <preset>", `reverb/echo on the combined recast voices: ${FX_PRESETS}`).option("--voice-fx-mix <n>", "reverb wet/dry mix % (0-100) \u2014 reverb presets", parseFloat).option("--voice-fx-delay <ms>", "echo delay in ms (20-2000) \u2014 echo/custom presets", (v) => parseInt(v, 10)).option("--voice-fx-decay <n>", "echo decay (0-1) \u2014 echo/custom presets", parseFloat).option("--watch", "poll until the job completes").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").addHelpText("after", `
|
|
1623
1690
|
Examples:
|
|
1624
1691
|
$ nodaro voice recast --audio https://.../podcast.mp3 --voices Rachel,Aria --watch
|
|
1625
1692
|
$ nodaro voice recast --video https://.../panel.mp4 --voices Rachel,keep,Aria --watch
|
|
1626
1693
|
# speaker 1 \u2192 Rachel, speaker 2 keeps their original voice, speaker 3 \u2192 Aria
|
|
1627
1694
|
$ nodaro voice recast --audio https://.../ad.mp3 \\
|
|
1628
|
-
--voices-json '[{"voiceId":"Rachel","stability":0.6},null,"Aria"]' --no-preserve-background
|
|
1695
|
+
--voices-json '[{"voiceId":"Rachel","stability":0.6},null,"Aria"]' --no-preserve-background
|
|
1696
|
+
$ nodaro voice recast --video https://.../panel.mp4 --voices Rachel,Aria \\
|
|
1697
|
+
--analysis-file analysis.json --output stems --watch
|
|
1698
|
+
# interactive flow: reuse a \`voice analyze\` result, get dry stems to mix, render with \`voice export\``).action(
|
|
1629
1699
|
async (opts) => {
|
|
1630
1700
|
try {
|
|
1631
1701
|
if (!opts.audio && !opts.video) {
|
|
@@ -1640,6 +1710,10 @@ Examples:
|
|
|
1640
1710
|
warn("Provide --voices <v1,v2,...> (use `keep` to keep a speaker's original voice) or --voices-json <json>");
|
|
1641
1711
|
process.exit(1);
|
|
1642
1712
|
}
|
|
1713
|
+
if (opts.output && opts.output !== "video" && opts.output !== "stems") {
|
|
1714
|
+
warn(`--output must be "video" or "stems" (got "${opts.output}")`);
|
|
1715
|
+
process.exit(1);
|
|
1716
|
+
}
|
|
1643
1717
|
let orderedVoices;
|
|
1644
1718
|
if (opts.voices) {
|
|
1645
1719
|
const entries = opts.voices.split(",").map((s) => s.trim());
|
|
@@ -1666,22 +1740,31 @@ Examples:
|
|
|
1666
1740
|
warn("At least one speaker must get a new voice \u2014 `keep` only marks speakers whose original voice stays");
|
|
1667
1741
|
process.exit(1);
|
|
1668
1742
|
}
|
|
1669
|
-
|
|
1670
|
-
|
|
1671
|
-
|
|
1743
|
+
const voiceFx = buildVoiceFx(opts);
|
|
1744
|
+
const analysisRaw = readJsonFlag(opts.analysisJson, opts.analysisFile, "analysis");
|
|
1745
|
+
let analysis;
|
|
1746
|
+
if (analysisRaw !== void 0) {
|
|
1747
|
+
const a = analysisRaw;
|
|
1748
|
+
if (!a || typeof a !== "object" || Array.isArray(a) || typeof a.vocalsUrl !== "string" || !Array.isArray(a.speakers)) {
|
|
1749
|
+
warn("--analysis-json/--analysis-file must be an analyze result object (vocalsUrl + speakers[]) \u2014 pass a completed `voice analyze` job's output_data");
|
|
1750
|
+
process.exit(1);
|
|
1751
|
+
}
|
|
1752
|
+
analysis = {
|
|
1753
|
+
vocalsUrl: a.vocalsUrl,
|
|
1754
|
+
...a.backgroundUrl !== void 0 ? { backgroundUrl: a.backgroundUrl } : {},
|
|
1755
|
+
speakers: a.speakers,
|
|
1756
|
+
...a.languageCode !== void 0 ? { languageCode: a.languageCode } : {},
|
|
1757
|
+
...a.languageProbability !== void 0 ? { languageProbability: a.languageProbability } : {}
|
|
1758
|
+
};
|
|
1672
1759
|
}
|
|
1673
|
-
const voiceFx = opts.voiceFx ? {
|
|
1674
|
-
preset: opts.voiceFx,
|
|
1675
|
-
...opts.voiceFxMix !== void 0 ? { wetDryMix: opts.voiceFxMix } : {},
|
|
1676
|
-
...opts.voiceFxDelay !== void 0 ? { delayMs: opts.voiceFxDelay } : {},
|
|
1677
|
-
...opts.voiceFxDecay !== void 0 ? { decay: opts.voiceFxDecay } : {}
|
|
1678
|
-
} : void 0;
|
|
1679
1760
|
const client = buildClient(opts.profile);
|
|
1680
1761
|
const input2 = {
|
|
1681
1762
|
orderedVoices,
|
|
1682
1763
|
// Video wins when both are given (matches the route + `voice changer`).
|
|
1683
1764
|
...opts.video ? { videoUrl: opts.video } : { audioUrl: opts.audio },
|
|
1684
1765
|
...opts.model ? { model: opts.model } : {},
|
|
1766
|
+
...opts.output ? { output: opts.output } : {},
|
|
1767
|
+
...analysis ? { analysis } : {},
|
|
1685
1768
|
// Only sent when --no-preserve-background was used; otherwise omitted
|
|
1686
1769
|
// so the server default (true) applies.
|
|
1687
1770
|
...opts.preserveBackground === false ? { preserveBackground: false } : {},
|
|
@@ -1692,21 +1775,542 @@ Examples:
|
|
|
1692
1775
|
...voiceFx ? { voiceFx } : {}
|
|
1693
1776
|
};
|
|
1694
1777
|
const result = await client.voices.recast(input2);
|
|
1695
|
-
|
|
1778
|
+
await reportQueuedJob(result, () => client.jobs.get(result.jobId), {
|
|
1779
|
+
...opts,
|
|
1780
|
+
note: `${opts.video ? "video" : "audio"} mode${opts.output === "stems" ? ", stems output" : ""}`
|
|
1781
|
+
});
|
|
1782
|
+
} catch (err) {
|
|
1783
|
+
handleError(err);
|
|
1784
|
+
}
|
|
1785
|
+
}
|
|
1786
|
+
);
|
|
1787
|
+
cmd.command("analyze").description(
|
|
1788
|
+
"detect the speakers in a clip WITHOUT recasting (Voice Changer Pro, Cloud only) \u2014 the first step of the interactive flow: pick voices against the printed speaker list, then `voice recast`"
|
|
1789
|
+
).option("--audio <url>", "audio URL to analyze").option("--video <url>", "video URL to analyze (its audio track is used). Wins over --audio when both are given.").option("--separation-quality <q>", "voice/music separation quality: fast (default) or best").option("--suggest-title", "also suggest a title for the clip from its transcript").option("--watch", "poll until the job completes, then print the detected speakers").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").addHelpText("after", `
|
|
1790
|
+
Examples:
|
|
1791
|
+
$ nodaro voice analyze --video https://.../panel.mp4 --watch
|
|
1792
|
+
$ nodaro voice analyze --audio https://.../podcast.mp3 --separation-quality best --suggest-title --watch
|
|
1793
|
+
|
|
1794
|
+
The completed job's output_data carries the separated stems + the speaker list;
|
|
1795
|
+
save it to a file and pass it to \`voice recast --analysis-file\` to skip re-detection.`).action(
|
|
1796
|
+
async (opts) => {
|
|
1797
|
+
try {
|
|
1798
|
+
if (!opts.audio && !opts.video) {
|
|
1799
|
+
warn("Provide --audio <url> or --video <url> (one is required)");
|
|
1800
|
+
process.exit(1);
|
|
1801
|
+
}
|
|
1802
|
+
const client = buildClient(opts.profile);
|
|
1803
|
+
const result = await client.voices.analyze({
|
|
1804
|
+
// Video wins when both are given (matches `voice recast`).
|
|
1805
|
+
...opts.video ? { videoUrl: opts.video } : { audioUrl: opts.audio },
|
|
1806
|
+
...opts.separationQuality ? { separationQuality: opts.separationQuality } : {},
|
|
1807
|
+
...opts.suggestTitle ? { suggestTitle: true } : {}
|
|
1808
|
+
});
|
|
1809
|
+
const terminal = await reportQueuedJob(result, () => client.jobs.get(result.jobId), {
|
|
1810
|
+
...opts,
|
|
1811
|
+
note: "speaker detection"
|
|
1812
|
+
});
|
|
1813
|
+
if (terminal && !opts.json && terminal.data.status === "completed") {
|
|
1814
|
+
renderAnalyzeOutput(terminal.data.output_data);
|
|
1815
|
+
}
|
|
1816
|
+
} catch (err) {
|
|
1817
|
+
handleError(err);
|
|
1818
|
+
}
|
|
1819
|
+
}
|
|
1820
|
+
);
|
|
1821
|
+
cmd.command("export").description(
|
|
1822
|
+
"render the final video from a mixed set of stems (Voice Changer Pro, Cloud only) \u2014 the last step of the interactive flow, after `voice recast --output stems`"
|
|
1823
|
+
).requiredOption("--source <url>", "the source video to remux the mixed audio onto (stream-copied, never re-encoded)").option("--tracks-json <json>", 'the mix, inline \u2014 a JSON array of { "url", "gain" (0-200), "muted", "kind"? ("voice"|"background") } lanes (max 16)').option("--tracks-file <path>", "same as --tracks-json but read from a JSON file").option("--voice-fx <preset>", `reverb/echo on the voice lanes at render time: ${FX_PRESETS}`).option("--voice-fx-mix <n>", "reverb wet/dry mix % (0-100) \u2014 reverb presets", parseFloat).option("--voice-fx-delay <ms>", "echo delay in ms (20-2000) \u2014 echo/custom presets", (v) => parseInt(v, 10)).option("--voice-fx-decay <n>", "echo decay (0-1) \u2014 echo/custom presets", parseFloat).option("--watch", "poll until the job completes").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").addHelpText("after", `
|
|
1824
|
+
Examples:
|
|
1825
|
+
$ nodaro voice export --source https://.../panel.mp4 --tracks-file mix.json --watch
|
|
1826
|
+
$ nodaro voice export --source https://.../panel.mp4 --voice-fx hall --voice-fx-mix 30 \\
|
|
1827
|
+
--tracks-json '[{"url":"https://.../s0.mp3","gain":100,"muted":false},
|
|
1828
|
+
{"url":"https://.../bg.mp3","gain":80,"muted":false,"kind":"background"}]'
|
|
1829
|
+
|
|
1830
|
+
Track urls come from a \`voice recast --output stems\` job's output_data. --voice-fx
|
|
1831
|
+
lands on the voice lanes only (never a "background" lane).`).action(
|
|
1832
|
+
async (opts) => {
|
|
1833
|
+
try {
|
|
1834
|
+
const parsed = readJsonFlag(opts.tracksJson, opts.tracksFile, "tracks");
|
|
1835
|
+
if (parsed === void 0) {
|
|
1836
|
+
warn("Provide --tracks-json <json> or --tracks-file <path> \u2014 the mix's track list");
|
|
1837
|
+
process.exit(1);
|
|
1838
|
+
}
|
|
1839
|
+
if (!Array.isArray(parsed) || parsed.length === 0 || !parsed.every((t) => t !== null && typeof t === "object" && !Array.isArray(t) && typeof t.url === "string")) {
|
|
1840
|
+
warn('tracks must be a non-empty JSON array of { "url", "gain", "muted", "kind"? } objects');
|
|
1841
|
+
process.exit(1);
|
|
1842
|
+
}
|
|
1843
|
+
const tracks = parsed;
|
|
1844
|
+
if (tracks.every((t) => t.muted === true)) {
|
|
1845
|
+
warn("At least one track must be un-muted \u2014 an all-muted mix renders silence and the server rejects it");
|
|
1846
|
+
process.exit(1);
|
|
1847
|
+
}
|
|
1848
|
+
const voiceFx = buildVoiceFx(opts);
|
|
1849
|
+
const client = buildClient(opts.profile);
|
|
1850
|
+
const input2 = {
|
|
1851
|
+
videoUrl: opts.source,
|
|
1852
|
+
tracks,
|
|
1853
|
+
...voiceFx ? { voiceFx } : {}
|
|
1854
|
+
};
|
|
1855
|
+
const result = await client.voices.exportMix(input2);
|
|
1856
|
+
await reportQueuedJob(result, () => client.jobs.get(result.jobId), {
|
|
1857
|
+
...opts,
|
|
1858
|
+
note: `${tracks.length} track${tracks.length === 1 ? "" : "s"}`
|
|
1859
|
+
});
|
|
1860
|
+
} catch (err) {
|
|
1861
|
+
handleError(err);
|
|
1862
|
+
}
|
|
1863
|
+
}
|
|
1864
|
+
);
|
|
1865
|
+
cmd.command("design").description("design a brand-new synthetic voice from a text description (ElevenLabs text-to-voice)").requiredOption("--text <line>", "a preview line (100-1000 chars) spoken in the designed voice").requiredOption("--description <desc>", "natural-language description of the voice to create").option("--model <id>", "voice-design model override").option("--loudness <n>", "output loudness (-1..1)", parseFloat).option("--guidance-scale <n>", "how strongly the description steers the design (0-100)", parseFloat).option("--seed <n>", "deterministic seed for a reproducible design (integer)", (v) => parseInt(v, 10)).option("--quality <n>", "design quality knob (provider-specific)", parseFloat).option("--enhance", "enhance the generated voice").option("--user-prompt <text>", "optional extra prompt context").option("--watch", "poll until the job completes").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").addHelpText("after", `
|
|
1866
|
+
Example:
|
|
1867
|
+
$ nodaro voice design --description "a warm, gravelly narrator in his 60s" \\
|
|
1868
|
+
--text "Some stories don't begin at the beginning; they begin the moment everything changes, and this one is no different." --watch`).action(
|
|
1869
|
+
async (opts) => {
|
|
1870
|
+
try {
|
|
1871
|
+
const client = buildClient(opts.profile);
|
|
1872
|
+
const result = await client.voices.design({
|
|
1873
|
+
text: opts.text,
|
|
1874
|
+
voiceDescription: opts.description,
|
|
1875
|
+
...opts.model ? { model: opts.model } : {},
|
|
1876
|
+
...opts.loudness !== void 0 ? { loudness: opts.loudness } : {},
|
|
1877
|
+
...opts.guidanceScale !== void 0 ? { guidanceScale: opts.guidanceScale } : {},
|
|
1878
|
+
...opts.seed !== void 0 ? { seed: opts.seed } : {},
|
|
1879
|
+
...opts.quality !== void 0 ? { quality: opts.quality } : {},
|
|
1880
|
+
...opts.enhance ? { shouldEnhance: true } : {},
|
|
1881
|
+
...opts.userPrompt ? { userPrompt: opts.userPrompt } : {}
|
|
1882
|
+
});
|
|
1883
|
+
await reportQueuedJob(result, () => client.jobs.get(result.jobId), { ...opts, note: "voice design" });
|
|
1884
|
+
} catch (err) {
|
|
1885
|
+
handleError(err);
|
|
1886
|
+
}
|
|
1887
|
+
}
|
|
1888
|
+
);
|
|
1889
|
+
cmd.command("remix").description("speak a text in a voice described in natural language, without cloning (ElevenLabs voice remix)").requiredOption("--text <text>", "the text (1-5000 chars) to speak").requiredOption("--description <desc>", "natural-language description of the voice to speak in").option("--user-prompt <text>", "optional extra prompt context").option("--watch", "poll until the job completes").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").action(
|
|
1890
|
+
async (opts) => {
|
|
1891
|
+
try {
|
|
1892
|
+
const client = buildClient(opts.profile);
|
|
1893
|
+
const result = await client.voices.remix({
|
|
1894
|
+
text: opts.text,
|
|
1895
|
+
voiceDescription: opts.description,
|
|
1896
|
+
...opts.userPrompt ? { userPrompt: opts.userPrompt } : {}
|
|
1897
|
+
});
|
|
1898
|
+
await reportQueuedJob(result, () => client.jobs.get(result.jobId), { ...opts, note: "voice remix" });
|
|
1899
|
+
} catch (err) {
|
|
1900
|
+
handleError(err);
|
|
1901
|
+
}
|
|
1902
|
+
}
|
|
1903
|
+
);
|
|
1904
|
+
cmd.command("dub").description("dub an audio clip into another language while preserving each speaker's voice").requiredOption("--audio <url>", "audio URL to dub").requiredOption("--target-language <code>", 'target language ISO code, e.g. "es", "fr", "pt-BR"').option("--source-language <code>", "source language ISO code (auto-detected when omitted)").option("--num-speakers <n>", "expected number of speakers (1-20) \u2014 improves separation when known", (v) => parseInt(v, 10)).option("--disable-voice-cloning", "keep the original voices instead of cloning them into the target language").option("--drop-background-audio", "drop the background/music bed from the dubbed output").option("--watch", "poll until the job completes").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").addHelpText("after", `
|
|
1905
|
+
Example:
|
|
1906
|
+
$ nodaro voice dub --audio https://.../interview.mp3 --target-language es --num-speakers 2 --watch`).action(
|
|
1907
|
+
async (opts) => {
|
|
1908
|
+
try {
|
|
1909
|
+
const client = buildClient(opts.profile);
|
|
1910
|
+
const result = await client.voices.dub({
|
|
1911
|
+
audioUrl: opts.audio,
|
|
1912
|
+
targetLanguage: opts.targetLanguage,
|
|
1913
|
+
...opts.sourceLanguage ? { sourceLanguage: opts.sourceLanguage } : {},
|
|
1914
|
+
...opts.numSpeakers !== void 0 ? { numSpeakers: opts.numSpeakers } : {},
|
|
1915
|
+
...opts.disableVoiceCloning ? { disableVoiceCloning: true } : {},
|
|
1916
|
+
...opts.dropBackgroundAudio ? { dropBackgroundAudio: true } : {}
|
|
1917
|
+
});
|
|
1918
|
+
await reportQueuedJob(result, () => client.jobs.get(result.jobId), {
|
|
1919
|
+
...opts,
|
|
1920
|
+
note: `dub \u2192 ${opts.targetLanguage}`
|
|
1921
|
+
});
|
|
1922
|
+
} catch (err) {
|
|
1923
|
+
handleError(err);
|
|
1924
|
+
}
|
|
1925
|
+
}
|
|
1926
|
+
);
|
|
1927
|
+
cmd.command("list").description("list the premade voices you can pass to --voice / --voices (or your voice clones with --clones)").option("--clones", "list your voice clones instead of the premade catalog").option("--profile <name>").option("--json").action(async (opts) => {
|
|
1928
|
+
try {
|
|
1929
|
+
const client = buildClient(opts.profile);
|
|
1930
|
+
if (opts.clones) {
|
|
1931
|
+
const clones2 = await client.voices.listClones();
|
|
1932
|
+
if (opts.json) {
|
|
1933
|
+
emit(clones2, opts);
|
|
1934
|
+
return;
|
|
1935
|
+
}
|
|
1936
|
+
table(
|
|
1937
|
+
clones2.map((c) => ({ name: c.name, voice_id: c.elevenlabsVoiceId, clone_id: c.id, created: c.createdAt })),
|
|
1938
|
+
["name", "voice_id", "clone_id", "created"]
|
|
1939
|
+
);
|
|
1940
|
+
dim(`${clones2.length} clone${clones2.length === 1 ? "" : "s"} \u2014 pass voice_id to --voice / --voices`);
|
|
1941
|
+
return;
|
|
1942
|
+
}
|
|
1943
|
+
const voices = await client.voices.list();
|
|
1944
|
+
if (opts.json) {
|
|
1945
|
+
emit(voices, opts);
|
|
1946
|
+
return;
|
|
1947
|
+
}
|
|
1948
|
+
table(
|
|
1949
|
+
voices.map((v) => ({ name: v.name, voice_id: v.voice_id, gender: v.gender, accent: v.accent, age: v.age, category: v.category })),
|
|
1950
|
+
["name", "voice_id", "gender", "accent", "age", "category"]
|
|
1951
|
+
);
|
|
1952
|
+
dim(`${voices.length} premade voice${voices.length === 1 ? "" : "s"} \u2014 pass a name or voice_id to --voice / --voices`);
|
|
1953
|
+
} catch (err) {
|
|
1954
|
+
handleError(err);
|
|
1955
|
+
}
|
|
1956
|
+
});
|
|
1957
|
+
const clones = new Command("clones").description("manage your voice clones (list / create / delete)");
|
|
1958
|
+
clones.command("list").description("list your voice clones").option("--profile <name>").option("--json").action(async (opts) => {
|
|
1959
|
+
try {
|
|
1960
|
+
const client = buildClient(opts.profile);
|
|
1961
|
+
const rows = await client.voices.listClones();
|
|
1962
|
+
if (opts.json) {
|
|
1963
|
+
emit(rows, opts);
|
|
1964
|
+
return;
|
|
1965
|
+
}
|
|
1966
|
+
table(
|
|
1967
|
+
rows.map((c) => ({ name: c.name, voice_id: c.elevenlabsVoiceId, clone_id: c.id, created: c.createdAt })),
|
|
1968
|
+
["name", "voice_id", "clone_id", "created"]
|
|
1969
|
+
);
|
|
1970
|
+
dim(`${rows.length} clone${rows.length === 1 ? "" : "s"} \u2014 pass voice_id to --voice / --voices`);
|
|
1971
|
+
} catch (err) {
|
|
1972
|
+
handleError(err);
|
|
1973
|
+
}
|
|
1974
|
+
});
|
|
1975
|
+
clones.command("create").description("clone a voice from a sample \u2014 an already-uploaded URL (--audio) or a local file (--file). Costs credits.").requiredOption("--name <name>", "name for the new clone").option("--audio <url>", "URL of an uploaded audio sample to clone from").option("--file <path>", "local audio file to upload and clone from (mp3/wav/m4a/aac/ogg/flac/webm)").option("--profile <name>").option("--json").addHelpText("after", `
|
|
1976
|
+
Examples:
|
|
1977
|
+
$ nodaro voice clones create --name "Narrator" --audio https://.../sample.mp3
|
|
1978
|
+
$ nodaro voice clones create --name "Narrator" --file ./sample.wav`).action(async (opts) => {
|
|
1979
|
+
try {
|
|
1980
|
+
if (!opts.audio && !opts.file) {
|
|
1981
|
+
warn("Provide --audio <url> or --file <path> (one is required)");
|
|
1982
|
+
process.exit(1);
|
|
1983
|
+
}
|
|
1984
|
+
if (opts.audio && opts.file) {
|
|
1985
|
+
warn("--audio and --file are mutually exclusive \u2014 pass one");
|
|
1986
|
+
process.exit(1);
|
|
1987
|
+
}
|
|
1988
|
+
const client = buildClient(opts.profile);
|
|
1989
|
+
const clone = opts.file ? await client.voices.createCloneFromFile({
|
|
1990
|
+
name: opts.name,
|
|
1991
|
+
file: readFileSync(opts.file),
|
|
1992
|
+
filename: basename(opts.file),
|
|
1993
|
+
contentType: AUDIO_CONTENT_TYPES[extname(opts.file).toLowerCase()] ?? "audio/mpeg"
|
|
1994
|
+
}) : await client.voices.createClone({ name: opts.name, audioUrl: opts.audio });
|
|
1995
|
+
if (opts.json) {
|
|
1996
|
+
emit(clone, opts);
|
|
1997
|
+
return;
|
|
1998
|
+
}
|
|
1999
|
+
success(`created voice clone "${clone.name}"`);
|
|
2000
|
+
info(`voice_id: ${clone.elevenlabsVoiceId}`);
|
|
2001
|
+
dim(`use it: nodaro voice changer --voice ${clone.elevenlabsVoiceId} --audio <url>`);
|
|
2002
|
+
} catch (err) {
|
|
2003
|
+
handleError(err);
|
|
2004
|
+
}
|
|
2005
|
+
});
|
|
2006
|
+
clones.command("delete <id>").description("delete one of your voice clones (the clone row id, not the voice_id)").option("--profile <name>").option("--json").action(async (id, opts) => {
|
|
2007
|
+
try {
|
|
2008
|
+
const client = buildClient(opts.profile);
|
|
2009
|
+
await client.voices.deleteClone(id);
|
|
2010
|
+
if (opts.json) emit({ id, deleted: true }, opts);
|
|
2011
|
+
else success(`deleted voice clone ${id}`);
|
|
2012
|
+
} catch (err) {
|
|
2013
|
+
handleError(err);
|
|
2014
|
+
}
|
|
2015
|
+
});
|
|
2016
|
+
cmd.addCommand(clones);
|
|
2017
|
+
return cmd;
|
|
2018
|
+
}
|
|
2019
|
+
function parseSection(raw) {
|
|
2020
|
+
const m = raw.match(/^([0-9]+(?:\.[0-9]+)?)-([0-9]+(?:\.[0-9]+)?)$/);
|
|
2021
|
+
const start = m ? parseFloat(m[1]) : NaN;
|
|
2022
|
+
const end = m ? parseFloat(m[2]) : NaN;
|
|
2023
|
+
if (!m || !(start < end)) {
|
|
2024
|
+
warn(`--section must be "<start>-<end>" in seconds with start < end (got "${raw}")`);
|
|
2025
|
+
process.exit(1);
|
|
2026
|
+
}
|
|
2027
|
+
return { sectionStartSec: start, sectionEndSec: end };
|
|
2028
|
+
}
|
|
2029
|
+
function mediaCommand() {
|
|
2030
|
+
const cmd = new Command("media").description(
|
|
2031
|
+
"media ingestion \u2014 pull a social video into storage, trim video/audio, save a URL to storage, probe metadata"
|
|
2032
|
+
);
|
|
2033
|
+
cmd.command("download <url>").description("download a social video (YouTube / TikTok / Instagram / X / Facebook) into your storage").option("--max-height <px>", "cap the resolution (e.g. 720); omit for best available", (v) => parseInt(v, 10)).option("--section <a-b>", 'fetch ONLY this time range in seconds (e.g. "30-90"); the cut lands on keyframes, so pad and trim after').option("--watch", "stream the download's live progress until it completes").option("--profile <name>").option("--json").addHelpText("after", `
|
|
2034
|
+
Examples:
|
|
2035
|
+
$ nodaro media download https://youtu.be/dQw4w9WgXcQ --max-height 720 --watch
|
|
2036
|
+
$ nodaro media download https://youtu.be/dQw4w9WgXcQ --section 30-90 --watch
|
|
2037
|
+
|
|
2038
|
+
The finished file lands in your library. Without --watch, the progress state
|
|
2039
|
+
expires shortly after completion \u2014 there is no job to poll later.`).action(
|
|
2040
|
+
async (url, opts) => {
|
|
2041
|
+
try {
|
|
2042
|
+
const section = opts.section !== void 0 ? parseSection(opts.section) : void 0;
|
|
2043
|
+
const client = buildClient(opts.profile);
|
|
2044
|
+
const result = await client.media.downloadVideo({
|
|
2045
|
+
url,
|
|
2046
|
+
...opts.maxHeight !== void 0 ? { maxHeight: opts.maxHeight } : {},
|
|
2047
|
+
...section ?? {}
|
|
2048
|
+
});
|
|
1696
2049
|
if (opts.json && !opts.watch) {
|
|
1697
2050
|
emit(result, opts);
|
|
1698
2051
|
return;
|
|
1699
2052
|
}
|
|
1700
|
-
success(`
|
|
2053
|
+
success(`download ${result.downloadId} started`);
|
|
1701
2054
|
if (!opts.watch) {
|
|
1702
|
-
dim(
|
|
2055
|
+
dim("re-run with --watch to stream progress (the progress state expires \u2014 start watching promptly)");
|
|
1703
2056
|
return;
|
|
1704
2057
|
}
|
|
1705
|
-
|
|
1706
|
-
|
|
1707
|
-
|
|
1708
|
-
|
|
1709
|
-
|
|
2058
|
+
const start = Date.now();
|
|
2059
|
+
let lastPhase = "";
|
|
2060
|
+
let lastLoggedPercent = -1;
|
|
2061
|
+
let terminal;
|
|
2062
|
+
for await (const ev of client.media.downloadVideoProgress(result.downloadId)) {
|
|
2063
|
+
terminal = ev;
|
|
2064
|
+
if (opts.json) continue;
|
|
2065
|
+
const secs = ((Date.now() - start) / 1e3).toFixed(1);
|
|
2066
|
+
if (ev.phase !== lastPhase) {
|
|
2067
|
+
info(`[${secs}s] ${result.downloadId} \u2192 ${ev.phase}`);
|
|
2068
|
+
lastPhase = ev.phase;
|
|
2069
|
+
lastLoggedPercent = -1;
|
|
2070
|
+
}
|
|
2071
|
+
if (ev.phase === "downloading" && ev.percent - lastLoggedPercent >= 25) {
|
|
2072
|
+
info(`[${secs}s] ${Math.floor(ev.percent)}%`);
|
|
2073
|
+
lastLoggedPercent = ev.percent;
|
|
2074
|
+
}
|
|
2075
|
+
}
|
|
2076
|
+
if (opts.json) {
|
|
2077
|
+
emit(terminal ?? { phase: "failed", percent: 0, error: "progress stream ended without a terminal event" }, opts);
|
|
2078
|
+
if (terminal?.phase !== "completed") process.exit(2);
|
|
2079
|
+
return;
|
|
2080
|
+
}
|
|
2081
|
+
if (terminal?.phase === "completed") {
|
|
2082
|
+
success(`downloaded in ${((Date.now() - start) / 1e3).toFixed(1)}s`);
|
|
2083
|
+
if (terminal.videoUrl) info(`video: ${terminal.videoUrl}`);
|
|
2084
|
+
if (terminal.thumbnailUrl) dim(`thumbnail: ${terminal.thumbnailUrl}`);
|
|
2085
|
+
} else {
|
|
2086
|
+
warn(`download failed: ${terminal?.error ?? "progress stream ended unexpectedly"}`);
|
|
2087
|
+
process.exit(2);
|
|
2088
|
+
}
|
|
2089
|
+
} catch (err) {
|
|
2090
|
+
handleError(err);
|
|
2091
|
+
}
|
|
2092
|
+
}
|
|
2093
|
+
);
|
|
2094
|
+
cmd.command("metadata <url>").description("probe a social video's metadata (duration, dimensions, title, live status) WITHOUT downloading it").option("--profile <name>").option("--json").action(async (url, opts) => {
|
|
2095
|
+
try {
|
|
2096
|
+
const client = buildClient(opts.profile);
|
|
2097
|
+
const meta = await client.media.videoMetadata({ url });
|
|
2098
|
+
if (opts.json) emit(meta, opts);
|
|
2099
|
+
else detail(meta);
|
|
2100
|
+
} catch (err) {
|
|
2101
|
+
handleError(err);
|
|
2102
|
+
}
|
|
2103
|
+
});
|
|
2104
|
+
cmd.command("trim-video").description("trim a video to a range").requiredOption("--video <url>", "video URL to trim").option("--start <sec>", "range start in seconds", parseFloat).option("--end <sec>", "range end in seconds", parseFloat).option("--keep-first <sec>", "keep only the first N seconds", parseFloat).option("--keep-last <sec>", "keep only the last N seconds", parseFloat).option("--watch", "poll until the job completes").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").addHelpText("after", `
|
|
2105
|
+
Examples:
|
|
2106
|
+
$ nodaro media trim-video --video https://.../clip.mp4 --start 12 --end 48 --watch
|
|
2107
|
+
$ nodaro media trim-video --video https://.../clip.mp4 --keep-first 60 --watch`).action(
|
|
2108
|
+
async (opts) => {
|
|
2109
|
+
try {
|
|
2110
|
+
if (opts.start === void 0 && opts.end === void 0 && opts.keepFirst === void 0 && opts.keepLast === void 0) {
|
|
2111
|
+
warn("Provide a range: --start/--end, --keep-first, or --keep-last");
|
|
2112
|
+
process.exit(1);
|
|
2113
|
+
}
|
|
2114
|
+
const client = buildClient(opts.profile);
|
|
2115
|
+
const result = await client.media.trimVideo({
|
|
2116
|
+
videoUrl: opts.video,
|
|
2117
|
+
...opts.start !== void 0 ? { startTime: opts.start } : {},
|
|
2118
|
+
...opts.end !== void 0 ? { endTime: opts.end } : {},
|
|
2119
|
+
...opts.keepFirst !== void 0 ? { keepFirstSeconds: opts.keepFirst } : {},
|
|
2120
|
+
...opts.keepLast !== void 0 ? { keepLastSeconds: opts.keepLast } : {}
|
|
2121
|
+
});
|
|
2122
|
+
await reportQueuedJob(result, () => client.jobs.get(result.jobId), { ...opts, note: "trim video" });
|
|
2123
|
+
} catch (err) {
|
|
2124
|
+
handleError(err);
|
|
2125
|
+
}
|
|
2126
|
+
}
|
|
2127
|
+
);
|
|
2128
|
+
cmd.command("trim-audio").description("trim (and extract) audio from a video or audio source").option("--video <url>", "video URL to extract + trim audio from").option("--audio <url>", "audio URL to trim").option("--start <sec>", "range start in seconds", parseFloat).option("--end <sec>", "range end in seconds", parseFloat).option("--format <fmt>", "output format: mp3 (default), wav, or aac").option("--watch", "poll until the job completes").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").addHelpText("after", `
|
|
2129
|
+
Example:
|
|
2130
|
+
$ nodaro media trim-audio --video https://.../clip.mp4 --start 0 --end 30 --format wav --watch`).action(
|
|
2131
|
+
async (opts) => {
|
|
2132
|
+
try {
|
|
2133
|
+
if (!opts.video && !opts.audio) {
|
|
2134
|
+
warn("Provide --video <url> or --audio <url> (one is required)");
|
|
2135
|
+
process.exit(1);
|
|
2136
|
+
}
|
|
2137
|
+
if (opts.format && !["mp3", "wav", "aac"].includes(opts.format)) {
|
|
2138
|
+
warn(`--format must be mp3, wav, or aac (got "${opts.format}")`);
|
|
2139
|
+
process.exit(1);
|
|
2140
|
+
}
|
|
2141
|
+
const client = buildClient(opts.profile);
|
|
2142
|
+
const result = await client.media.trimAudio({
|
|
2143
|
+
...opts.video ? { videoUrl: opts.video } : {},
|
|
2144
|
+
...opts.audio ? { audioUrl: opts.audio } : {},
|
|
2145
|
+
...opts.start !== void 0 ? { startTime: opts.start } : {},
|
|
2146
|
+
...opts.end !== void 0 ? { endTime: opts.end } : {},
|
|
2147
|
+
...opts.format ? { audioFormat: opts.format } : {}
|
|
2148
|
+
});
|
|
2149
|
+
await reportQueuedJob(result, () => client.jobs.get(result.jobId), { ...opts, note: "trim audio" });
|
|
2150
|
+
} catch (err) {
|
|
2151
|
+
handleError(err);
|
|
2152
|
+
}
|
|
2153
|
+
}
|
|
2154
|
+
);
|
|
2155
|
+
cmd.command("save <url>").description("copy an external media URL into your Nodaro storage (server-side fetch)").option("--filename <name>", "filename to store it under").option("--type <type>", "media type hint: image, video, or audio").option("--watch", "poll until the job completes").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").action(
|
|
2156
|
+
async (url, opts) => {
|
|
2157
|
+
try {
|
|
2158
|
+
if (opts.type && !["image", "video", "audio"].includes(opts.type)) {
|
|
2159
|
+
warn(`--type must be image, video, or audio (got "${opts.type}")`);
|
|
2160
|
+
process.exit(1);
|
|
2161
|
+
}
|
|
2162
|
+
const client = buildClient(opts.profile);
|
|
2163
|
+
const result = await client.media.saveToStorage({
|
|
2164
|
+
mediaUrl: url,
|
|
2165
|
+
...opts.filename ? { filename: opts.filename } : {},
|
|
2166
|
+
...opts.type ? { mediaType: opts.type } : {}
|
|
2167
|
+
});
|
|
2168
|
+
await reportQueuedJob(result, () => client.jobs.get(result.jobId), { ...opts, note: "save to storage" });
|
|
2169
|
+
} catch (err) {
|
|
2170
|
+
handleError(err);
|
|
2171
|
+
}
|
|
2172
|
+
}
|
|
2173
|
+
);
|
|
2174
|
+
return cmd;
|
|
2175
|
+
}
|
|
2176
|
+
var FX_PRESETS2 = "room|bathroom|car|hall|concert-hall|church|cave|arena|outdoor|telephone|megaphone|echo|custom";
|
|
2177
|
+
function parseSegment(raw) {
|
|
2178
|
+
const at = raw.lastIndexOf("@");
|
|
2179
|
+
if (at < 0) return { url: raw };
|
|
2180
|
+
const range = raw.slice(at + 1);
|
|
2181
|
+
const m = range.match(/^([0-9]+(?:\.[0-9]+)?)-([0-9]+(?:\.[0-9]+)?)$/);
|
|
2182
|
+
const start = m ? parseFloat(m[1]) : NaN;
|
|
2183
|
+
const end = m ? parseFloat(m[2]) : NaN;
|
|
2184
|
+
if (!m || !(start < end)) {
|
|
2185
|
+
warn(`--segment range must be "url@<start>-<end>" in seconds with start < end (got "${raw}")`);
|
|
2186
|
+
process.exit(1);
|
|
2187
|
+
}
|
|
2188
|
+
return { url: raw.slice(0, at), startTime: start, endTime: end };
|
|
2189
|
+
}
|
|
2190
|
+
function audioCommand() {
|
|
2191
|
+
const cmd = new Command("audio").description(
|
|
2192
|
+
"audio primitives \u2014 the building blocks Voice Changer Pro composes: separate, isolate, fx, mix, level, combine"
|
|
2193
|
+
);
|
|
2194
|
+
cmd.command("separate").description("separate an audio track into stems (Demucs) \u2014 voice vs music/SFX, or the full stem breakdown").requiredOption("--audio <url>", "audio URL to separate").option("--mode <mode>", "vocal_instrumental (default) or stems (drums/bass/other/\u2026)").option("--quality <q>", "separation quality: auto (default), fast, or best").option("--watch", "poll until the job completes").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").action(
|
|
2195
|
+
async (opts) => {
|
|
2196
|
+
try {
|
|
2197
|
+
if (opts.mode && !["vocal_instrumental", "stems"].includes(opts.mode)) {
|
|
2198
|
+
warn(`--mode must be vocal_instrumental or stems (got "${opts.mode}")`);
|
|
2199
|
+
process.exit(1);
|
|
2200
|
+
}
|
|
2201
|
+
if (opts.quality && !["auto", "fast", "best"].includes(opts.quality)) {
|
|
2202
|
+
warn(`--quality must be auto, fast, or best (got "${opts.quality}")`);
|
|
2203
|
+
process.exit(1);
|
|
2204
|
+
}
|
|
2205
|
+
const client = buildClient(opts.profile);
|
|
2206
|
+
const result = await client.audio.separate({
|
|
2207
|
+
audioUrl: opts.audio,
|
|
2208
|
+
...opts.mode ? { mode: opts.mode } : {},
|
|
2209
|
+
...opts.quality ? { quality: opts.quality } : {}
|
|
2210
|
+
});
|
|
2211
|
+
await reportQueuedJob(result, () => client.jobs.get(result.jobId), { ...opts, note: opts.mode ?? "vocal_instrumental" });
|
|
2212
|
+
} catch (err) {
|
|
2213
|
+
handleError(err);
|
|
2214
|
+
}
|
|
2215
|
+
}
|
|
2216
|
+
);
|
|
2217
|
+
cmd.command("isolate").description("isolate the primary voice and strip background noise (ElevenLabs voice isolation)").requiredOption("--audio <url>", "audio URL to isolate").option("--watch", "poll until the job completes").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").action(async (opts) => {
|
|
2218
|
+
try {
|
|
2219
|
+
const client = buildClient(opts.profile);
|
|
2220
|
+
const result = await client.audio.isolate({ audioUrl: opts.audio });
|
|
2221
|
+
await reportQueuedJob(result, () => client.jobs.get(result.jobId), { ...opts, note: "voice isolation" });
|
|
2222
|
+
} catch (err) {
|
|
2223
|
+
handleError(err);
|
|
2224
|
+
}
|
|
2225
|
+
});
|
|
2226
|
+
cmd.command("fx").description("apply a reverb / echo / telephone / megaphone effect to an audio track \u2014 the same presets VCP's voice-fx uses, standalone").requiredOption("--audio <url>", "audio URL to process").option("--preset <preset>", `effect preset: ${FX_PRESETS2} (server default when omitted)`).option("--mix <n>", "reverb wet/dry mix % (0-100) \u2014 reverb presets", parseFloat).option("--delay <ms>", "echo delay in ms (20-2000) \u2014 echo/custom presets", (v) => parseInt(v, 10)).option("--decay <n>", "echo decay (0-1) \u2014 echo/custom presets", parseFloat).option("--eq-low <db>", "low-shelf gain in dB \u2014 telephone/megaphone shaping", parseFloat).option("--eq-high <db>", "high-shelf gain in dB \u2014 telephone/megaphone shaping", parseFloat).option("--watch", "poll until the job completes").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").addHelpText("after", `
|
|
2227
|
+
Example:
|
|
2228
|
+
$ nodaro audio fx --audio https://.../voice.mp3 --preset hall --mix 35 --watch`).action(
|
|
2229
|
+
async (opts) => {
|
|
2230
|
+
try {
|
|
2231
|
+
const client = buildClient(opts.profile);
|
|
2232
|
+
const result = await client.audio.applyFx({
|
|
2233
|
+
audioUrl: opts.audio,
|
|
2234
|
+
...opts.preset ? { preset: opts.preset } : {},
|
|
2235
|
+
...opts.mix !== void 0 ? { mix: opts.mix } : {},
|
|
2236
|
+
...opts.delay !== void 0 ? { delayMs: opts.delay } : {},
|
|
2237
|
+
...opts.decay !== void 0 ? { decay: opts.decay } : {},
|
|
2238
|
+
...opts.eqLow !== void 0 ? { eqLow: opts.eqLow } : {},
|
|
2239
|
+
...opts.eqHigh !== void 0 ? { eqHigh: opts.eqHigh } : {}
|
|
2240
|
+
});
|
|
2241
|
+
await reportQueuedJob(result, () => client.jobs.get(result.jobId), { ...opts, note: opts.preset ?? "audio fx" });
|
|
2242
|
+
} catch (err) {
|
|
2243
|
+
handleError(err);
|
|
2244
|
+
}
|
|
2245
|
+
}
|
|
2246
|
+
);
|
|
2247
|
+
cmd.command("mix").description("layer multiple audio tracks into one (tracks are summed)").option("--audio <url>", "audio track URL \u2014 repeat the flag for each track (2-20)", collectVariadic).option("--volumes <csv>", 'per-track level %, positionally (0-200 each), e.g. "100,80"').option("--watch", "poll until the job completes").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").addHelpText("after", `
|
|
2248
|
+
Example:
|
|
2249
|
+
$ nodaro audio mix --audio https://.../voice.mp3 --audio https://.../bed.mp3 --volumes 100,60 --watch`).action(
|
|
2250
|
+
async (opts) => {
|
|
2251
|
+
try {
|
|
2252
|
+
const urls = opts.audio ?? [];
|
|
2253
|
+
if (urls.length < 2) {
|
|
2254
|
+
warn("Provide at least two tracks: --audio <url> --audio <url> ...");
|
|
2255
|
+
process.exit(1);
|
|
2256
|
+
}
|
|
2257
|
+
let trackVolumes;
|
|
2258
|
+
if (opts.volumes) {
|
|
2259
|
+
trackVolumes = opts.volumes.split(",").map((s) => parseFloat(s.trim()));
|
|
2260
|
+
if (trackVolumes.length !== urls.length || trackVolumes.some((v) => Number.isNaN(v))) {
|
|
2261
|
+
warn(`--volumes must be ${urls.length} comma-separated numbers (one per --audio, in order)`);
|
|
2262
|
+
process.exit(1);
|
|
2263
|
+
}
|
|
2264
|
+
}
|
|
2265
|
+
const client = buildClient(opts.profile);
|
|
2266
|
+
const result = await client.audio.mix({
|
|
2267
|
+
audioUrls: urls,
|
|
2268
|
+
...trackVolumes ? { trackVolumes } : {}
|
|
2269
|
+
});
|
|
2270
|
+
await reportQueuedJob(result, () => client.jobs.get(result.jobId), { ...opts, note: `${urls.length} tracks` });
|
|
2271
|
+
} catch (err) {
|
|
2272
|
+
handleError(err);
|
|
2273
|
+
}
|
|
2274
|
+
}
|
|
2275
|
+
);
|
|
2276
|
+
cmd.command("adjust-volume").description("adjust an audio (or a video's audio) level \u2014 set %, loudness-normalize, fade in/out").option("--audio <url>", "audio URL to adjust").option("--video <url>", "video URL whose audio to adjust").option("--volume <n>", "level % (default 100)", parseFloat).option("--normalize", "apply loudness normalization").option("--fade-in <sec>", "fade-in duration in seconds", parseFloat).option("--fade-out <sec>", "fade-out duration in seconds", parseFloat).option("--watch", "poll until the job completes").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").action(
|
|
2277
|
+
async (opts) => {
|
|
2278
|
+
try {
|
|
2279
|
+
if (!opts.audio && !opts.video) {
|
|
2280
|
+
warn("Provide --audio <url> or --video <url> (one is required)");
|
|
2281
|
+
process.exit(1);
|
|
2282
|
+
}
|
|
2283
|
+
const client = buildClient(opts.profile);
|
|
2284
|
+
const result = await client.audio.adjustVolume({
|
|
2285
|
+
...opts.audio ? { audioUrl: opts.audio } : {},
|
|
2286
|
+
...opts.video ? { videoUrl: opts.video } : {},
|
|
2287
|
+
...opts.volume !== void 0 ? { volume: opts.volume } : {},
|
|
2288
|
+
...opts.normalize ? { normalize: true } : {},
|
|
2289
|
+
...opts.fadeIn !== void 0 ? { fadeIn: opts.fadeIn } : {},
|
|
2290
|
+
...opts.fadeOut !== void 0 ? { fadeOut: opts.fadeOut } : {}
|
|
2291
|
+
});
|
|
2292
|
+
await reportQueuedJob(result, () => client.jobs.get(result.jobId), { ...opts, note: "adjust volume" });
|
|
2293
|
+
} catch (err) {
|
|
2294
|
+
handleError(err);
|
|
2295
|
+
}
|
|
2296
|
+
}
|
|
2297
|
+
);
|
|
2298
|
+
cmd.command("combine").description("concatenate audio segments end-to-end").option("--segment <url[@a-b]>", 'segment URL with an optional "@start-end" sub-range in seconds \u2014 repeat per segment, in order', collectVariadic).option("--watch", "poll until the job completes").option("--poll-interval <ms>", "watch poll interval in ms", (v) => parseInt(v, 10), 2e3).option("--profile <name>").option("--json").addHelpText("after", `
|
|
2299
|
+
Example:
|
|
2300
|
+
$ nodaro audio combine --segment https://.../intro.mp3 --segment "https://.../talk.mp3@12-95" --watch`).action(
|
|
2301
|
+
async (opts) => {
|
|
2302
|
+
try {
|
|
2303
|
+
const raws = opts.segment ?? [];
|
|
2304
|
+
if (raws.length === 0) {
|
|
2305
|
+
warn("Provide at least one segment: --segment <url[@start-end]> ...");
|
|
2306
|
+
process.exit(1);
|
|
2307
|
+
}
|
|
2308
|
+
const segments = raws.map(parseSegment);
|
|
2309
|
+
const client = buildClient(opts.profile);
|
|
2310
|
+
const result = await client.audio.combine({ segments });
|
|
2311
|
+
await reportQueuedJob(result, () => client.jobs.get(result.jobId), {
|
|
2312
|
+
...opts,
|
|
2313
|
+
note: `${segments.length} segment${segments.length === 1 ? "" : "s"}`
|
|
1710
2314
|
});
|
|
1711
2315
|
} catch (err) {
|
|
1712
2316
|
handleError(err);
|
|
@@ -2771,6 +3375,8 @@ program.addCommand(executionsCommand());
|
|
|
2771
3375
|
program.addCommand(charactersCommand());
|
|
2772
3376
|
program.addCommand(promptCommand());
|
|
2773
3377
|
program.addCommand(voiceCommand());
|
|
3378
|
+
program.addCommand(mediaCommand());
|
|
3379
|
+
program.addCommand(audioCommand());
|
|
2774
3380
|
program.addCommand(presetsCommand());
|
|
2775
3381
|
program.addCommand(communityCommand());
|
|
2776
3382
|
program.addCommand(pickerCatalogsCommand());
|