dot-files — i3 status bar & desktop utilities
==============================================

Shell/Python daemons providing:
  - Status bar: UV score, air quality, weather, date, sound volume
  - Suspend to RAM on low battery
  - Easy screenshots
  - Night mode

Install: copy scripts to ~/.local/bin/
         copy config to ~/.config/i3/config
         run setup-redshift-timers to enable night mode (per-user)
         run setup-redshift-timers --global to install system-wide (root)
         run remove-redshift-timers to uninstall (same --global flag)

CONFIGURATION
-------------

Fill in swaystatus_env:

  SWAYSTATUS_ENABLE_SUSPEND_TO_RAM
  WAQI_TOKEN, WAQI_LOCATION
  OPENUV_TOKEN, OPENUV_LAT, OPENUV_LNG, OPENUV_ALT, OPENUV_SKIN_TYPE

swaystatus_launcher sources swaystatus_env then exec's swaystatus, keeping
tokens out of the process list.

Volume (upvolstatus writes to SWAYSTATUS_SOUND_EVENT; wire to volume keys):

  bindsym XF86AudioRaiseVolume exec chvol up     && upvolstatus
  bindsym XF86AudioLowerVolume exec chvol down   && upvolstatus
  bindsym XF86AudioMute        exec chvol toggle && upvolstatus


SUSPEND TO RAM
--------------

suspend_to_ram  counts down 30 s with critical desktop notifications, then
                suspends via dbus-send to org.freedesktop.login1.Manager.Suspend.
                Cancel by creating /tmp/suspend_to_ram/cancel (Mod+Ctrl+c).
                Called automatically by swaystatus on low-battery.


REDSHIFT
--------

  redshift-daemon               long-running loop that watches the clock and
                                calls redshift -O 2900 (warm) from 18:30 and
                                redshift -x (reset) from 05:30, sleeping until
                                the next transition.

  redshift-init.service         oneshot systemd service; applies the correct
                                redshift state immediately at graphical-session
                                login (so the screen is never wrong after unlock).

  redshift-sched.service        persistent systemd service that runs
                                redshift-daemon; restarts on failure.

  setup-redshift-timers           installs redshift-daemon to ~/.local/bin and
                                  redshift-sched.service to the systemd user
                                  directory, then enables and starts the service.

  setup-redshift-timers --global  same, system-wide (requires root).

  remove-redshift-timers          disables redshift-sched.service and removes
                                  both the service file and redshift-daemon.

  remove-redshift-timers --global  same, system-wide (requires root).


DISPLAY
-------

  screen-xrandr-display-below   position laptop screen (eDP1) below external
                                monitor (HDMI1):
                                  xrandr --output eDP1 --below HDMI1


NETWORK
-------

  reconnect-network-connection  cycle all active nmcli connections down then
                                up; sends a low-urgency desktop notification
                                per connection when done.


BATTERY
-------

  energy_poll   background daemon that samples BAT0/energy_now every 120 s
                and writes an estimated minutes-remaining value to
                /tmp/energy_poll/battery_left (used by swaystatus).
                Override cache dir name via ENERGY_POLL env var.


MISC
----

  scrot-c   area-selection screenshot → xclip clipboard
            bindsym $mod+shift+s exec scrot-c

  config    i3 config: Mod4, alacritty, dmenu, vim keys, xbacklight,
            playerctl, 1 px borders