py3status Documentation Release 3.21 ultrabug Oct 14, 2019 Contents: 1 Introduction 1 1.1 About...................................................1 1.2 Philosophy................................................1 1.3 Installation................................................2 1.4 Support..................................................3 1.5 Usage...................................................3 2 Configuration 5 2.1 Loading a py3status module and ordering modules output.......................6 2.2 Configuring a py3status module.....................................6 2.3 py3status configuration section.....................................6 2.4 Configuration obfuscation........................................ 10 2.5 Configuring colors............................................ 11 2.6 Configuring thresholds.......................................... 12 2.7 Formatter................................................. 13 2.8 Urgent.................................................. 14 2.9 Grouping Modules............................................ 15 2.10 Custom click events........................................... 17 2.11 Special on_click commands....................................... 18 2.12 Module data and on_click commands.................................. 18 2.13 Environment Variables.......................................... 18 2.14 Inline Shell Code............................................. 19 2.15 Refreshing modules on udev events with on_udev dynamic options.................. 20 2.16 Request Settings............................................. 21 3 Modules 23 3.1 air_quality................................................ 23 3.2 apt_updates................................................ 25 3.3 arch_updates............................................... 26 3.4 async_script............................................... 26 3.5 aws_bill.................................................. 27 3.6 backlight................................................. 28 3.7 battery_level............................................... 28 3.8 bitcoin_price............................................... 30 3.9 bluetooth................................................. 30 3.10 check_tcp................................................. 31 3.11 clementine................................................ 32 i 3.12 clock................................................... 32 3.13 cmus................................................... 34 3.14 coin_balance............................................... 35 3.15 coin_market............................................... 37 3.16 conky................................................... 39 3.17 deadbeef................................................. 44 3.18 diskdata.................................................. 45 3.19 do_not_disturb.............................................. 46 3.20 dpms................................................... 47 3.21 dropboxd_status............................................. 48 3.22 emerge_status.............................................. 49 3.23 exchange_rate.............................................. 49 3.24 external_script.............................................. 50 3.25 fedora_updates.............................................. 51 3.26 file_status................................................. 51 3.27 frame................................................... 52 3.28 getjson.................................................. 53 3.29 github................................................... 54 3.30 gitlab................................................... 55 3.31 glpi.................................................... 57 3.32 google_calendar............................................. 57 3.33 gpmdp.................................................. 59 3.34 graphite.................................................. 60 3.35 group................................................... 61 3.36 hamster.................................................. 63 3.37 hddtemp................................................. 63 3.38 hueshift.................................................. 65 3.39 i3block.................................................. 66 3.40 i3pystatus................................................. 67 3.41 icinga2.................................................. 68 3.42 imap................................................... 69 3.43 insync................................................... 69 3.44 kdeconnector............................................... 70 3.45 keyboard_layout............................................. 71 3.46 keyboard_locks.............................................. 72 3.47 khal_calendar............................................... 73 3.48 lm_sensors................................................ 74 3.49 loadavg.................................................. 76 3.50 mail.................................................... 79 3.51 mega_sync................................................ 81 3.52 moc.................................................... 82 3.53 mpd_status................................................ 83 3.54 mpris................................................... 84 3.55 net_iplist................................................. 86 3.56 net_rate.................................................. 87 3.57 netdata.................................................. 88 3.58 networkmanager............................................. 89 3.59 ns_checker................................................ 90 3.60 nvidia_smi................................................ 91 3.61 nvidia_temp............................................... 92 3.62 online_status............................................... 93 3.63 pingdom................................................. 93 3.64 player_control.............................................. 94 3.65 pomodoro................................................. 95 ii 3.66 process_status.............................................. 96 3.67 rainbow.................................................. 96 3.68 rate_counter............................................... 97 3.69 rss_aggregator.............................................. 98 3.70 rt..................................................... 99 3.71 scratchpad_async............................................. 100 3.72 scratchpad_counter............................................ 100 3.73 screenshot................................................ 100 3.74 scroll................................................... 101 3.75 selinux.................................................. 101 3.76 spaceapi................................................. 102 3.77 speedtest................................................. 103 3.78 spotify.................................................. 105 3.79 sql.................................................... 106 3.80 static_string................................................ 108 3.81 sysdata.................................................. 108 3.82 systemd.................................................. 110 3.83 taskwarrior................................................ 111 3.84 thunderbird_todos............................................ 111 3.85 timer................................................... 114 3.86 timewarrior................................................ 115 3.87 tor_rate.................................................. 117 3.88 transmission............................................... 118 3.89 twitch................................................... 121 3.90 uname.................................................. 121 3.91 uptime.................................................. 122 3.92 usbguard................................................. 123 3.93 velib_metropole............................................. 124 3.94 vnstat................................................... 125 3.95 volume_status.............................................. 126 3.96 vpn_status................................................ 127 3.97 wanda_the_fish.............................................. 128 3.98 weather_owm............................................... 129 3.99 whatismyip................................................ 133 3.100 whoami.................................................. 134 3.101 wifi.................................................... 134 3.102 window_title............................................... 135 3.103 window_title_async........................................... 136 3.104 wwan................................................... 137 3.105 wwan_status............................................... 140 3.106 xkb_layouts................................................ 141 3.107 xrandr................................................... 142 3.108 xrandr_rotate............................................... 144 3.109 xscreensaver............................................... 145 3.110 xsel.................................................... 145 3.111 yandexdisk_status............................................ 146 3.112 yubikey.................................................. 147 4 py3-cmd 149 4.1 Commands available........................................... 149 4.2 Calling commands from i3........................................ 150 5 Writing custom py3status modules 153 5.1 Importing custom modules........................................ 153 iii 5.2 Publishing custom modules on PyPI................................... 153 5.3 Example 1: The basics - Hello World!.................................. 154 5.4 Example 2: Configuration parameters.................................