aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--css/site.css16
-rw-r--r--img/lowbat-01.jpgbin0 -> 20035 bytes
-rw-r--r--org/lowbat.org66
-rw-r--r--projects/lowbat.php122
4 files changed, 165 insertions, 39 deletions
diff --git a/css/site.css b/css/site.css
index e970bd5..8a34d03 100644
--- a/css/site.css
+++ b/css/site.css
@@ -195,15 +195,18 @@ div.body-contents ul {
}
div.body-contents code {
+ font-family: SFMono-Regular, Consolas, "Liberation Mono", Menlo, monospace;
+ font-size: smaller;
background-color: #e4e4e4;
color: #24d;
- font-size: large;
border-radius: 5px;
padding: 2px 5px 2px 5px;
}
div.body-contents pre {
- background-color: #e4e4e4;
+ font-family: SFMono-Regular, Consolas, "Liberation Mono", Menlo, monospace;
+ font-size: smaller;
+ background-color: #d1e2f4;
border-radius: 4px;
display: block;
margin: 0;
@@ -231,6 +234,15 @@ div.body-contents pre.src {
border: 1px solid #1d2021;
}
+div#postamble {
+ border: 1px solid #89f;
+ width: 35%;
+ margin-top: 25px;
+ margin-left: 25px;
+ padding: 4px;
+ border-radius: 4px;
+}
+
span.fa {
font-size: 16px;
}
diff --git a/img/lowbat-01.jpg b/img/lowbat-01.jpg
new file mode 100644
index 0000000..46c4e83
--- /dev/null
+++ b/img/lowbat-01.jpg
Binary files differ
diff --git a/org/lowbat.org b/org/lowbat.org
index efa8a4e..a2fc8a5 100644
--- a/org/lowbat.org
+++ b/org/lowbat.org
@@ -1,25 +1,61 @@
#+TITLE: lowbat - lightweight low battery notifier
* Why lowbat?
- I've been using minimalist OS installations for work, personnal computing and playing video games for a while now.
-I used [[https://www.archlinux.org/][Arch Linux]], I still use [[https://gentoo.org/][Gentoo Linux]] - which is by far my favorite Linux distribution - as a desktop OS, and now I am using
-[[https://www.freebsd.org/][FreeBSD]] on my workstation.
+ I've been using minimalist OS installations for work, personnal computing
+and playing video games for a while now. I used [[https://www.archlinux.org/][Arch Linux]], I still use
+[[https://gentoo.org/][Gentoo Linux]] - which is by far my favorite Linux distribution - as a desktop
+OS, and now I am using [[https://www.freebsd.org/][FreeBSD]] on my workstation.
-Those operating systems and distributions basically come with a kernel, coreutils, a shell and that's pretty much it.
-Everything else has to be installed manually. I love this philosophy, the simplicity behind it and the fact that
-you know exactly what's on your system at any moment.
+Those operating systems and distributions basically come with a kernel,
+coreutils, a shell and that's pretty much it. Everything else has to be
+installed manually. I love this philosophy, the simplicity behind it and the
+fact that you know exactly what's on your system at any moment.
-As window managers, I used [[http://dwm.suckless.org/][dwm]] for a while, and I am now using [[https://github.com/baskerville/bspwm][bspwm]]. They are ultra-fast, very lightweight and do not bring
-extra bloatware to my systems. I do not use a status bar as well, I like my applications to use the full screen space available.
+As window managers, I used [[http://dwm.suckless.org/][dwm]] for a while, and I am now using [[https://github.com/baskerville/bspwm][bspwm]]. They
+are ultra-fast, very lightweight and do not bring extra bloatware to my systems.
+I do not use a status bar as well, I like my applications to use the full screen
+space available.
-A big problem for me with this setup for me was that they do not come with some kind of warning or notification system,
-like fancier desktop environments would, when my laptop battery is low. That also was before I started using *Emacs*, discovering
-the battery level indicator in the modeline. Ultimatly the frustration was too important when the computer kept shutting down in
-the middle of important work too many time. Then I decided to create lowbat to cure this issue.
+A big problem for me with this setup for me was that they do not come with some
+kind of warning or notification system, like fancier desktop environments would,
+when my laptop battery is low. That also was before I started using *Emacs*,
+discovering the battery level indicator in the modeline. Ultimatly the
+frustration was too important when the computer kept shutting down in
+the middle of important work too many time. Then I decided to create *lowbat*
+to cure this issue.
-It started as a very short ~dash~ shell (get [[https://github.com/tklauser/dash][dash]] here) script that was working fine but I wanted to experiment a little bit with this.
-It turned into a ~C++~ program, which is still the case for the GNU/Linux version. Switching to FreeBSD, I exerimented again by
-turning it into an ~x64 assembly~ program, following the *Intel* syntax. These days, I am rewriting it with the *AT&T* syntax.
+* History of lowbat
+ It started as a very short ~dash~ shell (get [[https://github.com/tklauser/dash][dash]] here) script that was
+working fine but I wanted to experiment a little bit with this. It turned into
+a ~C++~ program, which is still the case for the GNU/Linux version.
+Switching to FreeBSD, I exerimented again by turning it into an
+~x64 assembly~ program, following the *Intel* syntax. In that way *lowbat* is
+even more lightweight and consumes less battery power.
+These days, I am rewriting it in the *AT&T* syntax.
+
+* How it works
+** libnotify lowbat
+ The principle of *lowbat* is rather simple. When it's running in the
+background, it checks every 4 minutes whether your battery is above 15%.
+If that is the case, it sleeps for another 4 minutes. When your battery runs
+bellow 15%, *lowbat* checks your battery level every 20 seconds as well as
+sending you a *notification* using ~libnotify~. You can display live
+notifications on your desktop using ~dunst~ for example, as well as many
+other I'm sure.
+
+#+CAPTION: A notification generated by lowbat, displayed by dunst
+#+NAME: fig:lowbat-example
+[[../img/lowbat-01.jpg]]
+
+** espeak lowbat
+ *lowbat* also has an option to send a custom voice message to the use
+using ~espeak~. Very handy if you are not in front of your computer or
+if you want to bring joy to this dramatic event.
+
+** unknown lowbat
+ Sadly, I wasn't able to test lowbat on machines with more that one
+battery. My call is that it will only warn you for the /first/ battery,
+but I can't be sure. Try it and tell me!
* Links to lowbat
- GNU/Linux: [[https://github.com/JozanLeClerc/lowbat][lowbat's GitHub GNU/Linux repository]]
diff --git a/projects/lowbat.php b/projects/lowbat.php
index 7dbc3df..19f8584 100644
--- a/projects/lowbat.php
+++ b/projects/lowbat.php
@@ -243,55 +243,133 @@ for the JavaScript code in this tag.
<h2>Table of Contents</h2>
<div id="text-table-of-contents">
<ul>
- <li><a href="#org7a3b67e">1. Why lowbat?</a></li>
- <li><a href="#org3964b8e">2. Links to lowbat</a></li>
+ <li><a href="#orgfe852df">1. Why lowbat?</a></li>
+ <li><a href="#orgf2afc19">2. History of lowbat</a></li>
+ <li><a href="#org89620d6">3. How it works</a>
+ <ul>
+ <li><a href="#org6b0c50b">3.1. libnotify lowbat</a></li>
+ <li><a href="#orgbd041b0">3.2. espeak lowbat</a></li>
+ <li><a href="#org3a44c6a">3.3. unknown lowbat</a></li>
+ </ul>
+ </li>
+ <li><a href="#org4bfb234">4. Links to lowbat</a></li>
</ul>
</div>
</div>
- <div id="outline-container-org7a3b67e" class="outline-2">
- <h2 id="org7a3b67e"><span class="section-number-2">1</span> Why lowbat?</h2>
+ <div id="outline-container-orgfe852df" class="outline-2">
+ <h2 id="orgfe852df"><span class="section-number-2">1</span> Why lowbat?</h2>
<div class="outline-text-2" id="text-1">
<p>
- I've been using minimalist OS installations for work, personnal computing and playing video games for a while now.
- I used <a href="https://www.archlinux.org/">Arch Linux</a>, I still use <a href="https://gentoo.org/">Gentoo Linux</a> - which is by far my favorite Linux distribution - as a desktop OS, and now I am using
- <a href="https://www.freebsd.org/">FreeBSD</a> on my workstation.
+ I've been using minimalist OS installations for work, personnal computing
+ and playing video games for a while now. I used <a href="https://www.archlinux.org/">Arch Linux</a>, I still use
+ <a href="https://gentoo.org/">Gentoo Linux</a> - which is by far my favorite Linux distribution - as a desktop
+ OS, and now I am using <a href="https://www.freebsd.org/">FreeBSD</a> on my workstation.
</p>
<p>
- Those operating systems and distributions basically come with a kernel, coreutils, a shell and that's pretty much it.
- Everything else has to be installed manually. I love this philosophy, the simplicity behind it and the fact that
- you know exactly what's on your system at any moment.
+ Those operating systems and distributions basically come with a kernel,
+ coreutils, a shell and that's pretty much it. Everything else has to be
+ installed manually. I love this philosophy, the simplicity behind it and the
+ fact that you know exactly what's on your system at any moment.
</p>
<p>
- As window managers, I used <a href="http://dwm.suckless.org/">dwm</a> for a while, and I am now using <a href="https://github.com/baskerville/bspwm">bspwm</a>. They are ultra-fast, very lightweight and do not bring
- extra bloatware to my systems. I do not use a status bar as well, I like my applications to use the full screen space available.
+ As window managers, I used <a href="http://dwm.suckless.org/">dwm</a> for a while, and I am now using <a href="https://github.com/baskerville/bspwm">bspwm</a>. They
+ are ultra-fast, very lightweight and do not bring extra bloatware to my systems.
+ I do not use a status bar as well, I like my applications to use the full screen
+ space available.
</p>
<p>
- A big problem for me with this setup for me was that they do not come with some kind of warning or notification system,
- like fancier desktop environments would, when my laptop battery is low. That also was before I started using <b>Emacs</b>, discovering
- the battery level indicator in the modeline. Ultimatly the frustration was too important when the computer kept shutting down in
- the middle of important work too many time. Then I decided to create lowbat to cure this issue.
+ A big problem for me with this setup for me was that they do not come with some
+ kind of warning or notification system, like fancier desktop environments would,
+ when my laptop battery is low. That also was before I started using <b>Emacs</b>,
+ discovering the battery level indicator in the modeline. Ultimatly the
+ frustration was too important when the computer kept shutting down in
+ the middle of important work too many time. Then I decided to create <b>lowbat</b>
+ to cure this issue.
</p>
+ </div>
+ </div>
+ <div id="outline-container-orgf2afc19" class="outline-2">
+ <h2 id="orgf2afc19"><span class="section-number-2">2</span> History of lowbat</h2>
+ <div class="outline-text-2" id="text-2">
<p>
- It started as a very short <code>dash</code> shell (get <a href="https://github.com/tklauser/dash">dash</a> here) script that was working fine but I wanted to experiment a little bit with this.
- It turned into a <code>C++</code> program, which is still the case for the GNU/Linux version. Switching to FreeBSD, I exerimented again by
- turning it into an <code>x64 assembly</code> program, following the <b>Intel</b> syntax. These days, I am rewriting it with the <b>AT&amp;T</b> syntax.
+ It started as a very short <code>dash</code> shell (get <a href="https://github.com/tklauser/dash">dash</a> here) script that was
+ working fine but I wanted to experiment a little bit with this. It turned into
+ a <code>C++</code> program, which is still the case for the GNU/Linux version.
+ Switching to FreeBSD, I exerimented again by turning it into an
+ <code>x64 assembly</code> program, following the <b>Intel</b> syntax. In that way <b>lowbat</b> is
+ even more lightweight and consumes less battery power.
+ These days, I am rewriting it in the <b>AT&amp;T</b> syntax.
</p>
</div>
</div>
- <div id="outline-container-org3964b8e" class="outline-2">
- <h2 id="org3964b8e"><span class="section-number-2">2</span> Links to lowbat</h2>
- <div class="outline-text-2" id="text-2">
+ <div id="outline-container-org89620d6" class="outline-2">
+ <h2 id="org89620d6"><span class="section-number-2">3</span> How it works</h2>
+ <div class="outline-text-2" id="text-3">
+ </div>
+ <div id="outline-container-org6b0c50b" class="outline-3">
+ <h3 id="org6b0c50b"><span class="section-number-3">3.1</span> libnotify lowbat</h3>
+ <div class="outline-text-3" id="text-3-1">
+ <p>
+ The principle of <b>lowbat</b> is rather simple. When it's running in the
+ background, it checks every 4 minutes whether your battery is above 15%.
+ If that is the case, it sleeps for another 4 minutes. When your battery runs
+ bellow 15%, <b>lowbat</b> checks your battery level every 20 seconds as well as
+ sending you a <b>notification</b> using <code>libnotify</code>. You can display live
+ notifications on your desktop using <code>dunst</code> for example, as well as many
+ other I'm sure.
+ </p>
+
+
+ <div id="org89a6eb3" class="figure">
+ <p><img src="../img/lowbat-01.jpg" alt="lowbat-01.jpg" />
+ </p>
+ <p><span class="figure-number">Figure 1: </span>A notification generated by lowbat, displayed by dunst</p>
+ </div>
+ </div>
+ </div>
+
+ <div id="outline-container-orgbd041b0" class="outline-3">
+ <h3 id="orgbd041b0"><span class="section-number-3">3.2</span> espeak lowbat</h3>
+ <div class="outline-text-3" id="text-3-2">
+ <p>
+ <b>lowbat</b> also has an option to send a custom voice message to the use
+ using <code>espeak</code>. Very handy if you are not in front of your computer or
+ if you want to bring joy to this dramatic event.
+ </p>
+ </div>
+ </div>
+
+ <div id="outline-container-org3a44c6a" class="outline-3">
+ <h3 id="org3a44c6a"><span class="section-number-3">3.3</span> unknown lowbat</h3>
+ <div class="outline-text-3" id="text-3-3">
+ <p>
+ Sadly, I wasn't able to test lowbat on machines with more that one
+ battery. My call is that it will only warn you for the <i>first</i> battery,
+ but I can't be sure. Try it and tell me!
+ </p>
+ </div>
+ </div>
+ </div>
+
+ <div id="outline-container-org4bfb234" class="outline-2">
+ <h2 id="org4bfb234"><span class="section-number-2">4</span> Links to lowbat</h2>
+ <div class="outline-text-2" id="text-4">
<ul class="org-ul">
<li>GNU/Linux: <a href="https://github.com/JozanLeClerc/lowbat">lowbat's GitHub GNU/Linux repository</a></li>
<li>BSD: <a href="https://github.com/JozanLeClerc/lowbat-bsd">lowbat's GitHub BSD repository</a></li>
</ul>
</div>
</div>
+<div id="postamble" class="status">
+ <p class="author">Author: Jozan</p>
+ <p class="date">Created: 2020-06-29 Mon 17:27</p>
+ <p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
+</div>
</div>
<?php jo_footer(); ?>