From PC-BSD Wiki
Revision as of 14:19, 19 August 2012 by Vater (Talk | contribs)

Jump to: navigation, search

(Sorry for the inconvenience)

PC-BSD's display wizard can be used to configure your video driver and display settings.

NOTE: if you have a newer NVIDIA card, double-check that the NVIDIA driver is installed in Control Panel System ManagerSystem PackagesHardware-Drivers and install it if it is not already installed. NVIDIA drivers for older cards on 32-bit systems are automatically installed with PC-BSD.

To access the display wizard, go to Control PanelDisplay or reboot the system and select "6 Run the Display Wizard" from the boot menu.

If you start the display wizard from Control Panel, you will receive the message shown in Figure 8.11a:

Figure 8.11a: Save Your Work Before Changing Display Settings


If you are not ready to reboot the system, press No and restart the Display wizard when you are ready. Once you select Yes, you will be prompted for the superuser password. The system will then reboot into the display wizard, shown in Figure 8.11b:

Figure 8.11b: Display Settings Wizard


This screen can be used to select the desired screen resolution, color depth, and video driver. If you select the "vesa" driver, it will always work but will provide sub-optimal performance. Click on the drop down menu to select the driver that most closely matches your video card name.

You can also use the drop down menus to change the screen resolution and color depth values. If the value you desire is not listed, it may be that the selected driver does not support that resolution or depth.

Advanced users can select their monitor's horizontal sync and vertical refresh rate in the Advanced tab, seen in Figure 8.11c:

Figure 8.11c: Advanced Tab of Display Settings


Use caution and refer to your monitor's documentation if you make any changes here. If you are not sure what you are doing, leave the default values as-is.

If your computer is connected to two monitors, check the box "Enable Dual-Head support".

When you are finished, click the Apply button for your settings to be tested. If anything goes wrong during testing, you should be taken back to this Display Settings screen so that you can try another setting. Once you are satisfied with the settings, click Yes when prompted to accept them.

Desktop Effects and Compiz

To prevent problems with video cards that do not support them, desktop effects (used by KDE) and compiz (used by other window managers) are disabled by default. You can change this default if your video card supports desktop effects.

To enable desktop effects while logged into KDE, click Control PanelSystem SettingsDesktop Effects to access the configuration screen shown in Figure 8.11d:

Figure 8.11d: Enabling Desktop Effects in KDE


Check the box "Enable desktop effects at startup". You can use the "All Effects" tab to get more information about each possible effect and to enable the effects that interest you.

If you do not use KDE, install txt=Missing Link[1] instead using Control Panel System ManagerSystem PackagesMiscCompiz. Once installed, you can configure Compiz by clicking SystemPreferencesCompizConfig Settings Manager while logged into GNOME or by typing ccsm from any desktop. This will open the screen shown in Figure 8.11e:

Figure 8.11e: Configuring Compiz



Until TTM is ported to PC-BSD, ATI/Radeon video cards will not be fully supported. If the screen goes blank or otherwise doesn't work when you select the HD version of the driver, selecting the non-HD version should allow you to use the card. Radeon HD5xxx and higher GPUs have no support for acceleration, 2D or 3D. At this time, these video cards can only use the Vesa driver.

If you are having problems with your display settings and would like to manually edit /etc/X11/xorg.conf or run Xorg --config, first tell the PC-BSD system to not automatically start X. You can temporarily stop your current X session and prevent additional sessions from starting by typing this command as the superuser:

/usr/local/etc/rc.d/gdm stop

This will drop you down to a console where you can try the instructions in the txt=Missing Link[2] to manually configure and test Xorg. Once you have a configuration that works for you, save it to /etc/X11/xorg.conf, and restart gdm to test the configuration:

/usr/local/etc/rc.d/gdm start

If your graphics white-out after a suspend or resume, try running this command as the superuser:

sysctl hw.acpi.reset_video=1

If that fixes the problem, carefully add this line to /etc/sysctl.conf:


If the monitor goes blank and doesn't come back, try running this command as your regular user account:

xset -dpms

If that fixes the problem, add that line to the .xprofile file in your home directory.


  1. http://www.compiz.org/
  2. http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/x-config.html
Personal tools