Getting Started
===============

Supported distros
-----------------

Sxmobar is currently packaged for Alpine Linux:

.. code-block:: sh

	$ doas apk add sxmobar

Manual installation
-------------------

Sxmobar depends on the Hare toolsuite: `hare`, `scdoc`

.. code-block:: sh

	$ git clone https://git.sr.ht/~stacyharper/sxmobar
	$ doas make install -C sxmobar


Usage
-----

.. code-block:: sh

	$ sxmobar -a first 10 "foo" # Add a component
	$ sxmobar -a second 20 "bar" # Add a component
	$ sxmobar
	foo bar
	$ sxmobar -D # Debug the bar status
	>foo< 10 first
	>bar< 20 second
	$ sxmobar -d first # Delete a component
	$ sxmobar
	bar
	$ sxmobar -r # reset
	$ sxmobar -a -f red -b blue -e bold first 10 foo # Foreground red, Background blue, Weight bold
	$ sxmobar [-o plain]
	foo # plain
	$ sxmobar -o tty
	foo # colored
	$ sxmobar -o pango
	<span foreground="red" background="blue" weight="bold">foo</span>
	$ sxmobar -o tty -w # watch
	foo # colored