## BootChamp Help

### About

BootChamp is a small utility for quickly booting into Windows.

BootChamp greatly simplifies the way you can boot into your Boot Camp partition. Traditionally you would either open System Preferences and select your drive or restart and hold down the Option key. Both of these processes are cumbersome and take time. BootChamp reduces this task to a single menu.

The first time a restart is initiated with BootChamp, it will ask for the admin password. After this initial process, you will no longer need to enter your admin password again.

The next time you restart your computer, whether it's from within Windows or from turning on your computer, the original startup disk will be used. BootChamp does not modify your startup disk, it only temporarily sets the startup disk for the next restart.

### Custom Menubar Icon

BootChamp can display a custom image in its menu bar if you prefer to use your own over the built-in. To use a custom image, open Terminal and type:

`defaults write com.kainjow.BootChamp StatusImage <path>`

where <path> is the absolute path of your image. BootChamp will not scale it, so make sure it's the right size. Then relaunch BootChamp.

To use the built-in icon, run this command and then relaunch BootChamp:

`defaults delete com.kainjow.BootChamp StatusImage`

### Command Line Mode (experimental)

BootChamp can be run from the command line for integration with scheduling tools or other custom scripts. First run BootChamp normally to make sure it is properly installed and detects your Windows partition. To use this mode, run the BootChamp executable inside the app bundle with the `restart` parameter, e.g.:

`/Applications/BootChamp.app/Contents/MacOS/BootChamp restart`

The exit status `$?` will be 0 if successful. Here are some common error exit statuses and their meanings:

Status | Description
--- | ---
1 | No valid Windows Boot Camp partition found.
2 | BootChamp's helper tool needs to be installed. Run BootChamp normally to do an install.
5 | An error occurred attempting to set the boot device.
6 | Restart failed. Another process may be blocking the computer from restarting.

### Troubleshooting

#### The "Restart into Windows" menu is disabled.

Make sure your Boot Camp volume is mounted and visible in the Finder.

#### I am getting an "authentication failed" or "must run as root" error.

Delete the /Library/Application Support/BootChamp/BOHelper file and try again. A restart of the computer may help as well.

You can also view the logs at ~/Library/Application Support/BootChamp/Logs to see if there are any relevant error messages.

### Uninstall

- Remove BootChamp.app
- Remove /Library/Application Support/BootChamp/BOHelper
- Remove ~/Library/Application Support/BootChamp/Logs
- Remove BootChamp from the Login Items in System Preferences > Users & Groups (or Accounts on 10.6)
- Remove preferences by running in Terminal `defaults delete com.kainjow.BootChamp`

### Credits

Programming: Kevin Wojniak

App Icon: Tobiasz Usewicz

Localization:

- Croation: Alen Bajo
- Finnish: Nuutti Johansson
- French: sly, Slagt
- German: Angelo Cammalleri, Mathias Steinmacher
- Italian: Vincenzo Boiano, Antonio Rotundo
- Korean: 박우석
- Polish: Grzegorz Pawlik
- Portuguese: Bruno Gonçalves
- Russian: Oleg
- Swedish: Pär Boberg, Daniel Zandian, Staffan Kjell

### Release Notes:

- 1.7
  - Fixed detecting EFI installs for some non-standard disk layouts
  - Add experimental command line mode
  - Add About menu to simplify finding app version
- 1.6.4
  - Added German localization
  - Updated Swedish localization
- 1.6.3
  - Fixed performance issues at launch
- 1.6.2
  - Fixed errors when third-party NTFS drivers are installed
- 1.6.1
  - Fixed invalid code signing
  - Added Portuguese localization
- 1.6
  - Added compatibility for Windows EFI booting
  - Added Finnish and Korean localizations
- 1.5.3
  - Fixed possible (rare) crash.
- 1.5.2
  - Fixed bug which required the password to keep being reentered.
- 1.5.1
  - Fixed detecting some Windows volumes due to NTFS' file name case sensitivity.
  - Holding down Option shows the name of the volume that will be booted.
- 1.5
  - Improved detection of a Windows volume
  - Fixed potential crash
  - Added Croatian localization.
  - BootChamp now requires a 64-bit computer
- 1.4.1
  - BootChamp is now code signed with a Developer ID for full 10.8+ compatibility.
- 1.4
  - Improved compatibility with OS X 10.8.
  - Updated Swedish localization
- 1.3
  - Updated French localization
  - Added option to use a custom image (see help file)
  - Removed obsolete "Next restart only" preference.
  - BootChamp now requires 10.6.8 or greater.
- 1.2
  - BootChamp now only requires entering the administrative password once, instead of before each restart (the most requested feature!). This works by installing a helper tool into /Library/Application Support/BootChamp and giving it special permissions. If this file goes bad/missing, administrative access will be required to re-install.
  - Added support for Tuxera NTFS drivers.
  - Fixed a crash when reading certain volumes.
  - Fixed a bug where an error would display when selecting the Restart into Windows menu when there were multiple volumes to choose.
  - Built for 10.5 and up now instead of just 10.6, but completely untested on 10.5.
- 1.1
  - Requires 10.6 or greater. Built as a 32/64-bit binary.
  - Important: BootChamp's abilitiy to temporarily set the startup disk does not work with the unibody family of MacBooks, which includes the Air and Pro (and possibly newer Mac Pros). As far as I'm aware, this is an Apple bug. Previous versions of BootChamp would restart but would not boot into Windows. This new version adds a workaround preference "Next restart only" which is enabled by default. In order for the app to work on these newer computers, you must disable this preference. Unfortunatey, this workaround will set the start disk for all future restarts, so you must change it back when restarting back into Mac OS X. Note: this appears to be fixed in 10.6.3.
  - Added a preference "Launch at startup" enabled by default.
  - If BootChamp finds more than one potentially bootable drive, it will list them in the menu to choose from. When a bootable drive is mounted or unmounted, BootChamp will update appropriately.
  - Grand Central Dispatch is used when scanning drives to improve responsiveness of the application.
  - Added Italian localization
  - Added support for Paragon NTFS drivers
- 1.0.2
  - Fixed bug where BootChamp wouldn't recognize an NTFS drive if the MacFUSE NTFS-3G driver was installed
  - Cleaned up authentication dialog text to be clearer.
  - Properly localized the application. Polish now included.
- 1.0.1
  - Fixed bug where some NTFS partitions weren't detected
  - Fixed bug where the app would quit if you cancelled the authentication
- 1.0
  - Initial release for 10.5