Skip to content
AbouZakaria edited this page Dec 25, 2019 · 5 revisions

Dependencies

  • libX11

  • libXcomposite

  • libXdamage

  • libQt5X11Extras

  • libQt5Widgets

  • libQt5Gui

  • libQt5Concurrent

  • libQt5DBus

  • libQt5Core

  • libGL

  • libpthread

Building from source

$ git clone https://github.com/zakariakov/qobbar.git
$ cd qobbar
$ qmake
$ make
$ sudo make install

##Uninstalling

$ cd qobbar && sudo make uninstall

Configuration

The configuration uses the NativeFormat CONF file format.

The default SystemScope paths "/etc/xdg/qobbar/qobbar.conf"

The default UserScope paths "$HOME/.config/qobbar/qobbar.conf"

  • create user configuration

    $ mkdir -p "$HOME/.config/qobbar"
    $ cp /etc/xdg/qobbar/qobbar.conf $HOME/.config/qobbar

or create any configuration file in "$HOME/.config/qobbar

the suffix ".conf" is obligatoire ex;"myconf.conf"

Running the app

"Usage: qobbar [OPTION]"
  "qobbar v: 0.1 "
  "OPTION:"
  " -h  --help                      Print this help."
  " -c  --config     <string>       config file name."
  "                                 ex: create file in $HOME/.config/qobbar/top-bar.conf "
  "                                 run \"qobbar -c top-bar\"  ."
  " -d  --debug                     Print debug in termminal."
  " -r  --right                     right-to-left layout direction."
  " -s  --showhide                  show or hide bar. ex: qobbar -c top-bar -s"
  " -l  --list                      Print list of available modules."

to run the default configuration just run "qobbar".

or cp any configuration in the example folder to $HOME/.config/qobbar.

to run any configuration ex: $HOME/.config/qobbar/top-bar.conf

$ qobbar -c top-bar

Available modules

Colors                        configured using this name 'Colors'.
Panel         		configured using this name 'Panel'.
Pager         		configured using this name 'Pager'.
Taskbar       		configured using this name 'Taskbar'.
Conky         		configured using this name 'Conky'.
Statu         		configured using any  name ex: 'Cpu' 'Mem'.
ActiveWindow                  configured using this name 'ActiveWindow'.

Available token

Colors

[Colors]
BgColor=#161925
FgColor=xrdb.color7
- ----------------------
[Panel]
Background=$BgColor
Foreground=$FgColor

Common

  • Background <string> color Hex or xrdb.color<num>

  • Foreground <string> color Hex or xrdb.color<num>

  • Underline <string> color Hex or xrdb.color<num>

  • Overline <string> color Hex or xrdb.color<num> to get color from Xresource ex: 'Background=xrdb.background' ex: 'Overline=xrdb.color5'

  • Border <int> default=0

  • BorderRadius <int> default 0

  • Alpha <int> 0-to-255 default=255

  • FontName <string> default parent fontfamily

  • FontSize <int> default parent font size

  • FontBold <bool> default window fontbold

Panel

  • Monitor <int> default 0

  • Top <bool> panel top or bottom default=true

  • BorderColor <string> color Hex or xrdb.color<num>

  • BarLeft <list> Ex:statu1,statu2

  • BarCenter <list> Ex:Time,Date

  • BarRight <list> Ex:Pager

To repeat the same statu, add ":" and then a number Ex:

[Panel]
 BarLeft=Sep:1,Cpu,Sep:2,Mem,Sep:3,Wifi
[Sep]
 Label="|"
 Color=#fff
  • BarLeftSpacing <int> default=0

  • BarRightSpacing <int> default=0

  • BarCenterSpacing <int> default=0

  • MarginLeft <int> default=0

  • MarginTop <int> default=0

  • MarginRight <int> default=0

  • MarginBottom <int> default=0

  • Systray <bool> default=false

  • PaddingBottom <int> default=0

  • PaddingLeft <int> default=0

  • PaddingRight <int> default=0

  • PaddingTop <int> default=0

Pager and Taskbar

  • ActiveBackground <string> default window highlight

  • ActiveAlpha <int> 0-to-255 default=255

  • ActiveForeground <string> default window highlightText

  • ActiveUnderline <string> color Hex or xrdb.color

  • ActiveOverline <string> color Hex or xrdb.color

Pager

  • DesktopDesplay <string> "name" "index" "icon" default=index icon-[0-9] ex: home,office,multimedia, NOTE: The desktop name needs to match the name configured by the WM You can get a list of the defined desktops using: $ xprop -root _NET_DESKTOP_NAMES

  • IconsList <list> list of icon 0 to 9 ex: home,office,multimedia,…​

  • ActiveIcon <string> if DesktopDesplay==icon default=NULL

Conky

  • Command <string> conky file config. Ex:

    [Conky]
    Command=conky -c ~/conky/myconkyrc

ActiveWindow

  • CloseColor <string> color Hex or xrdb.color<num>

  • MaxColor <string> color Hex or xrdb.color<num>

  • MinColor <string> color Hex or xrdb.color<num>

  • CloseText <string> default="x"

  • MaxText <string> default="+"

  • MinText <string> default="-"

Status

  • Command <string> Command to desplay

  • Interval <int> second default 1

  • MaxSize <int> default 100

  • Label <string> default $Command ex:"  $Command "

  • ClickLeft <string> Command to exec

  • ClickRight <string> Command to exec

  • MouseWheelUp <string> Command to exec

  • MouseWheelDown <string> Command to exec

Example

[Panel]
BarLeft=Button,Pager,Taskbar
BarCenter=ActiveWindow
BarRight=Cpu,Time
Top=true
Background=#000000
;Foreground=xrdb.foreground
Alpha=150
Systray=true
[Pager]
#ActiveBackground=#ffffff
ActiveForeground=#ffffff
ActiveOverline=#ffff00
DesktopDesplay="icon"
IconsList=,,,,,,
ActiveIcon=
Foreground=#8A8383
Border=1
ActiveAlpha=0
[Taskbar]
ActiveForeground=#FFFFFF
ActiveOverline=#1E90FF
ActiveBackground=#ffffff
ActiveAlpha=20
Border=1
[Time]
Interval=12
Command="date +%H:%M\--%d/%m/%y"
Label="<span style=' color:#4BB94B;'> </span>"
FontBold=true
ClickLeft="zenity --calendar"
[Cpu]
;Command=$HOME/.config/qobbar/blocks.sh 1
Command=$HOME/.config/scripts/cpu_usage
Interval=2
Label= "<span style=' color:#FFFFFF ;'></span> "
Foreground=#FFFFFF
Overline=#ED163D
Border=1
[Button]
Label=
ClickLeft= qobmenu
Underline=#FF3A00
;Overline=#40BF4D
Border=1
Foreground=xrdb.foreground

Conky Example

myconkyrc file

conky.config = {
 out_to_x = false,
 own_window = false,
 out_to_console = true,
 background = false,
 update_interval = 5.0,
 temperature_unit = celsius,
};
conky.text = [[
      &nbsp; &nbsp;   ${time %a %d %b %Y} &nbsp;    ${time %H:%M}\
     <span style='color:\#BEFF99;'> &nbsp;   ${uptime_short}  </span>\
     <span style='color:\#00D7FF;'> &nbsp;  ${battery BAT1}  </span>\
     <span style='color:\#FE0059;'> &nbsp;   ${acpitemp}      </span>\
     <span style='color:\#63C68C;'> &nbsp;   ${memperc}%     </span>\
     <span style='color:\#FF8C00;'> &nbsp;   ${cpu cpu}%     </span>\
     <span style='color:\#00D7FF;'> &nbsp;    ${upspeedf wlp2s0}    ${downspeedf wlp2s0} </span>\
]];

qobbar.conf

[Conky]
Command=conky -c $HOME/.config/qobbar/myconkyrc
Background=xrdb.color0
FontName="xos4 Terminus"