File: i3blocks.1.adoc

package info (click to toggle)
i3blocks 1.5-1
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 548 kB
  • sloc: ansic: 2,439; makefile: 30; javascript: 29; sh: 19
file content (74 lines) | stat: -rw-r--r-- 1,917 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
:progname: i3blocks

= {progname}(1)

== NAME

{progname} - A feed generator for text based status bars

== SYNOPSIS

*{progname}* [_OPTION_]...

== DESCRIPTION

The {progname}(1) command generates a status line for i3bar(1).
It schedules command lines described in a simple configuration file at specified time intervals, upon signal reception or on clicks.

== OPTIONS

*-h*::
Show the help message and exit.

*-c* _CONFIGFILE_::
Specifies an alternate configuration file path.

*-v*::
Increase log level.
This option is a cumulative.
By default only fatal errors are shown in the status bar.
Passing this option once will show error messages as well.
Using *-vv* and more will show more debug output on standard error.

== CONFIGURATION

{progname} must be defined as the status line command of the *bar* block described in your i3(1) configuration file:

[source]
----
bar {
  status_command i3blocks
}
----

By default, {progname} looks for a configuration file in the following order (note that /etc may be prefixed with /usr/local depending on the compilation flags):

. _$XDG_CONFIG_HOME/i3blocks/config_ (or _~/.config/i3blocks/config_)
. _~/.i3blocks.conf_
. _$XDG_CONFIG_DIRS/i3blocks/config_ (or _/etc/xdg/i3blocks/config_)
. _/etc/i3blocks.conf_

For the content of the configuration file, please refer to the i3blocks website: https://vivien.github.io/i3blocks

== SEE ALSO

i3(1), i3bar(1), i3status(1)

== AUTHORS

{progname} is written by Vivien Didelot and other contributors.

== RESOURCES

*Project web site:* https://vivien.github.io/i3blocks

*Git source repository and issue tracker:* https://github.com/vivien/i3blocks

*Official collection of scripts for {progname}:* https://github.com/vivien/i3blocks-contrib

*i3bar protocol:* http://i3wm.org/docs/i3bar-protocol.html

== COPYING

Copyright (C) Vivien Didelot.
Free use of this software is granted under the terms of the _GPLv3+_ License.