Fbpanel Configuration


MAIN

  • Geometry
  • Placement

    Move panel to screen edge: legal values are bottom or top for horizontal panels and left or right for vertical panels

    Alignment

    Align panel to screen geometry: legal values are left, center or right for horizontal panels and top, center or bottom for vertical panels

    Margins

    • Long-side margin: distance from screen edge to long side of panel. Note: this option does not apply to auto-hidden panels: Range=0-600, Default=0

    • Aligned margin: distance from screen edge to aligned side of panel. Note: this option does not apply to center-aligned panels: Range=0-1000, Default=0

    Size

    • Long-side dimension: Scale panel's long axis to percent of screen edge or dynamically scale to optimal size

    • Short-side dimension in pixels: Range=20-96, Default=28

    • Icon size in pixels: Range=16-96, Default=28

  • Appearance
  • Transparency

    Change color and transparency of panel background: legal values are true, false

    • Background color of panel: legal values are hex numbers; Default=#ffffff (white)

    • Opacity (panel transparency): legal values are numbers 0-255 (0=transparent, 255=opaque); Default=0

    Launchers

    Pixel-spacing between launcher icons: Range=1-10 (Default=1)

    Mouse-over tooltips of launcher icons: legal values are true, false

    Round corners

    Set panel corners to round shape: legal values are true, false

    • Corner radius (higher values increase corner circularity): legal values are numbers 0-25; Default=7

  • Properties
  • Autohide

    Hide panel off screen unless mouseover: legal values are true, false

    Desktop Margins

    Reserve space at the desktop margins so maximized windows do not cover the panel: legal values are true, false

    • Although this built-in feature of fbpanel is limited to maximized windows, the pfbpanel manager extends the function to new windows. Specifically, screen-edge placement (bottom, top, left, right) and height values of the main and accessory panels are automatically synchronized with corresponding openbox margin settings in rc.xml. Consequently, when this fbpanel option is enabled (true), the panel is not covered by new or maximized windows. When disabled (false), management of the desktop margins reverts to openbox alone.

    Dock

    Identify panel as a dock rather than a window: legal values are true, false

    Stacking

    Place panel above all windows, else below: legal values are true, false

    Panel Profile

    View default fbpanel configuration at $HOME/.config/fbpanel/default


    MENU

    Menu Button

    Show panel button for standard XDG pop-up menu: legal values are true, false

    • Button images are available in the drop-down list: legal values are png, jpg or svg images which fbpanel will auto-size for proper display.

    • If desired, additional menu-button images should be placed in the default button folder (usr/share/fbpanel/buttons).

    • One of the button images should be default.svg, which is used also for restoration of the pfbpanel configuration file.

    Menu Categories

    Show or hide primary application categories in the XDG menu of fbpanel: checkbox values are true, false

    Control Center

    Set default control panel: supported options include fbbox-control, PupControl, setupwizard

    Search

    Set default file search (file finder): supported options (if installed) include pfind, pfilesearch, searchmonkey, zfind

    Run

    Set default run dialog (application launcher): supported options (if installed) include gexec, gmrun, grun, pexec, prun, PupMenu, findnrun


    DESKTOP

    Panel Bars

    Show area in main panel for launching favorite applications: legal values are true, false

    Show launchbar in optional accessory panel with functions similar to the wbar quick-launch tool: legal values are true, false

    Show system information in optional accessory panel with functions similar to conky: legal values are true, false

    Desktop Windows

    Show panel button to iconify (left-click) or shade (middle-click) all desktop windows: legal values are true, false

    Desktop Pager

    Show panel area for switching to alternate desktops: legal values are true, false

    Position of pager: legal values are Left, Right

    The 'Manage virtual desktops' button calls obconf to set the number of virtual desktops.


    LAUNCHERS

    Available applications

    The available menu items are defined by .desktop files in /usr/share/applications, /usr/local/share/applications, /usr/share/applications/kde and /usr/share/applications/kde4. Up to twenty-five (12) application launchers are supported. The companion accessory panel (second launchbar panel similar to wbar) supports up to twenty-five (25) launchers.

    Panel applications

    Click Apply to create the panel launchers shown in the preview list.

    By default in FbBox, the windows of launchbar applications will open under the mouse cursor. If you prefer window placement in free areas of the desktop, uncheck (untick) the default setting in the Windows tab of the openbox configuration manager (obconf).

    Edit launcher files (.desktop files)

    The editing option is available if PupMenu is installed. This module facilitates changing launcher parameters defined by .desktop files, such as panel icons and tooltips.

    Remove selected launcher

    Quickly delete launchers from the panel.

    Move selected launcher up/down

    Easily change the placement/sequence of launchers in the panel.


    TASKBAR

    Size

    Expand taskbar to all available space on panel: legal values are true, false

    TaskList

    Show non-mapped iconified windows (minimized windows) in tasklist: legal values are true, false

    Show mapped iconified windows (non-minimized windows) in tasklist: legal values are true, false

    Show the cumulative tasklist of all desktop windows; if false, show only the tasklist of the current desktop: legal values are true, false

    • Maximum pixel-width of tasklist item: Range=20-250, Default=150

    Icons

    Show icons but no text in taskbar iconified windows: legal values are true, false

    Tooltips

    Show tooltips of taskbar iconified windows. Note: this option has no effect on launchbar, plugin or tray tooltips: legal values are true, false


    Plugins

    The Fbpanel Configuration Manager (pfbpanel) manages multiple panel plugins including the built-in notification applets such as powerapplet (battery monitor) or retrovol (volume control).

    Panel Notification

    Show notification icons in system tray: legal values are true, false

    Manage notification applications: launch wmstartups (available in Woof-CE Pups)

    System Information

    Show panel icon for system information menu: legal values are true, false

    Select calendar application: legal values are osmocal, xcalendar

    CPU Temperature

    Show current CPU core temperature: legal values are true, false

    • Text color: legal values are hex numbers; Default=#ffffff (white)

    • Sampling interval (time in seconds between temperature checks): Default=5

    • Tooltip stats: Show CPU temperature, speed and scaling in tooltip; legal values are true, false

    CPU Load

    Show total CPU load as percent of maximum: legal values are true, false

    • Graph color: legal values are hex numbers; Default=#00ff00 (lime)

    Memory

    Show current usage of RAM memory and swap space: legal values are true, false

    Two monitors are available: mem=progressbar, mem2=graph

    Disk I/O

    Show current read/write status of selected disk: legal values are true, false

    • Disk name: selected disk to display

    • Read color: legal values are hex numbers; Default=#ffff00 (yellow)

    • Write color: legal values are hex numbers; Default=#00ff00 (lime)

    • Read Max: float value used to scale chart; Default:50

    • Write Max: float value used to scale chart; Default:50

    Network Activity

    Show Tx/Rx traffic for the active network interface, with mouseover data stream: legal values are true, false

    • TX (send) color for display: legal values are hex numbers; Default=#ff0000 (red)

    • RX (receive) color for display: legal values are hex numbers; Default=#ffff00 (yellow)

    • TX (send) limit for proper scaling of display graph (maximum TX connection speed in KB/s): Default=10

    • RX (receive) limit for proper scaling of display graph (maximum RX connection speed in KB/s): Default=150

    Network Status

    Show status of active network interface: legal values are true, false

    • Text color: legal values are hex numbers; Default=#ffab00 (orange)

    • Sampling interval (time in seconds between network checks): Default=7

    • Tooltip stats: Show network stats in tooltip; legal values are true, false

    Battery

    Show notebook battery charge as a percentage of full capacity: legal values are true, false

    Single and dual-battery notebooks are supported (independent monitors for 1st and 2nd batteries).

    Typically, the battery slots are named BAT0 and BAT1 respectively, but may be proprietary (ex: C23A/C23B or CMB0/CMB1 in HP/Compaq PCs).

    In addition to the real-time display of battery capacity, this panel plugin features charge-status symbols (● full, ▲ charging, ▼ discharging), plus intermittent low-battery alerts at 10-15% residual charge, critical alerts at 5-10% capacity, and protective auto-shutdown (wmpoweroff) when battery capacity drops below 5%. The low-battery alerts and auto-shutdown are optional (enable/disable in pfbpanel). In dual-battery systems, the low-battery alert should be disabled for the battery which discharges first. This may be BAT0 or BAT1, depending on the system hardware. All pop-up alerts are automatically disabled when the battery is charging (AC adapter attached).

    • Battery ID (battery slot identification): Defaults=BAT0 and BAT1

    • Text color: legal values are hex numbers; Default=#ffff00 (yellow) for BAT0 and #00ff00 (lime) for BAT1

    • Sampling interval (time in seconds between battery checks): Default=30 for BAT0 and BAT1

    • Low-battery alert: legal values are true, false

    • Tooltip stats: Show battery stats in tooltip; legal values are true, false

    Note: If you prefer an alternate battery monitor, set both fbpanel battery monitors to false (off) and the panel will automatically default to other monitors currently installed (powerapplet_tray or vattery).

    Digital Clock

    Show panel clock in digital format: legal values are true, false

    • This option is available only when PupClockset is installed.

    Digital Clock (12/24)

    Show panel clock in 12h or 24h format: legal values are 12h, 24h, disable

    This default option is available only when PupClockset is not installed.

    • Text color: legal values are hex numbers; Default=#ffffff (white)

    • Set command to run on mouse-click (e.g. orage, osmo or set-time-for-puppy)

    Volume Control

    • Speaker icon color: legal values are hex numbers; Default=#00ff00 (lime)

    Note: This option is specifically available for standard retrovol speaker icons in the svg format.


    Pfbpanel License

     GNU GPLv2