upd lockfile

minor bump

README.md

@@ -5,8 +5,6 @@
 
 ---
 
-This CLI is still in an early stage of development with many more things that could be implemented. However, the commands that are implemented should be working without issues.
-
 ## Install
 
 #### With uv
@@ -51,7 +49,7 @@ export VBAN_CLI_STREAMNAME=Command1
 
 ### Strip Command
 
-Usage: vban-cli strip \<index> COMMAND [ARGS]
+*Usage: vban-cli strip \<index> COMMAND [OPTIONS]*
 
 examples:
 
@@ -67,7 +65,7 @@ see `vban-cli strip --help` for more info.
 
 #### Strip EQ
 
-Usage: vban-cli strip \<index> eq COMMAND [OPTIONS]
+*Usage: vban-cli strip \<index> eq COMMAND [OPTIONS]*
 
 examples:
 
@@ -79,7 +77,7 @@ see `vban-cli strip eq --help` for more info.
 
 #### Strip EQ Cell Command
 
-Usage: vban-cli strip \<index> eq cell \<band> COMMAND [ARGS]
+*Usage: vban-cli strip \<index> eq cell \<band> COMMAND [ARGS]*
 
 examples:
 
@@ -93,9 +91,49 @@ vban-cli strip 4 eq cell 5 type 5
 
 see `vban-cli strip eq cell --help` for more info.
 
+#### Strip Comp Command
+
+*Usage: vban-cli strip \<index> comp COMMAND [OPTIONS]*
+
+examples:
+
+```console
+vban-cli strip 0 comp attack 2.0
+
+vban-cli strip 3 comp auto-makeup true
+```
+
+see `vban-cli strip comp --help` for more info.
+
+#### Strip Gate Command
+
+*Usage: vban-cli strip \<index> gate COMMAND [OPTIONS]*
+
+examples:
+
+```console
+vban-cli strip 2 gate attack 634
+
+vban-cli strip 5 gate hold 2088.7
+```
+
+see `vban-cli strip comp --help` for more info.
+
+#### Strip Denoiser Command
+
+*Usage: vban-cli strip \<index> denoiser COMMAND [OPTIONS]*
+
+examples:
+
+```console
+vban-cli strip 4 denoiser knob 3.6
+```
+
+see `vban-cli strip denoiser --help` for more info.
+
 #### Strip Gainlayer Command
 
-Usage: vban-cli strip \<index> gainlayer \<gainlayer_index> COMMAND [OPTIONS] [ARGS]
+*Usage: vban-cli strip \<index> gainlayer \<gainlayer_index> COMMAND [OPTIONS] [ARGS]*
 
 examples:
 
@@ -109,7 +147,7 @@ see `vban-cli strip gainlayer --help` for more info.
 
 ### Bus Command
 
-Usage: vban-cli bus \<index> COMMAND [ARGS]
+*Usage: vban-cli bus \<index> COMMAND [OPTIONS]*
 
 examples:
 
@@ -123,7 +161,7 @@ see `vban-cli bus --help` for more info.
 
 ### Command Command
 
-Usage: vban-cli command COMMAND
+*Usage: vban-cli command COMMAND*
 
 examples:
 
@@ -137,7 +175,7 @@ see `vban-cli command --help` for more info.
 
 ### Recorder Command
 
-Usage: vban-cli recorder COMMAND
+*Usage: vban-cli recorder COMMAND*
 
 examples:
 
@@ -153,7 +191,7 @@ see `vban-cli recorder --help` for more info.
 
 ### Sendtext Command
 
-Usage: vban-cli sendtext TEXT
+*Usage: vban-cli sendtext TEXT*
 
 examples:
 

pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "vban-cli"
-version = "0.9.1"
+version = "0.12.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.8.1"]
+dependencies = ["cyclopts>=4.6.0", "loguru>=0.7.3", "vban-cmd>=2.9.4"]
 classifiers = [
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 4 - Beta",
     "Programming Language :: Python",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",

src/vban_cli/app.py

@@ -3,16 +3,21 @@ from typing import Annotated
 
 import vban_cmd
 from cyclopts import App, Argument, Parameter, config
+from rich.traceback import install as install_rich_traceback
 
 from . import __version__ as version
 from . import bus, command, console, recorder, strip
 from .context import Context
+from .error import VbanCLIConnectionError
 
 app = App(
     config=config.Env(
         'VBAN_CLI_',
     ),  # Environment variable prefix for configuration parameters
     version=version,
+    console=console.out,
+    error_console=console.err,
+    exit_on_error=True,
 )
 app.command(strip.app.meta, name='strip')
 app.command(bus.app.meta, name='bus')
@@ -20,6 +25,8 @@ app.command(command.app, name='command')
 app.command(recorder.app, name='recorder')
 app.register_install_completion_command()
 
+install_rich_traceback(console=console.err)
+
 
 @Parameter(name='*')
 @dataclass
@@ -43,14 +50,17 @@ def launcher(
     if command.__name__ == 'sendtext':
         disable_rt_listeners = True
 
+    try:
         with vban_cmd.api(
             vban_config.kind,
-        ip=vban_config.host,
+            host=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))
+    except vban_cmd.error.VBANCMDConnectionError as e:
+        raise VbanCLIConnectionError(str(e)) from e
 
 
 @app.command(name='sendtext')
@@ -58,16 +68,12 @@ def sendtext(
     text: Annotated[str, Argument()],
     /,
     *,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Send a text command to the current Voicemeeter/Matrix instance."""
     if resp := ctx.client.sendtext(text):
-        console.out.print(resp)
+        app.console.print(resp)
 
 
 def run():
-    try:
     app.meta()
-    except Exception as e:
-        console.err.print(f'Error: {e}')
-        return e.code

src/vban_cli/bus.py

@@ -2,7 +2,6 @@ from typing import Annotated, Literal, Optional
 
 from cyclopts import App, Argument, Parameter
 
-from . import console
 from .context import Context
 from .help import BusHelpFormatter
 
@@ -13,18 +12,17 @@ app = App(name='bus', help_formatter=BusHelpFormatter())
 
 @app.meta.default
 def launcher(
-    index: Annotated[int, Argument()] = None,
+    index: Annotated[int, Argument()],
+    /,
     *tokens: Annotated[str, Parameter(show=False, allow_leading_hyphen=True)],
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Control the bus parameters."""
     additional_kwargs = {}
     command, bound, _ = app.parse_args(tokens)
     if tokens[0] == 'eq':
         additional_kwargs['eq_kind'] = app.name[0]
-    if index is not None:
     additional_kwargs['index'] = index
-    if ctx is not None:
     additional_kwargs['ctx'] = ctx
 
     return command(*bound.args, **bound.kwargs, **additional_kwargs)
@@ -36,8 +34,8 @@ def mono(
         Optional[Literal['off', 'mono', 'stereoreverse']], Argument()
     ] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the mono state of the specified bus.
 
@@ -47,7 +45,7 @@ def mono(
         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(['off', 'mono', 'stereoreverse'][ctx.client.bus[index].mono])
+        app.console.print(['off', 'mono', 'stereoreverse'][ctx.client.bus[index].mono])
         return
     ctx.client.bus[index].mono = ['off', 'mono', 'stereoreverse'].index(new_value)
 
@@ -56,8 +54,8 @@ def mono(
 def mute(
     new_value: Annotated[Optional[bool], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the mute state of the specified bus.
 
@@ -67,7 +65,7 @@ def mute(
         If provided, sets the mute state to this value. If not provided, the current mute state is printed.
     """
     if new_value is None:
-        console.out.print(ctx.client.bus[index].mute)
+        app.console.print(ctx.client.bus[index].mute)
         return
     ctx.client.bus[index].mute = new_value
 
@@ -94,8 +92,8 @@ def mode(
         Argument(),
     ] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the bus mode of the specified bus.
 
@@ -105,6 +103,6 @@ def mode(
         If provided, sets the bus mode to this value. If not provided, the current bus mode is printed.
     """
     if type_ is None:
-        console.out.print(ctx.client.bus[index].mode.get())
+        app.console.print(ctx.client.bus[index].mode.get())
         return
     setattr(ctx.client.bus[index].mode, type_, True)

src/vban_cli/command.py

@@ -2,7 +2,6 @@ from typing import Annotated
 
 from cyclopts import App, Parameter
 
-from . import console
 from .context import Context
 from .help import BaseHelpFormatter
 
@@ -12,38 +11,38 @@ app = App(name='command', help_formatter=BaseHelpFormatter())
 @app.command(name='show')
 def show(
     *,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=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.console.print('Voicemeeter GUI should now be in the foreground.')
 
 
 @app.command(name='hide')
 def hide(
     *,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Send the Voicemeeter GUI to the background."""
     ctx.client.command.hide()
-    console.out.print('Voicemeeter GUI should now be in the background.')
+    app.console.print('Voicemeeter GUI should now be in the background.')
 
 
 @app.command(name='shutdown')
 def shutdown(
     *,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Shut down Voicemeeter."""
     ctx.client.command.shutdown()
-    console.out.print('Voicemeeter should now be shut down.')
+    app.console.print('Voicemeeter should now be shut down.')
 
 
 @app.command(name='restart')
 def restart(
     *,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Restart the Voicemeeter engine."""
     ctx.client.command.restart()
-    console.out.print('Voicemeeter engine should now be restarting.')
+    app.console.print('Voicemeeter engine should now be restarting.')

src/vban_cli/comp.py

@@ -1,4 +1,4 @@
-from typing import Annotated
+from typing import Annotated, Optional
 
 from cyclopts import App, Argument, Parameter
 
@@ -8,50 +8,33 @@ from .help import StripHelpFormatter
 app = App(name='comp', help_formatter=StripHelpFormatter())
 
 
-@app.meta.default
-def launcher(
-    *tokens: Annotated[str, Parameter(show=False, allow_leading_hyphen=True)],
-    index: Annotated[int, Argument()] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
-):
-    """Control the compressor parameters."""
-    additional_kwargs = {}
-    command, bound, _ = app.parse_args(tokens)
-    if index is not None:
-        additional_kwargs['index'] = index
-    if ctx is not None:
-        additional_kwargs['ctx'] = ctx
-
-    return command(*bound.args, **bound.kwargs, **additional_kwargs)
-
-
 @app.command(name='knob')
 def knob(
-    new_knob: Annotated[float, Argument()] = None,
+    new_knob: Annotated[Optional[float], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the knob of the specified compressor.
 
     Parameters
     ----------
-    new_knob : int, optional
+    new_knob : float, optional
         If provided, sets the knob to this value. If not provided, the current knob is printed.
     """
     if new_knob is None:
         # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
-        # console.out.print(ctx.client.strip[index].comp.knob)
+        # app.console.print(ctx.client.strip[index].comp.knob)
         return
     ctx.client.strip[index].comp.knob = new_knob
 
 
 @app.command(name='input-gain')
 def input_gain(
-    new_gain: Annotated[float, Argument()] = None,
+    new_gain: Annotated[Optional[float], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the input gain of the specified compressor.
 
@@ -62,6 +45,153 @@ def input_gain(
     """
     if new_gain is None:
         # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
-        # console.out.print(ctx.client.strip[index].comp.gainin)
+        # app.console.print(ctx.client.strip[index].comp.gainin)
         return
     ctx.client.strip[index].comp.gainin = new_gain
+
+
+@app.command(name='ratio')
+def ratio(
+    new_ratio: Annotated[Optional[float], Argument()] = None,
+    *,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
+):
+    """Get or set the ratio of the specified compressor.
+
+    Parameters
+    ----------
+    new_ratio : float, optional
+        If provided, sets the ratio to this value. If not provided, the current ratio is printed.
+    """
+    if new_ratio is None:
+        # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
+        # app.console.print(ctx.client.strip[index].comp.ratio)
+        return
+    ctx.client.strip[index].comp.ratio = new_ratio
+
+
+@app.command(name='threshold')
+def threshold(
+    new_threshold: Annotated[Optional[float], Argument()] = None,
+    *,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
+):
+    """Get or set the threshold of the specified compressor.
+
+    Parameters
+    ----------
+    new_threshold : float, optional
+        If provided, sets the threshold to this value. If not provided, the current threshold is printed.
+    """
+    if new_threshold is None:
+        # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
+        # app.console.print(ctx.client.strip[index].comp.threshold)
+        return
+    ctx.client.strip[index].comp.threshold = new_threshold
+
+
+@app.command(name='attack')
+def attack(
+    new_attack: Annotated[Optional[float], Argument()] = None,
+    *,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
+):
+    """Get or set the attack of the specified compressor.
+
+    Parameters
+    ----------
+    new_attack : float, optional
+        If provided, sets the attack to this value. If not provided, the current attack is printed.
+    """
+    if new_attack is None:
+        # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
+        # app.console.print(ctx.client.strip[index].comp.attack)
+        return
+    ctx.client.strip[index].comp.attack = new_attack
+
+
+@app.command(name='release')
+def release(
+    new_release: Annotated[Optional[float], Argument()] = None,
+    *,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
+):
+    """Get or set the release of the specified compressor.
+
+    Parameters
+    ----------
+    new_release : float, optional
+        If provided, sets the release to this value. If not provided, the current release is printed.
+    """
+    if new_release is None:
+        # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
+        # app.console.print(ctx.client.strip[index].comp.release)
+        return
+    ctx.client.strip[index].comp.release = new_release
+
+
+@app.command(name='knee')
+def knee(
+    new_knee: Annotated[Optional[float], Argument()] = None,
+    *,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
+):
+    """Get or set the knee of the specified compressor.
+
+    Parameters
+    ----------
+    new_knee : float, optional
+        If provided, sets the knee to this value. If not provided, the current knee is printed.
+    """
+    if new_knee is None:
+        # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
+        # app.console.print(ctx.client.strip[index].comp.knee)
+        return
+    ctx.client.strip[index].comp.knee = new_knee
+
+
+@app.command(name='output-gain')
+def output_gain(
+    new_gain: Annotated[Optional[float], Argument()] = None,
+    *,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
+):
+    """Get or set the output gain of the specified compressor.
+
+    Parameters
+    ----------
+    new_gain : float, optional
+        If provided, sets the output gain to this value. If not provided, the current output gain is printed.
+    """
+    if new_gain is None:
+        # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
+        # app.console.print(ctx.client.strip[index].comp.gainout)
+        return
+    ctx.client.strip[index].comp.gainout = new_gain
+
+
+@app.command(name='auto-makeup')
+def makeup(
+    new_makeup: Annotated[Optional[bool], Argument()] = None,
+    *,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
+):
+    """Get or set the auto-makeup of the specified compressor.
+
+    Parameters
+    ----------
+    new_makeup : bool, optional
+        If provided, sets the auto-makeup to this value. If not provided, the current auto-makeup is printed.
+    """
+    if new_makeup is None:
+        # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
+        # app.console.print(ctx.client.strip[index].comp.makeup)
+        return
+    ctx.client.strip[index].comp.makeup = new_makeup

src/vban_cli/denoiser.py

@@ -1,4 +1,4 @@
-from typing import Annotated
+from typing import Annotated, Optional
 
 from cyclopts import App, Argument, Parameter
 
@@ -8,39 +8,22 @@ from .help import StripHelpFormatter
 app = App(name='denoiser', help_formatter=StripHelpFormatter())
 
 
-@app.meta.default
-def launcher(
-    *tokens: Annotated[str, Parameter(show=False, allow_leading_hyphen=True)],
-    index: Annotated[int, Argument()] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
-):
-    """Control the denoiser parameters."""
-    additional_kwargs = {}
-    command, bound, _ = app.parse_args(tokens)
-    if index is not None:
-        additional_kwargs['index'] = index
-    if ctx is not None:
-        additional_kwargs['ctx'] = ctx
-
-    return command(*bound.args, **bound.kwargs, **additional_kwargs)
-
-
 @app.command(name='knob')
 def knob(
-    new_knob: Annotated[float, Argument()] = None,
+    new_knob: Annotated[Optional[float], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the knob of the specified denoiser.
 
     Parameters
     ----------
-    new_knob : int, optional
+    new_knob : float, optional
         If provided, sets the knob to this value. If not provided, the current knob is printed.
     """
     if new_knob is None:
         # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
-        # console.out.print(ctx.client.strip[index].denoiser.knob)
+        # app.console.print(ctx.client.strip[index].denoiser.knob)
         return
     ctx.client.strip[index].denoiser.knob = new_knob

src/vban_cli/eq.py

@@ -1,4 +1,4 @@
-from typing import Annotated
+from typing import Annotated, Optional
 
 from cyclopts import App, Argument, Parameter
 
@@ -14,9 +14,9 @@ app.command(cell_app.meta, name='cell')
 @app.meta.default
 def launcher(
     *tokens: Annotated[str, Parameter(show=False, allow_leading_hyphen=True)],
-    eq_kind: Annotated[str, Parameter(show=False)] = None,
-    index: Annotated[int, Argument()] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    eq_kind: Annotated[str, Parameter(parse=False)],
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Control the EQ parameters."""
     additional_kwargs = {}
@@ -35,29 +35,30 @@ def launcher(
 
 @app.command(name='on')
 def on(
-    new_state: Annotated[bool, Argument()] = None,
+    new_state: Annotated[Optional[bool], Argument()] = None,
     *,
-    target: Annotated[object, Parameter(show=False)] = None,
+    target: Annotated[object, Parameter(parse=False)],
 ):
     """Get or set the on state of the specified EQ band.
 
     Parameters
     ----------
-    new_state : bool
+    new_state : bool, optional
         If provided, sets the on state to this value. If not provided, the current on state is printed.
     """
     if new_state is None:
         # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
-        # console.out.print(target.on)
+        # app.console.print(target.on)
         return
     target.on = new_state
 
 
 @cell_app.meta.default
 def cell_launcher(
-    band: Annotated[int, Argument()] = None,
+    band: Annotated[int, Argument()],
+    /,
     *tokens: Annotated[str, Parameter(show=False, allow_leading_hyphen=True)],
-    target: Annotated[object, Parameter(show=False)] = None,
+    target: Annotated[object, Parameter(parse=False)],
 ):
     """Control the EQ Cell parameters.
 
@@ -72,99 +73,99 @@ def cell_launcher(
 
 @cell_app.command(name='on')
 def cell_on(
-    new_state: Annotated[bool, Argument()] = None,
+    new_state: Annotated[Optional[bool], Argument()] = None,
     *,
-    target: Annotated[object, Parameter(show=False)] = None,
+    target: Annotated[object, Parameter(parse=False)],
 ):
     """Get or set the on state of the specified EQ cell.
 
     Parameters
     ----------
-    new_state : bool
+    new_state : bool, optional
         If provided, sets the on state to this value. If not provided, the current on state is printed.
     """
     if new_state is None:
         # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
-        # console.out.print(target.on)
+        # app.console.print(target.on)
         return
     target.on = new_state
 
 
 @cell_app.command(name='freq')
 def cell_freq(
-    new_freq: Annotated[float, Argument()] = None,
+    new_freq: Annotated[Optional[float], Argument()] = None,
     *,
-    target: Annotated[object, Parameter(show=False)] = None,
+    target: Annotated[object, Parameter(parse=False)],
 ):
     """Get or set the frequency of the specified EQ cell.
 
     Parameters
     ----------
-    new_freq : float
+    new_freq : float, optional
         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)
+        # app.console.print(target.f)
         return
     target.f = new_freq
 
 
 @cell_app.command(name='gain')
 def cell_gain(
-    new_gain: Annotated[float, Argument()] = None,
+    new_gain: Annotated[Optional[float], Argument()] = None,
     *,
-    target: Annotated[object, Parameter(show=False)] = None,
+    target: Annotated[object, Parameter(parse=False)],
 ):
     """Get or set the gain of the specified EQ cell.
 
     Parameters
     ----------
-    new_gain : float
+    new_gain : float, optional
         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)
+        # app.console.print(target.gain)
         return
     target.gain = new_gain
 
 
 @cell_app.command(name='quality')
 def cell_q(
-    new_q: Annotated[float, Argument()] = None,
+    new_q: Annotated[Optional[float], Argument()] = None,
     *,
-    target: Annotated[object, Parameter(show=False)] = None,
+    target: Annotated[object, Parameter(parse=False)],
 ):
     """Get or set the Q of the specified EQ cell.
 
     Parameters
     ----------
-    new_q : float
+    new_q : float, optional
         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)
+        # app.console.print(target.q)
         return
     target.q = new_q
 
 
 @cell_app.command(name='type')
 def cell_type(
-    new_type: Annotated[int, Argument()] = None,
+    new_type: Annotated[Optional[int], Argument()] = None,
     *,
-    target: Annotated[object, Parameter(show=False)] = None,
+    target: Annotated[object, Parameter(parse=False)],
 ):
     """Get or set the type of the specified EQ cell.
 
     Parameters
     ----------
-    new_type : int
+    new_type : int, optional
         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)
+        # app.console.print(target.type)
         return
     target.type = new_type

src/vban_cli/error.py

@@ -0,0 +1,14 @@
+class VbanCLIError(Exception):
+    """Base class for exceptions in this module."""
+
+    def __init__(self, message: str, code: int = 1):
+        super().__init__(message)
+        self.code = code
+
+
+class VbanCLIConnectionError(VbanCLIError):
+    """Exception raised for connection errors."""
+
+
+class VbanCLIValidationError(VbanCLIError):
+    """Exception raised for validation errors."""

src/vban_cli/gainlayer.py

@@ -1,8 +1,7 @@
-from typing import Annotated
+from typing import Annotated, Optional
 
 from cyclopts import App, Argument, Parameter
 
-from . import console
 from .context import Context
 from .help import GainlayerHelpFormatter
 
@@ -11,20 +10,17 @@ app = App(name='gainlayer', help_formatter=GainlayerHelpFormatter())
 
 @app.meta.default
 def launcher(
-    gainlayer_index: Annotated[int, Argument()] = None,
+    gainlayer_index: Annotated[int, Argument()],
+    /,
     *tokens: Annotated[str, Parameter(show=False, allow_leading_hyphen=True)],
-    index: Annotated[int, Argument()] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """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)
@@ -32,20 +28,20 @@ def launcher(
 
 @app.command(name='level')
 def level(
-    new_level: Annotated[float, Argument()] = None,
+    new_level: Annotated[Optional[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,
+    strip_index: Annotated[int, Parameter(parse=False)],
+    gainlayer_index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the level of the specified gainlayer.
 
     Parameters
     ----------
-    new_level : float
+    new_level : float, optional
         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)
+        app.console.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

@@ -1,4 +1,4 @@
-from typing import Annotated
+from typing import Annotated, Optional
 
 from cyclopts import App, Argument, Parameter
 
@@ -8,50 +8,33 @@ from .help import StripHelpFormatter
 app = App(name='gate', help_formatter=StripHelpFormatter())
 
 
-@app.meta.default
-def launcher(
-    *tokens: Annotated[str, Parameter(show=False, allow_leading_hyphen=True)],
-    index: Annotated[int, Argument()] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
-):
-    """Control the compressor parameters."""
-    additional_kwargs = {}
-    command, bound, _ = app.parse_args(tokens)
-    if index is not None:
-        additional_kwargs['index'] = index
-    if ctx is not None:
-        additional_kwargs['ctx'] = ctx
-
-    return command(*bound.args, **bound.kwargs, **additional_kwargs)
-
-
 @app.command(name='knob')
 def knob(
-    new_knob: Annotated[float, Argument()] = None,
+    new_knob: Annotated[Optional[float], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the knob of the specified gate.
 
     Parameters
     ----------
-    new_knob : int, optional
+    new_knob : float, optional
         If provided, sets the knob to this value. If not provided, the current knob is printed.
     """
     if new_knob is None:
         # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
-        # console.out.print(ctx.client.strip[index].gate.knob)
+        # app.console.print(ctx.client.strip[index].gate.knob)
         return
     ctx.client.strip[index].gate.knob = new_knob
 
 
 @app.command(name='threshold')
 def threshold(
-    new_threshold: Annotated[float, Argument()] = None,
+    new_threshold: Annotated[Optional[float], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the threshold of the specified gate.
 
@@ -62,6 +45,111 @@ def threshold(
     """
     if new_threshold is None:
         # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
-        # console.out.print(ctx.client.strip[index].gate.threshold)
+        # app.console.print(ctx.client.strip[index].gate.threshold)
         return
     ctx.client.strip[index].gate.threshold = new_threshold
+
+
+@app.command(name='damping-max')
+def damping_max(
+    new_damping_max: Annotated[Optional[float], Argument()] = None,
+    *,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
+):
+    """Get or set the damping max of the specified gate.
+
+    Parameters
+    ----------
+    new_damping_max : float, optional
+        If provided, sets the damping max to this value. If not provided, the current damping max is printed.
+    """
+    if new_damping_max is None:
+        # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
+        # app.console.print(ctx.client.strip[index].gate.damping)
+        return
+    ctx.client.strip[index].gate.damping = new_damping_max
+
+
+@app.command(name='bp-sidechain')
+def bp_sidechain(
+    new_bp_sidechain: Annotated[Optional[float], Argument()] = None,
+    *,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
+):
+    """Get or set the BP sidechain of the specified gate.
+
+    Parameters
+    ----------
+    new_bp_sidechain : float, optional
+        If provided, sets the BP sidechain to this value. If not provided, the current BP sidechain is printed.
+    """
+    if new_bp_sidechain is None:
+        # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
+        # app.console.print(ctx.client.strip[index].gate.bpsidechain)
+        return
+    ctx.client.strip[index].gate.bpsidechain = new_bp_sidechain
+
+
+@app.command(name='attack')
+def attack(
+    new_attack: Annotated[Optional[float], Argument()] = None,
+    *,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
+):
+    """Get or set the attack of the specified gate.
+
+    Parameters
+    ----------
+    new_attack : float, optional
+        If provided, sets the attack to this value. If not provided, the current attack is printed.
+    """
+    if new_attack is None:
+        # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
+        # app.console.print(ctx.client.strip[index].gate.attack)
+        return
+    ctx.client.strip[index].gate.attack = new_attack
+
+
+@app.command(name='hold')
+def hold(
+    new_hold: Annotated[Optional[float], Argument()] = None,
+    *,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
+):
+    """Get or set the hold of the specified gate.
+
+    Parameters
+    ----------
+    new_hold : float, optional
+        If provided, sets the hold to this value. If not provided, the current hold is printed.
+    """
+    if new_hold is None:
+        # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
+        # app.console.print(ctx.client.strip[index].gate.hold)
+        return
+    ctx.client.strip[index].gate.hold = new_hold
+
+
+@app.command(name='release')
+def release(
+    new_release: Annotated[Optional[float], Argument()] = None,
+    *,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
+):
+    """Get or set the release of the specified gate.
+
+    Parameters
+    ----------
+    new_release : float, optional
+        If provided, sets the release to this value. If not provided, the current release is printed.
+    """
+    if new_release is None:
+        # See https://github.com/onyx-and-iris/vban-cli?tab=readme-ov-file#implementation-notes - 2.
+        # app.console.print(ctx.client.strip[index].gate.release)
+        return
+    ctx.client.strip[index].gate.release = new_release

src/vban_cli/help.py

@@ -56,8 +56,16 @@ class StripHelpFormatter(BaseHelpFormatter):
             )
             if modified_usage == str(usage):
                 modified_usage = re.sub(
-                    r'(\S+\s+strip)\s+(\w+)', r'\1 <index> \2', str(usage)
+                    r'(\S+\s+strip)\s+(\w+)',
+                    r'\1 <index> \2 [OPTIONS] [ARGS]',
+                    str(usage),
                 )
+            # Handle main strip command and subcommand groups
+            modified_usage = re.sub(
+                r'\bCOMMAND\b(?!\s+\[)', 'COMMAND [OPTIONS]', modified_usage
+            )
+            # Remove the duplicate INDEX that gets automatically added by cyclopts
+            modified_usage = re.sub(r'\s+INDEX$', '', modified_usage)
             console.print(f'[bold]Usage:[/bold] {modified_usage}')
 
 
@@ -76,8 +84,16 @@ class BusHelpFormatter(BaseHelpFormatter):
             )
             if modified_usage == str(usage):
                 modified_usage = re.sub(
-                    r'(\S+\s+bus)\s+(\w+)', r'\1 <index> \2', str(usage)
+                    r'(\S+\s+bus)\s+(\w+)',
+                    r'\1 <index> \2 [OPTIONS] [ARGS]',
+                    str(usage),
                 )
+            # Handle main bus command and subcommand groups
+            modified_usage = re.sub(
+                r'\bCOMMAND\b(?!\s+\[)', 'COMMAND [OPTIONS]', modified_usage
+            )
+            # Remove the duplicate INDEX that gets automatically added by cyclopts
+            modified_usage = re.sub(r'\s+INDEX$', '', modified_usage)
             console.print(f'[bold]Usage:[/bold] {modified_usage}')
 
 
@@ -90,7 +106,9 @@ class EqHelpFormatter(BaseHelpFormatter):
         """Render the usage line with proper <index> placement for both strip and bus commands."""
         if usage:
             modified_usage = re.sub(
-                r'(\S+\s+)(\w+)(\s+eq\s+)(COMMAND)', r'\1\2 <index>\3\4', str(usage)
+                r'(\S+\s+)(\w+)(\s+eq\s+)(COMMAND)',
+                r'\1\2 <index>\3\4 [OPTIONS]',
+                str(usage),
             )
             console.print(f'[bold]Usage:[/bold] {modified_usage}')
 
@@ -105,9 +123,11 @@ class GainlayerHelpFormatter(BaseHelpFormatter):
         if usage:
             modified_usage = re.sub(
                 r'(\S+\s+strip)(\s+gainlayer\s+)(COMMAND)',
-                r'\1 <index>\2<[cyan]gainlayer_index[/cyan]> \3',
+                r'\1 <index>\2<[cyan]gainlayer_index[/cyan]> \3 [OPTIONS] [ARGS]',
                 str(usage),
             )
+            # Remove the duplicate GAINLAYER_INDEX that gets automatically added by cyclopts
+            modified_usage = re.sub(r'\s+GAINLAYER_INDEX$', '', modified_usage)
             console.print(f'[bold]Usage:[/bold] {modified_usage}')
 
 
@@ -121,7 +141,9 @@ class CellHelpFormatter(BaseHelpFormatter):
         if usage:
             modified_usage = re.sub(
                 r'(\S+\s+)(\w+)(\s+eq\s+cell\s+)(COMMAND)',
-                r'\1\2 <index>\3<[cyan]band[/cyan]> \4',
+                r'\1\2 <index>\3<[cyan]band[/cyan]> \4 [ARGS]',
                 str(usage),
             )
+            # Remove the duplicate BAND that gets automatically added by cyclopts
+            modified_usage = re.sub(r'\s+BAND$', '', modified_usage)
             console.print(f'[bold]Usage:[/bold] {modified_usage}')

src/vban_cli/recorder.py

@@ -3,7 +3,7 @@ from typing import Annotated
 
 from cyclopts import App, Parameter, validators
 
-from . import console, validation
+from . import validation
 from .context import Context
 from .help import BaseHelpFormatter
 
@@ -13,84 +13,84 @@ app = App(name='recorder', help_formatter=BaseHelpFormatter())
 @app.command(name='play')
 def play(
     *,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Start the recorder playback."""
     ctx.client.recorder.play()
-    console.out.print('Recorder playback started.')
+    app.console.print('Recorder playback started.')
 
 
 @app.command(name='pause')
 def pause(
     *,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Pause the recorder playback."""
     ctx.client.recorder.stop()
-    console.out.print('Recorder playback paused.')
+    app.console.print('Recorder playback paused.')
 
 
 @app.command(name='stop')
 def stop(
     *,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """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.console.print('Recorder stopped.')
 
 
 @app.command(name='replay')
 def replay(
     *,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Replay the recorder playback."""
     ctx.client.recorder.replay()
-    console.out.print('Recorder playback replay started.')
+    app.console.print('Recorder playback replay started.')
 
 
 @app.command(name='record')
 def record(
     *,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Start recording."""
     ctx.client.recorder.record()
-    console.out.print('Recorder recording started.')
+    app.console.print('Recorder recording started.')
 
 
 @app.command(name='pause-recording')
 def pause_recording(
     *,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Pause the recorder recording."""
     ctx.client.recorder.pause()
-    console.out.print('Recorder recording paused.')
+    app.console.print('Recorder recording paused.')
 
 
 @app.command(name='ff')
 def ff(
     *,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Fast forward the recorder playback."""
     ctx.client.recorder.ff()
-    console.out.print('Recorder playback fast forwarded.')
+    app.console.print('Recorder playback fast forwarded.')
 
 
 @app.command(name='rew')
 def rew(
     *,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Rewind the recorder playback."""
     ctx.client.recorder.rew()
-    console.out.print('Recorder playback rewound.')
+    app.console.print('Recorder playback rewound.')
 
 
 @app.command(name='load')
@@ -104,13 +104,13 @@ def load(
     ],
     /,
     *,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """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.console.print(f'Loaded file: {file_path}')
 
 
 @app.command(name='goto')
@@ -124,8 +124,8 @@ def goto(
     ],
     /,
     *,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """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.')
+    app.console.print(f'Went to timestamp {time_string} in recorder playback.')

src/vban_cli/strip.py

@@ -2,32 +2,31 @@ from typing import Annotated, Optional
 
 from cyclopts import App, Argument, Parameter
 
-from . import comp, console, denoiser, eq, gainlayer, gate
+from . import comp, denoiser, eq, gainlayer, gate
 from .context import Context
 from .help import StripHelpFormatter
 
 app = App(name='strip', help_formatter=StripHelpFormatter())
 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(comp.app, name='comp')
+app.command(gate.app, name='gate')
+app.command(denoiser.app, name='denoiser')
 app.command(gainlayer.app.meta, name='gainlayer')
 
 
 @app.meta.default
 def launcher(
-    index: Annotated[int, Argument()] = None,
+    index: Annotated[int, Argument()],
+    /,
     *tokens: Annotated[str, Parameter(show=False, allow_leading_hyphen=True)],
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Control the strip parameters."""
     additional_kwargs = {}
     command, bound, _ = app.parse_args(tokens)
     if tokens[0] == 'eq':
         additional_kwargs['eq_kind'] = app.name[0]
-    if index is not None:
     additional_kwargs['index'] = index
-    if ctx is not None:
     additional_kwargs['ctx'] = ctx
 
     return command(*bound.args, **bound.kwargs, **additional_kwargs)
@@ -37,8 +36,8 @@ def launcher(
 def mono(
     new_state: Annotated[Optional[bool], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the mono state of the specified strip.
 
@@ -48,7 +47,7 @@ def mono(
         If provided, sets the mono state to this value. If not provided, the current mono state is printed.
     """
     if new_state is None:
-        console.out.print(ctx.client.strip[index].mono)
+        app.console.print(ctx.client.strip[index].mono)
         return
     ctx.client.strip[index].mono = new_state
 
@@ -57,8 +56,8 @@ def mono(
 def solo(
     new_state: Annotated[Optional[bool], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the solo state of the specified strip.
 
@@ -68,7 +67,7 @@ def solo(
         If provided, sets the solo state to this value. If not provided, the current solo state is printed.
     """
     if new_state is None:
-        console.out.print(ctx.client.strip[index].solo)
+        app.console.print(ctx.client.strip[index].solo)
         return
     ctx.client.strip[index].solo = new_state
 
@@ -77,8 +76,8 @@ def solo(
 def mute(
     new_state: Annotated[Optional[bool], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the mute state of the specified strip.
 
@@ -88,7 +87,7 @@ def mute(
         If provided, sets the mute state to this value. If not provided, the current mute state is printed.
     """
     if new_state is None:
-        console.out.print(ctx.client.strip[index].mute)
+        app.console.print(ctx.client.strip[index].mute)
         return
     ctx.client.strip[index].mute = new_state
 
@@ -97,8 +96,8 @@ def mute(
 def gain(
     new_value: Annotated[Optional[float], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the gain of the specified strip.
 
@@ -108,7 +107,7 @@ def gain(
         If provided, sets the gain to this value. If not provided, the current gain is printed.
     """
     if new_value is None:
-        console.out.print(ctx.client.strip[index].gain)
+        app.console.print(ctx.client.strip[index].gain)
         return
     ctx.client.strip[index].gain = new_value
 
@@ -117,8 +116,8 @@ def gain(
 def a1(
     new_value: Annotated[Optional[bool], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the A1 state of the specified strip.
 
@@ -128,7 +127,7 @@ def a1(
         If provided, sets the A1 state to this value. If not provided, the current A1 state is printed.
     """
     if new_value is None:
-        console.out.print(ctx.client.strip[index].A1)
+        app.console.print(ctx.client.strip[index].A1)
         return
     ctx.client.strip[index].A1 = new_value
 
@@ -137,8 +136,8 @@ def a1(
 def a2(
     new_value: Annotated[Optional[bool], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the A2 state of the specified strip.
 
@@ -148,7 +147,7 @@ def a2(
         If provided, sets the A2 state to this value. If not provided, the current A2 state is printed.
     """
     if new_value is None:
-        console.out.print(ctx.client.strip[index].A2)
+        app.console.print(ctx.client.strip[index].A2)
         return
     ctx.client.strip[index].A2 = new_value
 
@@ -157,8 +156,8 @@ def a2(
 def a3(
     new_value: Annotated[Optional[bool], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the A3 state of the specified strip.
 
@@ -168,7 +167,7 @@ def a3(
         If provided, sets the A3 state to this value. If not provided, the current A3 state is printed.
     """
     if new_value is None:
-        console.out.print(ctx.client.strip[index].A3)
+        app.console.print(ctx.client.strip[index].A3)
         return
     ctx.client.strip[index].A3 = new_value
 
@@ -177,8 +176,8 @@ def a3(
 def a4(
     new_value: Annotated[Optional[bool], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the A4 state of the specified strip.
 
@@ -188,7 +187,7 @@ def a4(
         If provided, sets the A4 state to this value. If not provided, the current A4 state is printed.
     """
     if new_value is None:
-        console.out.print(ctx.client.strip[index].A4)
+        app.console.print(ctx.client.strip[index].A4)
         return
     ctx.client.strip[index].A4 = new_value
 
@@ -197,8 +196,8 @@ def a4(
 def a5(
     new_value: Annotated[Optional[bool], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the A5 state of the specified strip.
 
@@ -208,7 +207,7 @@ def a5(
         If provided, sets the A5 state to this value. If not provided, the current A5 state is printed.
     """
     if new_value is None:
-        console.out.print(ctx.client.strip[index].A5)
+        app.console.print(ctx.client.strip[index].A5)
         return
     ctx.client.strip[index].A5 = new_value
 
@@ -217,8 +216,8 @@ def a5(
 def b1(
     new_value: Annotated[Optional[bool], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the B1 state of the specified strip.
 
@@ -228,7 +227,7 @@ def b1(
         If provided, sets the B1 state to this value. If not provided, the current B1 state is printed.
     """
     if new_value is None:
-        console.out.print(ctx.client.strip[index].B1)
+        app.console.print(ctx.client.strip[index].B1)
         return
     ctx.client.strip[index].B1 = new_value
 
@@ -237,8 +236,8 @@ def b1(
 def b2(
     new_value: Annotated[Optional[bool], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the B2 state of the specified strip.
 
@@ -248,7 +247,7 @@ def b2(
         If provided, sets the B2 state to this value. If not provided, the current B2 state is printed.
     """
     if new_value is None:
-        console.out.print(ctx.client.strip[index].B2)
+        app.console.print(ctx.client.strip[index].B2)
         return
     ctx.client.strip[index].B2 = new_value
 
@@ -257,8 +256,8 @@ def b2(
 def b3(
     new_value: Annotated[Optional[bool], Argument()] = None,
     *,
-    index: Annotated[int, Parameter(show=False)] = None,
-    ctx: Annotated[Context, Parameter(show=False)] = None,
+    index: Annotated[int, Parameter(parse=False)],
+    ctx: Annotated[Context, Parameter(parse=False)],
 ):
     """Get or set the B3 state of the specified strip.
 
@@ -268,6 +267,6 @@ def b3(
         If provided, sets the B3 state to this value. If not provided, the current B3 state is printed.
     """
     if new_value is None:
-        console.out.print(ctx.client.strip[index].B3)
+        app.console.print(ctx.client.strip[index].B3)
         return
     ctx.client.strip[index].B3 = new_value

src/vban_cli/validation.py

@@ -1,9 +1,11 @@
 import re
 
+from .error import VbanCLIValidationError
+
 
 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.')
+        raise VbanCLIValidationError('Invalid time format. Expected HH:MM:SS.')
     return value

uv.lock

@@ -124,7 +124,7 @@ wheels = [
 
 [[package]]
 name = "vban-cli"
-version = "0.9.1"
+version = "0.12.1"
 source = { editable = "." }
 dependencies = [
     { name = "cyclopts" },
@@ -141,7 +141,7 @@ requires-dist = [
 
 [[package]]
 name = "vban-cmd"
-version = "2.8.1"
+version = "2.9.6"
 source = { editable = "../vban-cmd-python" }
 
 [package.metadata]