Iarubá is a Linux-native audio control system that bridges physical hardware (Arduino-based sliders) with your system's audio. Inspired by deej, Iarubá is built from the ground up in Haskell with a focus on:

• Functional purity - Predictable, testable, maintainable code
• Modern UI/UX - Clean GTK-based interface with dark/light themes
• Linux-first - Full PulseAudio and PipeWire support
• Extensibility - Plugin system, profiles, and rich configuration

Control individual application volumes, master output, microphone input, and more with physical sliders connected to an Arduino.

• Hardware Integration - USB serial communication with Arduino-based sliders
• Granular Audio Control - Per-application volume, master volume, mic input
• Real-time Visualization - Live audio level meters with smooth animations
• Profile System - Quick-switch between audio configurations (work, gaming, streaming)

• GTK+ 3 GUI - Native Linux look and feel
• Dark/Light Themes - Automatic or manual theme switching
• System Tray Integration - Minimize to tray, quick controls
• Keyboard Shortcuts - Fully customizable hotkeys

• YAML-based Config - Human-readable, version-controllable
• Live Reload - Changes apply immediately without restart
• Validation - Detailed error messages for invalid configurations
• Auto-rollback - Automatically reverts to last working config on errors

• Integrated Task Manager - Track TODOs with priority and categorization
• Desktop Notifications - Reminders and audio event alerts
• Interactive Documentation - Built-in tutorials and help system
• Calendar Integration - Sync tasks with your calendar

• Automatic Documentation - Generated API docs and guides
• Comprehensive Testing - Property-based and integration tests
• CI/CD Ready - GitHub Actions workflows included
• Extensible Architecture - Clean module boundaries for easy contributions

System Dependencies:

# Debian/Ubuntu
sudo apt install libpulse-dev libgtk-3-dev libappindicator3-dev

# Fedora
sudo dnf install pulseaudio-libs-devel gtk3-devel libappindicator-gtk3-devel

# Arch Linux
sudo pacman -S libpulse gtk3 libappindicator-gtk3

Haskell Stack:

curl -sSL https://get.haskellstack.org/ | sh

Arduino Setup:

# Add user to dialout group for serial access
sudo usermod -a -G dialout $USER
# Log out and back in for changes to take effect

# Clone the repository
git clone https://github.com/yourusername/iaruba.git
cd iaruba

# Build
stack build

# Install to ~/.local/bin
stack install

# Run
iaruba

1. Build the Arduino Circuit:

   • Connect 5 potentiometers to analog pins A0-A4
   • See docs/guides/hardware-setup.md for detailed wiring diagrams

2. Upload Arduino Sketch:

   cd arduino/iaruba-mixer
   # Using Arduino IDE: Open and upload
   # OR using PlatformIO:
   pio run --target upload

3. Configure Serial Port:

   • Edit config/iaruba.yaml
   • Set serial_port to your Arduino device (e.g., /dev/ttyUSB0)

1. Launch Iarubá:

   iaruba

2. Configure Slider Mappings:

   • Click the settings icon or press Ctrl+,
   • Map each slider to applications or system outputs
   • Save configuration

3. Test Sliders:

   • Move physical sliders
   • Watch volume levels change in the GUI
   • Verify audio output adjusts accordingly

config/iaruba.yaml:

serial:
  port: /dev/ttyUSB0
  baud_rate: 9600

sliders:
  - id: 0
    name: "Master Volume"
    targets:
      - type: master

  - id: 1
    name: "Music"
    targets:
      - type: application
        name: "Spotify"
      - type: application
        name: "rhythmbox"

  - id: 2
    name: "Browser"
    targets:
      - type: application
        name: "Firefox"
      - type: application
        name: "Chrome"

  - id: 3
    name: "Communications"
    targets:
      - type: application
        name: "Discord"
      - type: application
        name: "Slack"

  - id: 4
    name: "Microphone"
    targets:
      - type: source
        name: "default_microphone"

audio:
  noise_reduction: default
  smooth_transitions: true
  transition_duration_ms: 50

gui:
  theme: dark
  show_visualizers: true
  tray_icon: true

• User Guide - Complete usage instructions
• Hardware Setup - Wiring diagrams and Arduino setup
• Configuration Reference - All config options explained
• API Documentation - Haddock-generated API docs
• Architecture Overview - For developers

iarubá/
├── src/               # Haskell source code
│   ├── Audio/        # PulseAudio/PipeWire integration
│   ├── GUI/          # GTK interface components
│   ├── Config/       # Configuration management
│   ├── Hardware/     # Serial communication
│   ├── Tasks/        # Task management system
│   └── Utils/        # Shared utilities
├── app/              # Main application entry point
├── test/             # Test suites
├── arduino/          # Arduino firmware
├── docs/             # Documentation
├── config/           # Example configurations
└── assets/           # Icons, themes, resources

# All tests
stack test

# Specific test suite
stack test :iaruba-test

# With coverage
stack test --coverage

# Watch mode (using ghcid)
ghcid --command "stack ghci iaruba:lib iaruba:test:iaruba-test" --test "main"

We use Ormolu for formatting and HLint for linting:

# Format all code
find src -name "*.hs" -exec ormolu -i {} \;

# Run linter
stack exec -- hlint src/

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

1. Fork the repository
2. Create a feature branch: git checkout -b feature/my-feature
3. Make your changes
4. Run tests: stack test
5. Format code: ormolu -i src/**/*.hs
6. Commit with descriptive message
7. Push and create a Pull Request

• Windows support via WASAPI
• macOS support via CoreAudio
• Plugin system for custom audio processors
• Web interface for remote control
• MIDI controller support
• Equalizer presets per application
• Cloud profile sync
• Mobile app for remote control

This project is inspired by:

• deej - The original hardware audio mixer
• PulseAudio - Linux audio server
• PipeWire - Modern multimedia framework

MIT License - see LICENSE for details.

• Issues: GitHub Issues
• Discussions: GitHub Discussions
• Documentation: Wiki