-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathindex.html
115 lines (115 loc) · 4 KB
/
index.html
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
<!doctype html>
<html>
<head>
<title>Battery Info</title>
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]" />
<style>
body {
max-width: 60rem;
}
img {
max-width: 28rem;
}
</style>
</head>
<body>
<header>
<h1>Battery Info</h1>
</header>
<main>
<p>
Battery Info is a desktop application
to display health information about the notebook battery.
</p>
<h2>Screenshots</h2>
<img src="screenshots/toymaker-light.png" />
<img src="screenshots/taran-dark.png" />
<h2>Description</h2>
Application displays current battery health
as well as some general information about the battery.
<ul>
<li>
<strong>Vendor and Model</strong>
Battery vendor and model number.
This information can be used to source the battery replacement.
</li>
<li>
<strong>System</strong>
Computer vendor and model number.
This can be useful when acquiring a replacement battery.
<li>
<strong>Technology</strong>
Battery chemistry.
Lithium ion is the common proven technology.
Lithium polymer allows for thiner batteries.
</li>
<li>
<strong>Nominal capacity</strong>
Energy amount the battery can hold by design.
</li>
<li>
<strong>Actual capacity</strong>
Actual energy amount the battery can hold as measured by the operating system.
To get the most accurate value, fully charge and fully discharge the battery.
</li>
<li>
<strong>Capacity percentage</strong>
The ratio between the actual and nominal capacity.
Typical values are 90-100% for batteries in good shape.
For values below 75% it is recommended to replace the battery.
</li>
</ul>
<h2>Install</h2>
<p>
Please install this <a href="com.her01n.BatteryInfo.flatpakref">application</a> using flatpak.
Refer <a href="https://flatpak.org/setup/">here</a> to setup flatpak if necessary.
</p>
<h2>Issues</h2>
<p>
Use <a href="https://github.com/her01n/battery-info">github</a> for issue tracker.
</p>
<h2>Build</h2>
<p>
First install the requirements.
<ul>
<li><a href="https://www.gnu.org/software/guile/">guile 3.0</a></li>
<li><a href="https://www.nongnu.org/guile-lib/">guile-lib 0.2.5</a></li>
<li><a href="https://www.gnu.org/software/g-golf/">g-golf 0.8.0-rc2</a></li>
<li><a href="https://www.gtk.org/">gtk 4</a></li>
<li><a href="https://gnome.pages.gitlab.gnome.org/libadwaita/">libadwaita 1.3</a></li>
</ul>
</p>
<p>
Checkout the source code from <a href="https://github.com/her01n/battery-info">github</a>.
<pre><code>$ git clone https://github.com/her01n/battery-info
</pre></code>
</p>
<p>
You can now build the application, run it locally or install it.
<pre><code>$ make
$ ./battery-info
$ sudo make install
</code></pre>
</p>
<p>
For unit testing, first install <a href="https://github.com/her01n/hdt">hdt</a> test library.
Then run <code>hdt</code> or alternatively <code>make</code> in the source directory.
</p>
<p>
This is a guile program.
Information is collected using <a href="https://upower.freedesktop.org/docs/Device.html">UPower</a>
DBus interface, with the <em>gdbus</em> client from <em>Glib</em> library.
Native library is accessed using guile's foreign interface.
User interface is displayed using <em>Adwaita</em> and <em>Gtk</em> via <em>g-golf</em> library.
</p>
</main>
<footer>
<p>
Battery Info is made by Albano Battistella, Michal Herko and lemonzest79.
</p>
<p>
<a href="mailto://[email protected]">[email protected]</a>
</p>
</footer>
</body>
</html>