Chameleon 2 Users Guide V0.2

UsersGuide-v0.2

UsersGuide-v0.2

UsersGuide-v0.2

UsersGuide-v0.2

UsersGuide-v0.2

User Manual: Pdf

Open the PDF directly: View PDF .
Page Count: 11

Download
Open PDF In Browser	View PDF

Chameleon 2.0 Users Guide

Table of Contents
Running the Installer

Page 2

Custom Install

Page 3

Boot variables

Page 4

Custom boot.plist variables

Page 5

Theme customization

Page 6

Boot devices

Page 7

Bootprompt

Page 8

Infobox

Page 9

Menu

Page 10

Boot display

Page 11

Chameleon 2.0 Users Guide

Launching the Chameleon 2 installer:

You have the option of selecting “Install” using the default settings, “Customize” to pick
addition options or “Change Install Location” to pick a different volume to install to.

If you select Customize you have the option of selecting different themes or variables to be
passed at boot time to the kernel

Options
EHCIacquire
ForceWake
GUI
UHCIreset

Can fix some rare USB issues on boot.
Cleans the hibernate image on resume
GUI bootloader on or of
Reset USB for some rare USB issues on boot

Themes
Default theme and Twilight are offered as examples for you to use ,
Extras
Kexts for AHCI and Intel PIIXATA that will get installed into /Extra

Finishing Chameleon install

if you see this screen, your done, reboot and watch your computer load the new Chameleon
and enjoy the extra features that it has over the previous versions!
Booting
Chameleon is setup to automatically boot your operating system with the default settings but
has the ability to pass variables to the kernel. You can pass startup options to the kernel by
pressing any key when you see the boot logo and the type them to be sent to the operating
system after you hit enter.

Advanced startup options use the following syntax:
[device] [arguments]
Example arguments include
device: rd= device name> rd=*
(Device name sample rd=/dev/disk0s2)
(Device tree sample rd=*/PCI0@0/CHN0@0/@0:1)

Kernel: Sometimes you need to use a different kernel for testing, or you need to use the old
one after an install that didn’t work the way you wanted it too =)
kernel: kernel name
Sample: mach_kernel.voodoo

Flags allow you pass arguments without having to make them a permemant config settings.
Examples of valid flags are:
-v (verbose)
-s (single user mode),
-x (safe mode)
-f (ignore boot configuration file)
"Graphics Mode"="WIDTHxHEIGHTxDEPTH" (e.g. "1024x768x32")
For VESA 3.0 graphics, you may append a refresh rate after an "@" character (e.g.
"1280x1024x32@75")
kernel flags

(e.g. debug=0x144) io=0xffffffff
IOKit/IOKitDebug.h)

defined in

Example: mach_kernel rd=disk0s1 -v "Graphics Mode"="4096x4096x32@85"
If the computer won't start up properly, you may be able to start it up using safe mode.
Use the startup command “-x” to start up in safe mode, which ignores all cached driver files.
Special booter commands:
?memory Displays information about the computer's memory
?video Displays VESA video modes supported by the computer's BIOS.
?norescan Leaves CD-ROM rescan mode.
Additional useful command-line options:
config=

Use an alternate Boot.plist file.

Options useful in the com.apple.Boot.plist file:
"Boot Graphics"=Yes|No
"Quiet Boot"=Yes|No
Timeout=8
"Instant Menu"=Yes
GUI=No
USBBusFix=Yes
EHCIacquire=Yes
UHCIreset=Yes
Wake=No
ForceWake=Yes
WakeImage=
DropSSDT=Yes
DSDT=
Rescan=Yes
"Rescan Prompt"=Yes

Use graphics mode or text mode when starting.
Use quiet boot mode (no messages or prompt).
Number of seconds to pause at the boot: prompt.
Force displaying the partition selection menu.
Disable the GUI (enabled by default).
Enable the EHCI and UHCI fixes (disabled by default).
Enable the EHCI fix (disabled by default).
Enable the UHCI fix (disabled by default).
Disable wake up after hibernation (enbaled by default).
Force using the sleepimage (disabled by default).
Use an alternate sleepimage file (default path is
/private/var/vm/sleepimage).
Skip the SSDT tables while relocating the ACPI tables.
Use an alternate DSDT.aml file (default paths are /DSDT.aml
or /Extra/DSDT.aml).
Enable CD-ROM rescan mode.
Prompts for enable CD-ROM rescan mode.

Themes
Chameleon 2 lets you create or customize the bootloader themes! You can edit the file in
/Extra/Themes/Default/theme.plist. The following variables are changeable in the theme.plist
to customize your theme.

Screen
Set the display dimensions to use when in the graphic user interface, will attempt to find the
closest one available.
screen_width
screen_width
1024

1024 pixels wide screen

screen_height
screen_height
768

768 pixels high screen

screen_bgcolor
screen_bgcolor
#222334

web format #RRGGBB

Background
Set the position of background.png within the screen
background_pos_x
background_pos_x
-0

0 pixels from reverse origin along the x axis

background_pos_y
background_pos_y
-0

0 pixels from reverse origin along the y axis

Logo
Set the position of logo.png within the screen
logo_pos_x
logo_pos_x
0
logo_pos_y

0 pixels from origin along the x axis

logo_pos_y
0

0 pixels from origin along the y axis

Devices

Set the position of the device list within the screen
devices_pos_x
devices_pos_x


blank to center on the x axis

devices_pos_y
logo_pos_y


blank to center on the y axis

devices_max_visible
devices_max_visible

maximum number of devices visible

4

devices_icon_spacing
devices_icon_spacing

spaces between the drive icons

20

devices_layout
devices_layout
horizontal

horizontal or vertical list

devices_bgcolor
devices_bgcolor
#000000

devices_transparency

web format #RRGGBB

devices_transparency
128

0 (Opaque) -> 255 (Transparent)

Bootprompt

Set the position of the bootprompt within the screen
bootprompt_pos_x
bootprompt_pos_x


blank to center on the x axis

bootprompt_pos_y
bootprompt_pos_y


blank to center on the y axis

bootprompt_width
bootprompt_width
-20

20 pixels less than the screen's width window

bootprompt_height
bootprompt_height
20

20 pixel high window

bootprompt_textmargin_h
bootprompt_textmargin_h 8 pixel horizontal text margin left and right
8

bootprompt_textmargin_v

bootprompt_textmargin_v 4 px vertical text margin both top and bottom
4

bootprompt_bgcolor
bootprompt_bgcolor
0x333445

web format #RRGGBB

bootprompt_transparency
bootprompt_transparency
0

0 (Opaque) -> 255 (Transparent)

Infobox

Set the position of the infobox within the screen
infobox_pos_x
infobox_pos_x


blank to center on the x axis

infobox_pos_y
infobox_pos_y


blank center on the y axis

infobox_width
infobox_width
550

550 pixels wide

infobox_height
infobox_height
406

406 pixels high

infobox_bgcolor
infobox_bgcolor
#333445

web format #RRGGBB

infobox_transparency
infobox_transparency
64

0 (Opaque) -> 255 (Transparent)

Menu

Set the position of the pop up menu within the screen
menu_pos_x
menu_pos_x


center on the x axis

menu_pos_y
menu_pos_y


center on the y axis

menu_bgcolor
menu_bgcolor
#111223

web format #RRGGBB

menu_transparency
menu_transparency
0

0 (Opaque) -> 255 (Transparent)

Boot Display
Set the display dimensions to use when booting the kernel, will attempt to find the closest one
available.
boot_width
boot_width
1280

1280 pixels wide screen

boot_height
boot_height
1024

1024 pixels tall screen



---

Source Exif Data:

File Type                       : PDF
File Type Extension             : pdf
MIME Type                       : application/pdf
Linearized                      : No
Page Count                      : 11
PDF Version                     : 1.4
Title                           : Chameleon 2
Author                          : Kevyn Shortell
Subject                         : 
Apple Keywords                  : 
Creator                         : Microsoft Word
Producer                        : Mac OS X 10.5.6 Quartz PDFContext
Create Date                     : 2009:03:28 06:15:59Z
Modify Date                     : 2009:03:28 06:15:59Z

EXIF Metadata provided by EXIF.tools