From 733955c7d2c3135e68b9e4af1a6d1e6f1094cc0c Mon Sep 17 00:00:00 2001
From: onyx-and-iris <code@onyxandiris.online>
Date: Sat, 31 Jan 2026 02:04:33 +0000
Subject: [PATCH] add bus fadein and fadeout commands

---
 cmd/bus.go | 164 +++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 164 insertions(+)

diff --git a/cmd/bus.go b/cmd/bus.go
index 1b89391..960bfbe 100644
--- a/cmd/bus.go
+++ b/cmd/bus.go
@@ -5,6 +5,7 @@ package cmd
 
 import (
 	"fmt"
+	"time"
 
 	"github.com/spf13/cobra"
 )
@@ -57,8 +58,171 @@ var busMuteCmd = &cobra.Command{
 	},
 }
 
+// busFaderCmd represents the bus fader command
+var busFaderCmd = &cobra.Command{
+	Use:   "fader",
+	Short: "Get or set the bus fader level",
+	Long:  `Get or set the fader level of a specific bus.`,
+	Run: func(cmd *cobra.Command, args []string) {
+		client := ClientFromContext(cmd.Context())
+		if client == nil {
+			cmd.PrintErrln("OSC client not found in context")
+			return
+		}
+
+		if len(args) < 2 {
+			cmd.PrintErrln("Please provide bus number and fader level (in dB)")
+			return
+		}
+
+		busNum := mustConvToInt(args[0])
+		level := mustConvToFloat64(args[1])
+
+		err := client.SetBusFader(busNum, level)
+		if err != nil {
+			cmd.PrintErrln("Error setting bus fader level:", err)
+			return
+		}
+		cmd.Printf("Bus %d fader set to %.2f dB\n", busNum, level)
+	},
+}
+
+// busFadeOutCmd represents the bus fade out command
+var busFadeOutCmd = &cobra.Command{
+	Use:   "fadeout",
+	Short: "Fade out the bus fader over a specified duration",
+	Long: `Fade out the bus fader to minimum level over a specified duration in seconds.
+
+For example:
+  # Fade out bus 1 over 5 seconds
+  xair-cli bus fadeout 1 --duration 5
+`,
+	Run: func(cmd *cobra.Command, args []string) {
+		client := ClientFromContext(cmd.Context())
+		if client == nil {
+			cmd.PrintErrln("OSC client not found in context")
+			return
+		}
+
+		if len(args) < 1 {
+			cmd.PrintErrln("Please provide bus number")
+			return
+		}
+
+		busIndex := mustConvToInt(args[0])
+
+		duration, err := cmd.Flags().GetFloat64("duration")
+		if err != nil {
+			cmd.PrintErrln("Error getting duration flag:", err)
+			return
+		}
+
+		target := -90.0
+		if len(args) > 1 {
+			target = mustConvToFloat64(args[1])
+		}
+
+		currentFader, err := client.BusFader(busIndex)
+		if err != nil {
+			cmd.PrintErrln("Error getting current bus fader level:", err)
+			return
+		}
+
+		// Calculate total steps needed to reach target dB
+		totalSteps := float64(currentFader - target)
+		if totalSteps <= 0 {
+			cmd.Println("Bus is already faded out")
+			return
+		}
+
+		stepDelay := time.Duration(duration*1000/totalSteps) * time.Millisecond
+
+		for currentFader > target {
+			currentFader -= 1.0
+			err := client.SetBusFader(busIndex, currentFader)
+			if err != nil {
+				cmd.PrintErrln("Error setting bus fader level:", err)
+				return
+			}
+			time.Sleep(stepDelay)
+		}
+
+		cmd.Println("Bus fade out completed")
+	},
+}
+
+// BusFadeInCmd represents the bus fade in command
+var busFadeInCmd = &cobra.Command{
+	Use:   "fadein",
+	Short: "Fade in the bus fader over a specified duration",
+	Long: `Fade in the bus fader to maximum level over a specified duration in seconds.
+
+For example:
+  # Fade in bus 1 over 5 seconds
+  xair-cli bus fadein 1 --duration 5
+`,
+	Run: func(cmd *cobra.Command, args []string) {
+		client := ClientFromContext(cmd.Context())
+		if client == nil {
+			cmd.PrintErrln("OSC client not found in context")
+			return
+		}
+
+		if len(args) < 1 {
+			cmd.PrintErrln("Please provide bus number")
+			return
+		}
+
+		busIndex := mustConvToInt(args[0])
+
+		duration, err := cmd.Flags().GetFloat64("duration")
+		if err != nil {
+			cmd.PrintErrln("Error getting duration flag:", err)
+			return
+		}
+
+		target := 0.0
+		if len(args) > 1 {
+			target = mustConvToFloat64(args[1])
+		}
+
+		currentFader, err := client.BusFader(busIndex)
+		if err != nil {
+			cmd.PrintErrln("Error getting current bus fader level:", err)
+			return
+		}
+
+		// Calculate total steps needed to reach target dB
+		totalSteps := float64(target - currentFader)
+		if totalSteps <= 0 {
+			cmd.Println("Bus is already at or above target level")
+			return
+		}
+
+		stepDelay := time.Duration(duration*1000/totalSteps) * time.Millisecond
+
+		for currentFader < target {
+			currentFader += 1.0
+			err := client.SetBusFader(busIndex, currentFader)
+			if err != nil {
+				cmd.PrintErrln("Error setting bus fader level:", err)
+				return
+			}
+			time.Sleep(stepDelay)
+		}
+
+		cmd.Println("Bus fade in completed")
+	},
+}
+
 func init() {
 	rootCmd.AddCommand(busCmd)
 
 	busCmd.AddCommand(busMuteCmd)
+
+	busCmd.AddCommand(busFaderCmd)
+	busCmd.AddCommand(busFadeOutCmd)
+	busFadeOutCmd.Flags().Float64P("duration", "d", 5, "Duration for fade out in seconds")
+	busCmd.AddCommand(busFadeInCmd)
+	busFadeInCmd.Flags().Float64P("duration", "d", 5, "Duration for fade in in seconds")
 }