# Tutorial - Recording Computer Playback on Mac

### From Audacity Development Manual

Mac computers have no built-in ability to record streaming audio playing on a sound device. You can use Soundflower to record computer playback directly into Audacity or can do so by using a connecting a loopback cable from audio out to the separate audio input available on some Macs.

Alternatively there are commercial applications which can record computer playback to a file that is importable into Audacity, or that like Soundflower can provide an additional audio device from which Audacity can record computer playback.

| Copyright or website restrictions may prevent you recording or distributing material. Check first.

## Contents

1. Soundflower - A free open source system add-on for Mac computers to record audio playing on the computer
2. Loopback cable - A simple and effective method of recording what is playing on the computer
3. Commercial - Commercial recording applications that include ability to record computer playback

## Soundflower

Soundflower is a free open source system add-on for Mac computers that allows you to route what is playing on the computer digitally back to the input without using a cable. Set Soundflower as your system output device, then in Audacity, set Soundflower as your recording device.

### Download Soundflower

- OS X 10.9 (Mavericks) and later including macOS: Soundflower-2.0b2.dmg from https://github.com/mattingalls/Soundflower/releases/.
- OS X 10.6 to 10.8 (Snow Leopard/Lion/Mountain Lion): Soundflower-1.6.6b.dmg from https://code.google.com/p/soundflower/downloads/list (if you are running NoScript you must disable it on that page).

### Obtaining Soundflowerbed if you install Soundflower 2.0b2

Important: The 2.0b2 version is the only version that will work on El Capitan and later. It can also be used on Mavericks or Yosemite but it lacks the "Soundflowerbed" application that lets you hear audio on your computer while Soundflower is set as the system output device. Fortunately Soundflowerbed from Soundflower 1.6.6b can be used on its own with Soundflower 2.0b2.

- If you already have Soundflower 1.6.x:
  1. Copy Soundflowerbed.app from the /Applications/Soundflower/ folder to your Desktop or somewhere else.
  2. In the same "Soundflower" folder, double-click "Uninstall Soundflower.scpt" to uninstall Soundflower 1.6.x. In the window that opens, press the "Run" button. You should see "Done!" in the results, indicating that the uninstallation completed satisfactorily.
  3. Reboot the computer then run the "Soundflower-2.0b2.dmg" installer as above.
- If you do not have Soundflowerbed.app: the easiest solution is to download it by clicking this link http://forum.audacityteam.org/download/file.php?id=14089. Unzip the "Soundflowerbed.app" from the download, then place it anywhere that is convenient.

### Install your chosen Soundflower version

1. To install the downloaded DMG file, double-click it to mount it. In the DMG itself, double-click the PKG file.

   | If you see a warning on OS X 10.7.5 or later that Soundflower cannot be opened due to your Security Preferences, right-click or control-click over the PKG file and choose "Open", then choose "Open" again.

2. After opening the PKG file, you may see a warning that the certificate for the installer has expired. Press "Show Certificate" to review the certificate then choose "Continue".
3. Then run through the standard installer steps. If you obtained the 1.6.x installer, save your work in other applications, then press the button in the installer to restart your Mac. The 2.x.x installer does not require restarting the computer.
4. Choose Apple Menu > System Preferences and select the Sound preferences panel.
5. In the Sound preferences panel, choose the Output tab, then select "Soundflower (2ch)" from the "Select a device for sound output:" list and turn the Output volume up.
6. In the same panel, choose the Input tab, select "Soundflower (2ch)" and and turn the Input volume up.
   - At this point you will no longer be able to hear what is playing on the computer. The sound output of the computer is being sent to Soundflower.
7. Click on the "Sound Effects" tab, and from the "Play sound effects through" dropdown menu choose "Line Out", "Headphones" or "Internal Speakers" (whichever is appropriate for your system).
   - This will route some system alert sounds (such as Mail alert sounds) to the Line Out or Internal Speakers and not to Soundflower. Thus these sounds will not be recorded by Audacity.

     Some Macintosh applications are better behaved than others when it comes to alert sounds. Tests on a recent iMac running 10.7.2 show that Mail and TextEdit alert sounds will not be recorded with the above setup, but iCal and Yahoo Messenger alert sounds will be recorded. To be safe you should disable the sound on any iCal alerts that may occur while you are recording, and quit any other application that may make an alert sound.

8. Close the System Preferences window.
9. Start Audacity.
10. In Audacity's Device Toolbar, select Built-in Output or similar as Playback Device and Soundflower (2ch) as Recording Device.
11. Click on the Transport menu and make sure that "Software Playthrough" is checked.
12. Go to the application that will be playing the sound you want to record. For example, start Safari and go to a website that plays sound clips. Start some audio playing.
13. Click on the recording level meters (beside the microphone symbol) to begin monitoring:
      You should now be able to hear the sound playing on your computer.
14. Now click Record to record anything playing on your computer.

### To set things back to "normal" so you can hear audio playing on your computer without running Audacity

1) Click on Apple Menu > System Preferences then the Sound panel, and select the Output tab. Select "Line Out", "Internal Speakers" or "Headphones" in the output device list. See step 3 above for an illustration.

2) In Audacity, if you want to record from a different source (such as the Line Input or an external USB device), click on Audacity > Preferences then the Devices section and select the input you want to record from in the Recording section. See step 7 above for an illustration.

### For help if you're stuck

Visit the Mac 2.0.x forum, click the "New Topic" button and ask your question.

### To hear what is playing on the computer while using Soundflower

When you install Soundflower 1.6.x, a new folder will be installed in your Applications folder called "Soundflower". Inside that folder is an app called "Soundflowerbed". Launch Soundflowerbed and it will install a "flower" menu at right of your menu bar.

| If you see a warning on OS X 10.7.5 or later that Soundflowerbed cannot be opened due to your Security Preferences, right-click or control-click over the app and choose "Open", then choose "Open" again.

The choices below the "Soundflower (2ch)" and "Soundflower (16ch)" menu items determine how the output of Soundflower will be monitored. "None (OFF)" means that you will not hear anything from your computer speakers. Selecting "Built-in Audio" will allow you to hear (monitor) the sound that is passing through Soundflower.

If you are using Soundflowerbed to monitor the sound, you will want to uncheck "Software Playthrough" in Audacity's Transport menu.

The original Soundflowerbed could not restart itself if the system was put to sleep then resumed. You can download a modified version that solves that problem and adds a volume control to Soundflowerbed.

## Use a loopback cable

This is a simple and effective method of recording what is playing on the computer. It has the disadvantage that the audio signal is converted from digital to analog, then from analog to digital, instead of staying in the digital domain. This may result in some slight increase in noise and distortion.

1. Using a cable with a stereo mini-plug (1/8") at each end, connect the headphone output port to the line input port.
   - At this point you will no longer be able to hear what is playing on the computer. As a workaround, you could attach a single to double stereo connector to the output port provide an extra jack for speakers or headphones.
2. Choose Apple Menu > System Preferences and select the Sound preferences panel.
3. In the Sound preferences panel:
   1. Click on the Output tab, then select "Line Out" from the "Choose a device for sound output" list.
   2. Click on the Input tab, then select "Line Input" from the "Choose a device for sound input" list.
   3. Leaving the Sound preferences panel open, start sound audio playing on the computer (this could be from iTunes, or streaming audio, or some other source).
   4. Adjust the Input volume slider so that the top 3 bars of the Input level meter do not light up on the loudest passages, but the rest of the bars do light up.
   5. Close the System Preferences window.
4. In Audacity's Device Toolbar select Built-in Input or similar as Recording Device. Note you need to choose a line-in for this, not a four-position port meant only for connecting a headset.
5. Click on the Transport menu and make sure that "Software Playthrough" is not checked.

| All system alert sounds such as email and application alerts will be recorded using this method. If you have iCal alerts or have turned on event sounds in Mail, you may want to turn them off. You should also quit any application that may make an alert sound while you are recording.

## Commercial applications

- Audio Hijack sold by Rogue Amoeba. It can "hijack" the sound output of any application and record that audio to disk in a number of formats. It requires OS X 10.9 or higher. For OS X 10.6 through 10.8, use Audio Hijack Pro 2 from https://rogueamoeba.com/legacy/#outdatedversions.

  Once you have captured the audio with Audio Hijack you can import the file into Audacity for editing. Audio Hijack records the sound output of a particular application so there is no danger of recording system alert sounds.

  If you need help editing the audio captured by Audio Hijack, have a look at our tutorial on editing an existing file.

- Sound Siphon sold by Static Z software. It is advertised for OS X 10.9 to 10.11 but also works on macOS 10.12 Sierra. Like Soundflower, Sound Siphon is a software package that makes your Mac’s audio output available as an audio input device. Turn Audacity's Software Playthrough off, because unlike Soundflower, you can automatically hear audio during recording.

## Links

|< Tutorial - Recording audio playing on the computer

##### Views

##### Useful External Links

- Forum
- Wiki
- Latest Release