By using this site, you agree to have cookies stored on your device, strictly for functional purposes, such as storing your session and preferences.

Dismiss

 configuration.md

View raw Download
text/plain • 1.91 kiB
ASCII text

Configuring the Panorama panel

The panel loads all its configuration from a file ~/.config/panorama-panel/config.yaml. The format has a single top-level key panels which is a list of the panels to generate. Each panel has the following keys:

  • position: top, right, bottom or left; specifies the edge of the monitor to show the panel on

  • monitor: the index of the monitor to show the panel on (usually refers to the order in which the monitors are plugged in)

  • size: the thickness of the panel in pixels

  • autohide: whether the panel automatically hides leaving only 1px

  • hide_time: the duration in ms of the sliding animation (not applicable if autohide is false)

  • can_capture_keyboard: whether the panel can receive keyboard focus (works best with special compositor setup; check accessibility.md for details)

  • applets: a dictionary with keys left, centre, right; they are actually named wrong and are start/centre/end areas, each key has a list of applets, each applet is described by a dictionary with a single key being the class name and the value being a dictionary with configuration options (the options depend on the applet)

Example:

panels:
- position: top
 monitor: 0
 size: 40
 autohide: false
 hide_time: 300
 applets:
   left:
   - WFWindowList: {}
   centre: []
   right:
   - ClockApplet:
       formatting: '%T, %a %-d %b %Y'

The order the panels are specified in decides how they occupy the screen, thus, if you specify panel 1 on top, panel 2 on left, and panel 3 on bottom it will look like:

===========================
=111111111111111111111111111=
=22                         =
=22                         =
=22                         =
=22                         =
=22                         =
=22                         =
=223333333333333333333333333=
===========================
                
                    
1
Configuring the Panorama panel
2
------------------------------
3
4
The panel loads all its configuration from a file
5
`~/.config/panorama-panel/config.yaml`. The format has a single top-level key
6
`panels` which is a list of the panels to generate. Each panel has the following
7
keys:
8
9
* `position`: `top`, `right`, `bottom` or `left`; specifies the edge of the
10
monitor to show the panel on
11
* `monitor`: the index of the monitor to show the panel on (usually refers
12
to the order in which the monitors are plugged in)
13
* `size`: the thickness of the panel in pixels
14
* `autohide`: whether the panel automatically hides leaving only 1px
15
* `hide_time`: the duration in ms of the sliding animation (not applicable
16
if `autohide` is `false`)
17
* `can_capture_keyboard`: whether the panel can receive keyboard focus
18
(works best with special compositor setup; check
19
[accessibility.md](accessibility.md) for details)
20
* `applets`: a dictionary with keys `left`, `centre`, `right`; they are actually
21
named wrong and are start/centre/end areas, each key has a list of applets,
22
each applet is described by a dictionary with a single key being the class
23
name and the value being a dictionary with configuration options (the options
24
depend on the applet)
25
26
Example:
27
28
~~~yaml
29
panels:
30
- position: top
31
monitor: 0
32
size: 40
33
autohide: false
34
hide_time: 300
35
applets:
36
left:
37
- WFWindowList: {}
38
centre: []
39
right:
40
- ClockApplet:
41
formatting: '%T, %a %-d %b %Y'
42
~~~
43
44
The order the panels are specified in decides how they occupy the screen, thus,
45
if you specify panel 1 on top, panel 2 on left, and panel 3 on bottom it will
46
look like:
47
48
~~~
49
===========================
50
=111111111111111111111111111=
51
=22 =
52
=22 =
53
=22 =
54
=22 =
55
=22 =
56
=22 =
57
=223333333333333333333333333=
58
===========================
59
~~~
60