SOCRANOP-CTL(1)

NAME
socranop-ctl - control Soundcraft Notepad series mixer USB audio routing from command line ,

SYNOPSIS
socranop-ctl (--help|--version)
socranop-ctl [--verbose] [--no-dbus] [--wait] --list
socranop-ctl [--verbose] [--no-dbus] [--wait] --set SOURCE

DESCRIPTION
socranop-ctl allows controlling a Soundcraft Notepad series mixer from the command line.

OPTIONS

--help
    Print command line help and exit.

--version
    Print the program version and exit.

--no-dbus
    Access the USB directly without going through the socranop-session-service D-Bus service.

(-w|--wait)
    If no compatible device is found, wait for one to appear (D-Bus mode only)

(-v|--verbose)
    Make the program output more information. Helpful for debugging.

(-l|--list)
    List the available source routing options. This includes the current routing, if known.

(-s|--set) N
    Set the source N to route to the USB capture input.

EXIT STATUS
If successful, returns 0. Non-0 exit codes indicate an error.

ENVIRONMENT

XDG_CONFIG_HOME
    When socranop-ctl is run with --no-dbus, it takes over handling device file and state files from socranop-session-service(1). See the socranop-session-service(1) ENVIRONMENT and FILES sections for more information.

FILES
/dev/bus/usb/NNN/MMM When socranop-ctl is run with --no-dbus, it takes over handling device file and state files from socranop-session-service(1). See the socranop-session-service(1) ENVIRONMENT and FILES sections for more information.

~/.config/${PACKAGE}/state/*.state
    When socranop-ctl is run with --no-dbus, it takes over handling device file and state files from socranop-session-service(1). See the socranop-session-service(1) ENVIRONMENT and FILES sections for more information.

NOTES
When socranop-ctl is run with --no-dbus, the USB device file must be readable and writable for the socranop-ctl process. For more information on permission setup, see https://github.com/socratools/socranop/blob/main/PERMISSIONS.md

BUGS
For reading about known bugs and for filing new bugs, please go visit https://github.com/socratools/socranop/issues.

EXAMPLES

    [user@host ~]$$ socranop-ctl --list
    Detected a Notepad-12FX (fw v1.09)
    -----------------------------
    capture_1 <- Mic/Line 1
    capture_2 <- Mic/Line 2
    -----------------------------
                 Mic/Line 3 [0]
                 Mic/Line 4
                 Stereo 5/6 L [1]
                 Stereo 5/6 R
    capture_3 <- Stereo 7/8 L [2]
    capture_4 <- Stereo 7/8 R
                 Mix L [3]
                 Mix R
    -----------------------------
    [user@host ~]$$ _

    [user@host ~]$$ socranop-ctl --set 3
    Detected a Notepad-12FX (fw v1.09)
    -----------------------------
    capture_1 <- Mic/Line 1
    capture_2 <- Mic/Line 2
    -----------------------------
                 Mic/Line 3 [0]
                 Mic/Line 4
                 Stereo 5/6 L [1]
                 Stereo 5/6 R
                 Stereo 7/8 L [2]
                 Stereo 7/8 R
    capture_3 <- Mix L [3]
    capture_4 <- Mix R
    -----------------------------
    [user@host ~]$$ _

SEE ALSO
socranop-gui(1), socranop-session-service(1), https://github.com/socratools/socranop/blob/main/PERMISSIONS.md