Powir

Windows 10 based tool to monitor and analyze your system's power and battery usage

---

Table of Contents

• About the Project
  • What is it?
  • Installation
• Features
  • What it does?
  • Why build it?
  • Actions?
• Gallery
  • Battery Information
  • System Information
  • Power And Battery Usage
• Installation Methods
  • Desktop App (Main Mode)
    • Browser And Windows Defender Warnings
    • Solution
  • Browser Window (Lite Mode)
• FAQs
• Developer
  • Prerequisites
  • Setup
  • Build
  • Usage
• Contributing
• License
• Contact
• Acknowledgement

---

About The Project

What is it?

Powir is a Windows 10 based tool to monitor and analyze your system's power and battery usage.

It provides you with various information and statistics about the current and overall history of the power and battery usage of your system.

Installation

There are two ways to install powir:

• Desktop App (Main Mode): Installation is as quick as simply downloading the executable and running it. The App is completely portable meaning you don't have to go through an installation wizard, and it can be copied from system to system seamlessly without any dependencies or extra files needed. Recommended

  • Terminal: Simply download the binary and run it:

  curl -L https://github.com/tyme-dev/powir/releases/download/v2.0.0/powir.2.0.0.exe --output powir.exe
  ./powir

  • Double Click: Again download the binary and run it but please read this note

• Browser Window (Lite Mode): Installation requires few pre-requisites (node & npm) and firing a command from the command prompt which opens up a tab in your default browser serving file via a local server. Actions (Export PDF, JSON) are missing in the lite mode.

Features

What it does?

• Provides you with a simple and clean UI to list your battery and system information.
• Shows you the change in battery capacity since the OS was installed.
• Analyzes the current and overall estimated battery life of your system.
• Computes various statistics to give a better understanding of your power usage.
• Ability to export all the data via various formats: PDF (app), JSON (processed), HTML (original report).
• 100% free and completely open-source for an absolute transparency.
• Completely portable app with no installation required, ready to use out of the box.

Why build it?

• Complete lack of any such power/battery monitoring analyzing tool available in the market.
• Obscure documentation over how to find battery statuses on the Internet.
• Required to use terminal in order to run a command showing information about the system.
• Devoid of any simple and understandable metrics from the underlying API or report.

Actions

• Export the current report of your system from Powir in PDF format
• Export the parsed and processed data of your system from Powir in JSON format
• Shows original report generated by Windows using the command: powercfg /batteryreport in the terminal

Gallery

Battery Information

System Information

Power And Battery Usage

Only one time setup

Commands (copy-paste):

git clone https://github.com/tyme-dev/powir.git
cd powir
npm install --production

Explanation:

• Ensure you have git, node and npm installed using commands: git --version, node -v and npm -v respectively, else install it from here: Git and NodeJS (installer contains both node and npm)
• Clone the repository using: git clone https://github.com/tyme-dev/powir.git and cd into the folder: cd powir
• Run npm install --production to install dependencies

Anytime

Command (copy-paste)

npm run lite-mode

Explanation:

• Now simply run npm run lite-mode whenever you want from the directory, and it will open up the dashboard allowing you to monitor and analyze power states.

FAQs

Is it completely free?

Yes, Powir is 100% free to download and use.

Are the numbers displayed 100% correct?

Depends, Powir parses the raw reports generated from Windows and does the computations of the various statistics and render the charts.

What tooling is used to build the app?

Powir runs as an electron app (chromium web engine embedded) while using React to facilitate the UI and data workflow.

Does it share my data anywhere?

No, Powir will never share your data anywhere outside your local system, the entire source code of the app is online for anyone to check. In fact, it never makes any request to a server since there is none. Its simply a client sided app.

---

Developer

If you're looking to build it from the source or inspect the app, its extremely simply and you only have to follow few instructions as listed below:

Prerequisites

• Git
• Node
• NPM

Setup

• Clone the repository: git clone https://github.com/tyme-dev/powir.git
• Cd into the directory: cd powir and run: npm install

Build

• Run npm run build which will package the app at dist/ folder.

Usage

Electron App

• Run npm run dev:
• All the server code is located at: public/server directory.
• Entrypoint of the electron app is at electron/main.js.
• Everything related to rendering is done at: src directory.
• Any of the changes you make at src directory will reflect instantly in the app.

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the GPU General Public License. See LICENSE for more information.

Acknowledgement

Many thanks to these amazing frameworks/libraries/tools/arts without which none of this had been possible! <3

Major Libraries

• ElectronJS
• NodeJS
• ReactJS
• Tailwind
• PaperCSS
• ChartJS

Icons

• Icons8