[
  {
    "path": ".github/FUNDING.yml",
    "content": "liberapay: gdb\ncustom: 'https://www.paypal.me/gdbau'\n"
  },
  {
    "path": "README.md",
    "content": "# Linux ALSA Focusrite Control/Mixer Drivers\n\n## Overview\n\nFocusrite USB audio interfaces are class compliant, meaning they work\n“out of the box” on Linux as audio and MIDI interfaces\\*.\n\nHowever, to access device-specific features (like direct monitoring,\nhardware mixing, custom routing, and level meters), most models need\nadditional driver support.\n\nThis repository provides two drivers that extend the Linux kernel’s\naudio subsystem (ALSA), adding controls to make those features\navailable:\n\n- **Scarlett2**: A mature kernel driver supporting nearly every\n  Focusrite USB device from the 2nd Gen Scarlett range onwards.\n\n- **FCP**: A new hybrid kernel/user-space driver with support for the\n  new big 4th Gen Scarlett models (16i16, 18i16, and 18i20).\n\nNote:\n\n- Scarlett 1st Gen devices are supported by the Scarlett driver which\n  has been in the Linux kernel since 2014.\n\n- Scarlett 2nd Gen Solo, 2i2, and 2i4 have no software-accessible\n  controls, so no need for any special driver. All device-specific\n  functionality is accessible from the front panel.\n\n\\* Scarlett 3rd and 4th Gen and Vocaster interfaces need MSD (Mass\nStorage Device/“Easy Start”) mode disabled for full functionality.\nThis will be done automatically when you do a firmware update.\n\n## Supported Interfaces\n\n### Scarlett2 Driver\n\nScarlett Series:\n- 2nd Gen: 6i6, 18i8, 18i20\n- 3rd Gen: Solo, 2i2, 4i4, 8i6, 18i8, 18i20\n- 4th Gen: Solo, 2i2, 4i4\n\nClarett USB and Clarett+ Series:\n- 2Pre, 4Pre, 8Pre\n\nVocaster Series:\n- One, Two\n\n### FCP Driver\n\nScarlett 4th Gen:\n- 16i16, 18i16, 18i20\n\n## Kernel Version Requirements\n\nIf your device is supported by the Scarlett2 driver and your Linux\nkernel meets the minimum version listed below, you don’t need to\ninstall this driver as you already have it; jump ahead to the [Setup\nInstructions](#setup-instructions).\n\nThe `scarlett2` driver is already included in the Linux kernel,\nsupporting these models:\n\n- Scarlett 2nd Gen: Since Linux 5.4 (bug fixes in 5.14 and 6.7)\n- Scarlett 3rd Gen: Since Linux 5.14 (bug fixes in 6.7)\n- Scarlett 4th Gen (Solo/2i2/4i4): Since Linux 6.8\n- Clarett+ 8Pre: Since Linux 6.1 (bug fixes in 6.7)\n- Clarett USB and Clarett+ (2Pre/4Pre/8Pre): Since Linux 6.7\n- Vocaster: Since Linux 6.10\n\nThe `fcp` driver is included in Linux 6.14 and later.\n\n## Repository Purpose\n\nThis repository is a fork of the Linux kernel, used for:\n\n1. Sharing development code before it arrives in the mainstream kernel\n\n2. Sharing backports of the `scarlett2` and `fcp` drivers so you don’t\n   have to wait for your distribution to update to the kernel version\n   you need.\n\n## Installation Options\n\nIf your kernel already meets the minimum version requirements listed\nabove, you don't need to install anything; jump ahead to the [Setup\nInstructions](#setup-instructions).\n\nOtherwise, you can either:\n\n1. Module Installation (recommended):\n\n    - Download from\n      [Releases](https://github.com/geoffreybennett/linux-fcp/releases)\n    - Build and install the `snd_usb_audio` module following the\n      instructions in the enclosed `README.md`.\n\n2. Full Kernel Build:\n\n    - Check out the `fcp` branch\n    - Build the kernel normally\n\n## Setup Instructions\n\n### Scarlett2 Driver\n\n- Install the\n  [firmware](https://github.com/geoffreybennett/scarlett2-firmware).\n\n- Install and run [ALSA Scarlett\n  GUI](https://github.com/geoffreybennett/alsa-scarlett-gui) to update\n  your firmware and configure your device.\n\n### FCP Driver\n\n- Install the\n  [firmware](https://github.com/geoffreybennett/scarlett4-firmware).\n\n- Install the `fcp-server` user-space driver and the `fcp-firmware`\n  firmware update utility from the\n  [fcp-support](https://github.com/geoffreybennett/fcp-support) repo.\n\n- Update your firmware with `fcp-tool`.\n\n- Install and run [ALSA Scarlett\n  GUI](https://github.com/geoffreybennett/alsa-scarlett-gui) to\n  configure your device.\n\n## Support\n\nPlease report any issues with the kernel driver to:\n\n- https://github.com/geoffreybennett/linux-fcp/issues\n\nIf using the FCP driver, please report any issues with the user-space\ndriver or tools to:\n\n- https://github.com/geoffreybennett/fcp-support/issues\n\n## Contact\n\n- Author: Geoffrey D. Bennett\n- Email: g@b4.vu\n- GitHub: https://github.com/geoffreybennett\n\n## Donations\n\nThis software, including the driver, tools, and GUI is Free Software\nthat I’ve independently developed using my own resources. It\nrepresents hundreds of hours of development work.\n\nIf you find this software valuable, please consider making a donation.\nYour show of appreciation, more than the amount itself, motivates me\nto continue improving these tools.\n\nYou can donate via:\n\n- LiberaPay: https://liberapay.com/gdb\n- PayPal: https://paypal.me/gdbau\n- Zelle: g@b4.vu\n\n## Disclaimer Third Parties\n\nFocusrite, Scarlett, Clarett, and Vocaster are trademarks or\nregistered trademarks of Focusrite Audio Engineering Limited in\nEngland, USA, and/or other countries. Use of these trademarks does not\nimply any affiliation or endorsement of this software.\n"
  }
]