patch bump

add implementation note 4

.gitignore

@@ -1,13 +1,3 @@
-# Python-generated files
-__pycache__/
-*.py[oc]
-build/
-dist/
-wheels/
-*.egg-info
-
-# Virtual environments
-.venv
 # Generated by ignr: github.com/onyx-and-iris/ignr
 
 ## Python ##

.pre-commit-config.yaml

@@ -0,0 +1,7 @@
+repos:
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    # uv version.
+    rev: 0.10.7
+    hooks:
+      # Update the uv lockfile
+      - id: uv-lock

README.md

@@ -51,7 +51,7 @@ export VBAN_CLI_STREAMNAME=Command1
 
 ### Strip Command
 
-Usage: vban-cli strip <index> COMMAND [ARGS]
+Usage: vban-cli strip \<index> COMMAND [ARGS]
 
 examples:
 
@@ -65,27 +65,122 @@ vban-cli strip 2 gain -18.7
 
 see `vban-cli strip --help` for more info.
 
-### Bus Command
+#### Strip EQ
 
-Usage: vban-cli bus <index> COMMAND [ARGS]
+Usage: vban-cli strip \<index> eq COMMAND [OPTIONS]
 
 examples:
 
 ```console
-vban-cli bus mode normal
+vban-cli strip 0 eq on true
+```
 
-vban-cli bus mute true
+see `vban-cli strip eq --help` for more info.
+
+#### Strip EQ Cell Command
+
+Usage: vban-cli strip \<index> eq cell \<band> COMMAND [ARGS]
+
+examples:
+
+```console
+vban-cli strip 0 eq cell 0 on false
+
+vban-cli strip 3 eq cell 2 freq 1500
+
+vban-cli strip 4 eq cell 5 type 5
+```
+
+see `vban-cli strip eq cell --help` for more info.
+
+#### Strip Gainlayer Command
+
+Usage: vban-cli strip \<index> gainlayer \<gainlayer_index> COMMAND [OPTIONS] [ARGS]
+
+examples:
+
+```console
+vban-cli strip 0 gainlayer 0 level
+
+vban-cli strip 3 gainlayer 2 level -13.5
+```
+
+see `vban-cli strip gainlayer --help` for more info.
+
+### Bus Command
+
+Usage: vban-cli bus \<index> COMMAND [ARGS]
+
+examples:
+
+```console
+vban-cli bus 0 mode tvmix
+
+vban-cli bus 1 mute true
 ```
 
 see `vban-cli bus --help` for more info.
 
+### Command Command
+
+Usage: vban-cli command COMMAND
+
+examples:
+
+```console
+vban-cli command show
+
+vban-cli command restart
+```
+
+see `vban-cli command --help` for more info.
+
+### Recorder Command
+
+Usage: vban-cli recorder COMMAND
+
+examples:
+
+```console
+vban-cli recorder play
+
+vban-cli recorder pause
+
+vban-cli recorder goto "00:01:30"
+```
+
+see `vban-cli recorder --help` for more info.
+
+### Sendtext Command
+
+Usage: vban-cli sendtext TEXT
+
+examples:
+
+*To Voicemeeter*
+
+```console
+vban-cli sendtext 'Strip[0].Mute=1;Bus[0].Mono=2'
+```
+
+*To Matrix*
+
+```console
+vban-cli sendtext 'Command.Version = ?'
+
+vban-cli sendtext 'Point(ASIO128.IN[1..4],ASIO128.OUT[1]).dBGain = -3.0'
+```
+
+see `vban-cli sendtext --help` for more info.
+
 ---
 
 ## Implementation Notes
 
-1. The VBAN TEXT subprotocol defines two packet structures [ident:0][ident-0] and [ident:1][ident-1]. Neither of them contain the data for Bus EQ parameters.
-2. Packet structure with [ident:1][ident-1] is emitted by the VBAN server only on pdirty events. This means we do not receive the initial state of those parameters on initial subscription. Therefore any commands which are intended to fetch the value of parameters defined in packet [ident:1][ident-1] will not work in this CLI.
+1. The VBAN RT SERVICE subprotocol defines two packet structures [ident:0][ident-0] and [ident:1][ident-1]. Neither of them contain the data for Bus EQ parameters.
+2. Packet structure with [ident:1][ident-1] is emitted by the VBAN server only on pdirty events. This means we do not receive the current state of those parameters on initial subscription. Therefore any commands which are intended to fetch the value of parameters defined in packet [ident:1][ident-1] will not work in this CLI.
 3. Packet structure with [ident:1][ident-1] defines parameteric EQ data only for the [first channel][ident-1-peq].
+4. There doesn't appear to be any way to retrieve the current recorder status, ie, recording, playing, stopped etc. I don't see the data available in either packet structures [ident:0][ident-0] or [ident:1][ident-1].
 
 ---
 
@@ -93,9 +188,7 @@ see `vban-cli bus --help` for more info.
 
 I've made the effort to set up the basic skeletal structure of the CLI as well as demonstrate how to combine subcommand groups with subcommand groups so more can be implemented, it just needs doing. There may be restrictions on some things however, for example, retrieving values is only possible for parameters [defined in the protocol](https://github.com/onyx-and-iris/Voicemeeter-SDK/blob/3be2c1c36563afbd6df3da8436406c77d2cc1f10/VoicemeeterRemote.h#L787). Setting parameters can be done for anything possible by a string request.
 
-Shell completion scripts are available (for zsh, bash and fish) but I haven't tested them
-
-Some of the help output needs improving for commands that branch off positional arguments.
+Shell completion scripts are available (for zsh, bash and fish) but they haven't been thoroughly tested.
 
 If there's something missing that you would like to see added the best bet is to submit a PR. You may raise an issue and if it's quick and simple to do I may (or may not) do it.
 
@@ -108,5 +201,5 @@ If there's something missing that you would like to see added the best bet is to
 
 
 [ident-0]: https://github.com/onyx-and-iris/Voicemeeter-SDK/blob/3be2c1c36563afbd6df3da8436406c77d2cc1f10/VoicemeeterRemote.h#L896
-[ident-1]: https://github.com/onyx-and-iris/Voicemeeter-SDK/blob/3be2c1c36563afbd6df3da8436406c77d2cc1f10/VoicemeeterRemote.h#L982
+[ident-1]: https://github.com/onyx-and-iris/Voicemeeter-SDK/blob/3be2c1c36563afbd6df3da8436406c77d2cc1f10/VoicemeeterRemote.h#L1053
 [ident-1-peq]: https://github.com/onyx-and-iris/Voicemeeter-SDK/blob/3be2c1c36563afbd6df3da8436406c77d2cc1f10/VoicemeeterRemote.h#L995

pyproject.toml

@@ -1,15 +1,11 @@
 [project]
 name = "vban-cli"
-version = "0.4.2"
+version = "0.9.1"
 description = "A command-line interface for Voicemeeter leveraging VBAN."
 readme = "README.md"
 license = { text = "LICENSE" }
 requires-python = ">=3.13"
-dependencies = [
-    "cyclopts>=4.6.0",
-    "loguru>=0.7.3",
-    "vban-cmd>=2.6.0",
-]
+dependencies = ["cyclopts>=4.6.0", "loguru>=0.7.3", "vban-cmd>=2.8.1"]
 classifiers = [
     "Development Status :: 3 - Alpha",
     "Programming Language :: Python",
@@ -28,4 +24,4 @@ vban-cli = "vban_cli.app:run"
 package = true
 
 [tool.uv.sources]
-vban-cmd = { path = "../vban-cmd-python" }
+vban-cmd = { path = "../vban-cmd-python", editable = true }

src/vban_cli/app.py

@@ -2,10 +2,10 @@ from dataclasses import dataclass
 from typing import Annotated
 
 import vban_cmd
-from cyclopts import App, Parameter, config
+from cyclopts import App, Argument, Parameter, config
 
 from . import __version__ as version
-from . import bus, console, strip
+from . import bus, command, console, recorder, strip
 from .context import Context
 
 app = App(
@@ -16,6 +16,8 @@ app = App(
 )
 app.command(strip.app.meta, name='strip')
 app.command(bus.app.meta, name='bus')
+app.command(command.app, name='command')
+app.command(recorder.app, name='recorder')
 app.register_install_completion_command()
 
 
@@ -37,15 +39,32 @@ def launcher(
     if tokens[0] == '--install-completion':
         return command(*bound.args, **bound.kwargs)
 
+    disable_rt_listeners = False
+    if command.__name__ == 'sendtext':
+        disable_rt_listeners = True
+
     with vban_cmd.api(
         vban_config.kind,
         ip=vban_config.host,
         port=vban_config.port,
         streamname=vban_config.streamname,
+        disable_rt_listeners=disable_rt_listeners,
     ) as client:
         return command(*bound.args, **bound.kwargs, ctx=Context(client=client))
 
 
+@app.command(name='sendtext')
+def sendtext(
+    text: Annotated[str, Argument()],
+    /,
+    *,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Send a text command to the current Voicemeeter/Matrix instance."""
+    if resp := ctx.client.sendtext(text):
+        console.out.print(resp)
+
+
 def run():
     try:
         app.meta()

src/vban_cli/bus.py

@@ -32,7 +32,9 @@ def launcher(
 
 @app.command(name='mono')
 def mono(
-    new_value: Annotated[Optional[bool], Argument()] = None,
+    new_value: Annotated[
+        Optional[Literal['off', 'mono', 'stereoreverse']], Argument()
+    ] = None,
     *,
     index: Annotated[int, Parameter(show=False)] = None,
     ctx: Annotated[Context, Parameter(show=False)] = None,
@@ -41,13 +43,13 @@ def mono(
 
     Parameters
     ----------
-    new_value : bool, optional
+    new_value : {'off', 'mono', 'stereoreverse'}, optional
         If provided, sets the mono state to this value. If not provided, the current mono state is printed.
     """
     if new_value is None:
-        console.out.print(ctx.client.bus[index].mono)
+        console.out.print(['off', 'mono', 'stereoreverse'][ctx.client.bus[index].mono])
         return
-    ctx.client.bus[index].mono = new_value
+    ctx.client.bus[index].mono = ['off', 'mono', 'stereoreverse'].index(new_value)
 
 
 @app.command(name='mute')

src/vban_cli/command.py

@@ -0,0 +1,49 @@
+from typing import Annotated
+
+from cyclopts import App, Parameter
+
+from . import console
+from .context import Context
+from .help import BaseHelpFormatter
+
+app = App(name='command', help_formatter=BaseHelpFormatter())
+
+
+@app.command(name='show')
+def show(
+    *,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Bring the Voicemeeter GUI to the foreground."""
+    ctx.client.command.show()
+    console.out.print('Voicemeeter GUI should now be in the foreground.')
+
+
+@app.command(name='hide')
+def hide(
+    *,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Send the Voicemeeter GUI to the background."""
+    ctx.client.command.hide()
+    console.out.print('Voicemeeter GUI should now be in the background.')
+
+
+@app.command(name='shutdown')
+def shutdown(
+    *,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Shut down Voicemeeter."""
+    ctx.client.command.shutdown()
+    console.out.print('Voicemeeter should now be shut down.')
+
+
+@app.command(name='restart')
+def restart(
+    *,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Restart the Voicemeeter engine."""
+    ctx.client.command.restart()
+    console.out.print('Voicemeeter engine should now be restarting.')

src/vban_cli/comp.py

@@ -3,9 +3,9 @@ from typing import Annotated
 from cyclopts import App, Argument, Parameter
 
 from .context import Context
-from .help import StripSubcommandHelpFormatter
+from .help import StripHelpFormatter
 
-app = App(name='comp', help_formatter=StripSubcommandHelpFormatter())
+app = App(name='comp', help_formatter=StripHelpFormatter())
 
 
 @app.meta.default

src/vban_cli/denoiser.py

@@ -3,9 +3,9 @@ from typing import Annotated
 from cyclopts import App, Argument, Parameter
 
 from .context import Context
-from .help import StripSubcommandHelpFormatter
+from .help import StripHelpFormatter
 
-app = App(name='denoiser', help_formatter=StripSubcommandHelpFormatter())
+app = App(name='denoiser', help_formatter=StripHelpFormatter())
 
 
 @app.meta.default

src/vban_cli/eq.py

@@ -64,7 +64,7 @@ def cell_launcher(
     Only channel 0 is supported, see https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 3.
     """
     additional_kwargs = {}
-    command, bound, _ = app.parse_args(tokens)
+    command, bound, _ = cell_app.parse_args(tokens)
     additional_kwargs['target'] = target.channel[0].cell[band]
 
     return command(*bound.args, **bound.kwargs, **additional_kwargs)
@@ -88,3 +88,83 @@ def cell_on(
         # console.out.print(target.on)
         return
     target.on = new_state
+
+
+@cell_app.command(name='freq')
+def cell_freq(
+    new_freq: Annotated[float, Argument()] = None,
+    *,
+    target: Annotated[object, Parameter(show=False)] = None,
+):
+    """Get or set the frequency of the specified EQ cell.
+
+    Parameters
+    ----------
+    new_freq : float
+        If provided, sets the frequency to this value. If not provided, the current frequency is printed.
+    """
+    if new_freq is None:
+        # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
+        # console.out.print(target.f)
+        return
+    target.f = new_freq
+
+
+@cell_app.command(name='gain')
+def cell_gain(
+    new_gain: Annotated[float, Argument()] = None,
+    *,
+    target: Annotated[object, Parameter(show=False)] = None,
+):
+    """Get or set the gain of the specified EQ cell.
+
+    Parameters
+    ----------
+    new_gain : float
+        If provided, sets the gain to this value. If not provided, the current gain is printed.
+    """
+    if new_gain is None:
+        # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
+        # console.out.print(target.gain)
+        return
+    target.gain = new_gain
+
+
+@cell_app.command(name='quality')
+def cell_q(
+    new_q: Annotated[float, Argument()] = None,
+    *,
+    target: Annotated[object, Parameter(show=False)] = None,
+):
+    """Get or set the Q of the specified EQ cell.
+
+    Parameters
+    ----------
+    new_q : float
+        If provided, sets the Q to this value. If not provided, the current Q is printed.
+    """
+    if new_q is None:
+        # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
+        # console.out.print(target.q)
+        return
+    target.q = new_q
+
+
+@cell_app.command(name='type')
+def cell_type(
+    new_type: Annotated[int, Argument()] = None,
+    *,
+    target: Annotated[object, Parameter(show=False)] = None,
+):
+    """Get or set the type of the specified EQ cell.
+
+    Parameters
+    ----------
+    new_type : int
+        If provided, sets the type to this value. If not provided, the current type is printed.
+    """
+    if new_type is None:
+        # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
+        # console.out.print(target.type)
+        return
+    target.type = new_type

src/vban_cli/gainlayer.py

@@ -0,0 +1,51 @@
+from typing import Annotated
+
+from cyclopts import App, Argument, Parameter
+
+from . import console
+from .context import Context
+from .help import GainlayerHelpFormatter
+
+app = App(name='gainlayer', help_formatter=GainlayerHelpFormatter())
+
+
+@app.meta.default
+def launcher(
+    gainlayer_index: Annotated[int, Argument()] = None,
+    *tokens: Annotated[str, Parameter(show=False, allow_leading_hyphen=True)],
+    index: Annotated[int, Argument()] = None,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Control the gainlayers."""
+    additional_kwargs = {}
+    command, bound, _ = app.parse_args(tokens)
+    if index is not None and gainlayer_index is not None:
+        additional_kwargs['strip_index'] = index
+        additional_kwargs['gainlayer_index'] = gainlayer_index
+    else:
+        raise ValueError('Both gainlayer_index and index must be provided.')
+    if ctx is not None:
+        additional_kwargs['ctx'] = ctx
+
+    return command(*bound.args, **bound.kwargs, **additional_kwargs)
+
+
+@app.command(name='level')
+def level(
+    new_level: Annotated[float, Argument()] = None,
+    *,
+    strip_index: Annotated[int, Parameter(show=False)] = None,
+    gainlayer_index: Annotated[int, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Get or set the level of the specified gainlayer.
+
+    Parameters
+    ----------
+    new_level : float
+        If provided, sets the level to this value. If not provided, the current level is printed.
+    """
+    if new_level is None:
+        console.out.print(ctx.client.strip[strip_index].gainlayer[gainlayer_index].gain)
+        return
+    ctx.client.strip[strip_index].gainlayer[gainlayer_index].gain = new_level

src/vban_cli/gate.py

@@ -3,9 +3,9 @@ from typing import Annotated
 from cyclopts import App, Argument, Parameter
 
 from .context import Context
-from .help import StripSubcommandHelpFormatter
+from .help import StripHelpFormatter
 
-app = App(name='gate', help_formatter=StripSubcommandHelpFormatter())
+app = App(name='gate', help_formatter=StripHelpFormatter())
 
 
 @app.meta.default

src/vban_cli/help.py

@@ -61,18 +61,6 @@ class StripHelpFormatter(BaseHelpFormatter):
             console.print(f'[bold]Usage:[/bold] {modified_usage}')
 
 
-class StripSubcommandHelpFormatter(BaseHelpFormatter):
-    """Help formatter for strip subcommands that injects <index> after 'strip'."""
-
-    def render_usage(self, console: Console, options: ConsoleOptions, usage) -> None:
-        """Render the usage line with index argument injected after 'strip'."""
-        if usage:
-            modified_usage = re.sub(
-                r'(\S+\s+strip)\s+(\w+)\s+(COMMAND)', r'\1 <index> \2 \3', str(usage)
-            )
-            console.print(f'[bold]Usage:[/bold] {modified_usage}')
-
-
 class BusHelpFormatter(BaseHelpFormatter):
     """Help formatter for bus commands that injects <index> after 'bus'."""
 
@@ -107,6 +95,22 @@ class EqHelpFormatter(BaseHelpFormatter):
             console.print(f'[bold]Usage:[/bold] {modified_usage}')
 
 
+class GainlayerHelpFormatter(BaseHelpFormatter):
+    """Help formatter for gainlayer commands that works with strip commands.
+
+    Injects <index> after 'strip' and <gainlayer_index> after 'gainlayer'."""
+
+    def render_usage(self, console: Console, options: ConsoleOptions, usage) -> None:
+        """Render the usage line with proper <index> placement for strip commands."""
+        if usage:
+            modified_usage = re.sub(
+                r'(\S+\s+strip)(\s+gainlayer\s+)(COMMAND)',
+                r'\1 <index>\2<[cyan]gainlayer_index[/cyan]> \3',
+                str(usage),
+            )
+            console.print(f'[bold]Usage:[/bold] {modified_usage}')
+
+
 class CellHelpFormatter(BaseHelpFormatter):
     """Help formatter for cell commands that works with both strip and bus commands.
 
@@ -117,7 +121,7 @@ class CellHelpFormatter(BaseHelpFormatter):
         if usage:
             modified_usage = re.sub(
                 r'(\S+\s+)(\w+)(\s+eq\s+cell\s+)(COMMAND)',
-                r'\1\2 <index>\3<band> \4',
+                r'\1\2 <index>\3<[cyan]band[/cyan]> \4',
                 str(usage),
             )
             console.print(f'[bold]Usage:[/bold] {modified_usage}')

src/vban_cli/recorder.py

@@ -0,0 +1,131 @@
+from pathlib import Path
+from typing import Annotated
+
+from cyclopts import App, Parameter, validators
+
+from . import console, validation
+from .context import Context
+from .help import BaseHelpFormatter
+
+app = App(name='recorder', help_formatter=BaseHelpFormatter())
+
+
+@app.command(name='play')
+def play(
+    *,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Start the recorder playback."""
+    ctx.client.recorder.play()
+    console.out.print('Recorder playback started.')
+
+
+@app.command(name='pause')
+def pause(
+    *,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Pause the recorder playback."""
+    ctx.client.recorder.stop()
+    console.out.print('Recorder playback paused.')
+
+
+@app.command(name='stop')
+def stop(
+    *,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Stop the recorder playback/recording and reset to the beginning."""
+    ctx.client.recorder.stop()
+    ctx.client.recorder.goto('00:00:00')
+    # We have no way of knowing if the recorder was playing or recording, so we print a generic message.
+    # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 4.
+    console.out.print('Recorder stopped.')
+
+
+@app.command(name='replay')
+def replay(
+    *,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Replay the recorder playback."""
+    ctx.client.recorder.replay()
+    console.out.print('Recorder playback replay started.')
+
+
+@app.command(name='record')
+def record(
+    *,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Start recording."""
+    ctx.client.recorder.record()
+    console.out.print('Recorder recording started.')
+
+
+@app.command(name='pause-recording')
+def pause_recording(
+    *,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Pause the recorder recording."""
+    ctx.client.recorder.pause()
+    console.out.print('Recorder recording paused.')
+
+
+@app.command(name='ff')
+def ff(
+    *,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Fast forward the recorder playback."""
+    ctx.client.recorder.ff()
+    console.out.print('Recorder playback fast forwarded.')
+
+
+@app.command(name='rew')
+def rew(
+    *,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Rewind the recorder playback."""
+    ctx.client.recorder.rew()
+    console.out.print('Recorder playback rewound.')
+
+
+@app.command(name='load')
+def load(
+    file_path: Annotated[
+        Path,
+        Parameter(
+            help='The path to the recording file to load.',
+            validator=validators.Path(exists=True),
+        ),
+    ],
+    /,
+    *,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Load a file into the recorder.
+
+    note: This command may only work if vban-cli is running on localhost and may not work if vban-cli is running on a remote server."""
+    ctx.client.recorder.load(file_path)
+    console.out.print(f'Loaded file: {file_path}')
+
+
+@app.command(name='goto')
+def goto(
+    time_string: Annotated[
+        str,
+        Parameter(
+            help='The timestamp to go to in the recorder playback (format: HH:MM:SS).',
+            validator=validation.is_valid_time_string,
+        ),
+    ],
+    /,
+    *,
+    ctx: Annotated[Context, Parameter(show=False)] = None,
+):
+    """Go to a specific timestamp in the recorder playback."""
+    ctx.client.recorder.goto(time_string)
+    console.out.print(f'Went to timestamp {time_string} in recorder playback.')

src/vban_cli/strip.py

@@ -2,7 +2,7 @@ from typing import Annotated, Optional
 
 from cyclopts import App, Argument, Parameter
 
-from . import comp, console, denoiser, eq, gate
+from . import comp, console, denoiser, eq, gainlayer, gate
 from .context import Context
 from .help import StripHelpFormatter
 
@@ -11,6 +11,7 @@ app.command(eq.app.meta, name='eq')
 app.command(comp.app.meta, name='comp')
 app.command(gate.app.meta, name='gate')
 app.command(denoiser.app.meta, name='denoiser')
+app.command(gainlayer.app.meta, name='gainlayer')
 
 
 @app.meta.default

src/vban_cli/validation.py

@@ -0,0 +1,9 @@
+import re
+
+
+def is_valid_time_string(type_, value: str) -> str:
+    """Validate if the given string is a valid time format (HH:MM:SS)."""
+    pattern = r'^(?:[01]\d|2[0123]):(?:[012345]\d):(?:[012345]\d)$'
+    if not re.match(pattern, value):
+        raise ValueError('Invalid time format. Expected HH:MM:SS.')
+    return value

uv.lock

@@ -124,7 +124,7 @@ wheels = [
 
 [[package]]
 name = "vban-cli"
-version = "0.4.2"
+version = "0.9.1"
 source = { editable = "." }
 dependencies = [
     { name = "cyclopts" },
@@ -136,13 +136,13 @@ dependencies = [
 requires-dist = [
     { name = "cyclopts", specifier = ">=4.6.0" },
     { name = "loguru", specifier = ">=0.7.3" },
-    { name = "vban-cmd", directory = "../vban-cmd-python" },
+    { name = "vban-cmd", editable = "../vban-cmd-python" },
 ]
 
 [[package]]
 name = "vban-cmd"
-version = "2.6.0"
-source = { directory = "../vban-cmd-python" }
+version = "2.8.1"
+source = { editable = "../vban-cmd-python" }
 
 [package.metadata]
 requires-dist = [{ name = "tomli", marker = "python_full_version < '3.11'", specifier = ">=2.0.1,<3.0" }]