User Tools

Site Tools


BoinxTV Preferences

You can open up the Preference Window by selecting BoinxTVPreferences… (⌘,). Here you are able to adjust some of the BoinxTV behavior to your needs.

If you are told by Boinx Support to open up the Debug Preferences you have to hold down the option key ⌥ while selecting the menu item.


  • On Startup create a new Document: If this option is checked BoinxTV will prompt you with the Template Chooser every time BoinxTV gets started.
  • When Adding a Layer enable it immediately: When you create a new layer in your layer stack (either by dragging it from the layer repository or duplicating an existing one) this layer will be live immediately.
  • Save Recorded Movies To: If you are using BoinxTV to record your show live to disc this is the location where the movie file will get stored. The box below shows you the current available disc space and displays a warning if something is wrong with the location.
  • Recording Format: When BoinxTV is recording directly to disc you can specify in which video codec the resulting movie file should be encoded. Read this FAQ about What Codec should I use in BoinxTV for recording for further information. This is the default setting for new documents but you can change it per document and it will reopen with your saved setting.
  • Frame Rate: Depending on your needs you can setup the recording frame rate. PAL (25 FPS) is for european TV whereas NTSC (30 FPS) is for US TV. This is the default setting for new documents but you can change it per document and it will reopen with your saved setting.
  • Reference Mode for Media Files: Media files used in your project (like video footage or images) could be very large and you probably don't want to have multiple copies of them on your hard disk. You can choose the default way in which BoinxTV will add media to your document: Copied into document means that the media file is stored safely inside the saved BoinxTV document and won't get lost if the document gets moved around. Absolute path means that only the file path is stored inside the BoinxTV document. This saves space but the reference to the file will break if the media file gets moved.
  • Common Media Folder: This is an application-wide setting that allows you to assign a folder that can store media files to be used by multiple projects. This works in a similar way to specifying an absolute path but instead of looking for the media at the exact location from where it was added, it will look for it in whatever folder is specified here. To utilize this option, the location of the common media folder needs to be set here first, then the necessary media files added to it, and then adding the media from this location as a source within the project. The source settings will now allow the reference type Media Folder Relative Reference. When a document with a source of this reference type is opened, BoinxTV will search for that media in the common mdeia folder set in the preferences. A possible use for this feature is when you have multiple documents or templates using the same large media files that need to be shared with many computers. Instead of wasting space with the media copied into every document, a single folder with the media can be copied to another computer along with the documents. After setting this location in the preferences on the other computer, all the documents will now find this media there.
  • Reference Mode (for the Common Media Folder): This is the default way in which media added from the Common Media Folder will be referenced in the document. Media Folder relative is likely the preferred method.


Here you can enable/disable audio and video input devices. These settings affect what is available to choose from when configuring camera and audio sources. Devices can be dragged to reorder how they appear in the drop-down menus.

  • For new documents: Create sources for all available devices: This makes BoinxTV add a source for every enabled device when a new document is created.


  • Use Screen: In the box below you can see your monitor setup of your computer system. If you have only one display you don't have much of a choice. If you happen to have multiple screens you can select on which display the full screen output should take place by clicking on it. It will be indicated by the red border. Below the screen selection you can read the pixels dimension of your selected display. If you want to change your display setup (e.g. change screen resolution or rearrange the location of your displays) please refer to the MacOS-X System Preference “Displays”.


Please note: The following options set defaults for new documents and don't affect existing ones! They affect how your movies will be handled after recording.

  • Export Window: Show after each Recording: When a recording is stopped an Export Sheet appears which gives you several options of what to do with your recorded movie file. This option controls whether or not this sheet will show up in your workflow.
  • QuickTime Format: Transcode to File: In the Export Sheet you will find an option to transcode your recording to another video codec. With this checkbox you can expand or collapse this export option.
  • Podcast Producer: Submit to Server: If your workflow is to send your recording to a Podcast Producer Server by Apple you can enter your credentials here. A list of the available workflows will show up in the Export Sheet.
    • Server: Enter the server name
    • Username: Enter your Podcast Producer User Name
    • Password: Enter the appropriate password. It will be saved securely in the MacOS-X System Keychain.
  • AppleScript: Execute script with File: If your workflow involves an execution of an Apple Script you can enable it with this checkbox. Please read the How-To Processing the movie file by an AppleScript after each recording how to take advantage of it.

    Software Update

  • Check for Updates: You can setup when BoinxTV should check for updates with Boinx Download Server. Available Options are: Hourly, Daily, Weekly, Monthly, Never.
  • Include Beta versions: If you want to be notified whenever we release a public beta of a new version of BoinxTV you should check this box. Please note that beta software is not ready to be used in a production environment! Use on your own risk!
  • System Profile: include anonymous information: You help us if you send anonymous information about your system with your software update request. You can check what information is sent by clicking on → Details on the right.

At the bottom of this panel you can see when BoinxTV last checked for an update.


In this panel you are able to login into your Twitter account. You have to do this if you want to use the Twitter Layer.


The Debug Preference panel contains options for warning and error logging. In general those options will slow down your system and isn't recommended to be used by regular BoinxTV users.

preferences.txt · Last modified: 2013/10/04 07:11 by achim