Skip to content

eo is a simple yet effective shell script designed to help you maintain optimal battery health πŸ”‹ on your Linux system. It periodically checks the battery status and sends notifications when the battery level exceeds a specified threshold while charging, prompting you to unplug the charger to preserve battery longevity. πŸ”Œ

Notifications You must be signed in to change notification settings

MushroomWasp/eo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 

Repository files navigation

eo - EightyOne - 81% ⚑️

eo is a simple yet effective shell script designed to help you maintain optimal battery health πŸ”‹ on your Linux system. It periodically checks the battery status and sends notifications when the battery level exceeds a specified threshold while charging, prompting you to unplug the charger to preserve battery longevity. πŸ”Œ

Features ✨

  • Battery Monitoring: Checks the battery status and percentage every 10 minutes. ⏱️
  • Notification System: Sends a desktop notification when the battery level exceeds 80% while charging, reminding you to unplug for optimal battery health. πŸ””
  • Easy Installation: Can be installed system-wide for convenient access. πŸ“₯
  • Automatic Setup: Configures the script to run automatically on system startup. πŸš€

Prerequisites πŸ“‹

Before using eo, ensure that you have the following dependencies installed on your system:

  • acpi: A command-line utility for displaying battery status and information. πŸ’»
  • libnotify: A library for sending desktop notifications. πŸ’¬

You can install these dependencies using your system's package manager.

Installation πŸ—οΈ

  1. Clone the repository or download the script file. πŸ“₯
  2. Open a terminal and navigate to the directory containing the script. πŸ–₯️
  3. Run the following command to install the script system-wide:
./eo.sh install

This will copy the script to /usr/bin/eo and make it accessible from anywhere on your system. 🌍

Usage πŸš€

After installation, you can use the following commands:

  • eo start: Start the script to monitor battery health. πŸ”‹
  • eo install: Install the script to /usr/bin. πŸ“₯
  • eo auto: Configure automatic setup to run the script on system startup. βš™οΈ
  • eo help: Display the help information. ❓

Automatic Setup ⏰

To configure eo to run automatically on system startup, use the auto command:

eo auto

This command will install the script (if not already installed) and add a line to your ~/.profile file to start the script on login. πŸ”‘

Contributing 🀝

Contributions are welcome! If you encounter any issues or have suggestions for improvements, please open an issue or submit a pull request. πŸ“£

About

eo is a simple yet effective shell script designed to help you maintain optimal battery health πŸ”‹ on your Linux system. It periodically checks the battery status and sends notifications when the battery level exceeds a specified threshold while charging, prompting you to unplug the charger to preserve battery longevity. πŸ”Œ

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages