From 2406785626e18c6e001632689076fe7822382625 Mon Sep 17 00:00:00 2001 From: Matthias Kerbl <33470003+MatthiasKerbl@users.noreply.github.com> Date: Thu, 8 Oct 2026 10:23:58 +0200 Subject: [PATCH] Update README.md Update README --- README.md | 82 +++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 55 insertions(+), 27 deletions(-) diff --git a/README.md b/README.md index 2321762..adee691 100644 --- a/README.md +++ b/README.md @@ -3,55 +3,83 @@

AlDente - Battery Care & Monitoring

-_MacOS menu bar tool to limit maximum charging percentage and improve battery lifespan_ +_macOS menu bar app to limit the maximum charging percentage and improve your MacBook's battery lifespan_ #### Don't overcook your battery! Keep it fresh and chewy with AlDente. +## About this repository + +AlDente is no longer open source. The current version of AlDente is proprietary and closed-source. + +We use this repository for: +* **Releases:** Download the latest version of AlDente under [Releases](https://github.com/AppHouseKitchen/AlDente-Battery_Care_and_Monitoring/releases). +* **Bug reports and feature requests:** Please use the [Issues](https://github.com/AppHouseKitchen/AlDente-Battery_Care_and_Monitoring/issues) section. +* **Questions:** Please use the [Discussions](https://github.com/AppHouseKitchen/AlDente-Battery_Care_and_Monitoring/discussions) section. + +The source code in this repository is legacy code from an older, open-source version of AlDente. It is no longer maintained and does not reflect the current version of the app. + ## Why do I need this? -Li-Ion batteries (like the one in your MacBook) last the longest when operating between 20 and 80 percent. Keeping your battery at 100% at all times can shorten the lifespan of your MacBook significantly. -More information can be found at [Battery University](https://batteryuniversity.com/article/bu-415-how-to-charge-and-when-to-charge). -## What’s AlDente Pro? -AlDente Pro is our paid version of AlDente. It has many more features such as Heat Protection, Sailing Mode, Top Up, Calibration Mode,... It offers a better design and has live status icons. If you are interested in getting the most out of your battery, check out our [website](https://apphousekitchen.com/). +Lithium-ion batteries, like the one in your MacBook, last the longest when they are not kept at 100% for long periods of time. Keeping your battery at a lower charge level, for example 80%, while your MacBook is plugged in can significantly extend its lifespan. More information can be found at [Battery University](https://batteryuniversity.com/article/bu-415-how-to-charge-and-when-to-charge). -AlDente Pro is now available on [Setapp](https://apphousekitchen.com/pricing/) too. +## AlDente Free -## Features of AlDente Free -* Charge Limiter allows you to set your maximum charging percentage between 20 and 100 percent. You can either set it by using the slide bar or by typing in the desired percentage in the field above and pressing Enter afterwards. Read more about the Charge Limiter feature in this article ["Feature Explanation: Charge Limiter"](https://apphousekitchen.com/feature-explanation-charge-limiter/). -* Discharge - This feature allows your MacBook to run completely on Battery even if it is plugged in. Therefore, you can actively discharge your MacBook to a healthier percentage. Unfortunately, while Discharge is activated, clamshell mode is not supported due to technical limitations. Read more about the Discharge feature in this article ["Feature Explanation: Discharge"](https://apphousekitchen.com/feature-explanation-discharge/). +* **Charge Limiter:** Set the maximum charging percentage of your MacBook. Read more in ["Feature Explanation: Charge Limiter"](https://apphousekitchen.com/feature-explanation-charge-limiter/). +* **Discharge:** Run your MacBook on battery even while it is plugged in, to actively discharge it to your charge limit. Read more in ["Feature Explanation: Discharge"](https://apphousekitchen.com/feature-explanation-discharge/). -## Supported MacBook Models (macOS 11 Big Sur or later required) +## AlDente Pro -Check out if your MacBook is supported on our [FAQ page](https://apphousekitchen.com/faq/). +AlDente Pro offers many more features, for example: -## Download -You can download the app from GitHub: +* Automatic Discharge and Discharge in Clamshell Mode +* Heat Protection +* Sailing Mode +* Top Up +* Calibration Mode +* Control of the MagSafe LED +* Apple Shortcuts support +* Customizable menu bar icons and pop-up window +* Email support -## Installation Guide -An installation guide can be found on our website:[Installation Guide](https://apphousekitchen.com/installation-guide/) +You can find all features and prices on our [website](https://apphousekitchen.com/pricing/). AlDente Pro is also available on [Setapp](https://apphousekitchen.com/pricing/). + +## Requirements + +* macOS 12 Monterey or later (up to macOS 27 Golden Gate) +* A supported Apple silicon or Intel MacBook. You can check if your MacBook is supported on our [website](https://apphousekitchen.com/pricing/). + +## Download & Installation + +* Download the latest version under [Releases](https://github.com/AppHouseKitchen/AlDente-Battery_Care_and_Monitoring/releases) or on our [website](https://apphousekitchen.com/). +* Or install it with [Homebrew](https://brew.sh/): `brew install --cask aldente` + +You can find a step-by-step guide in our [Installation Guide](https://apphousekitchen.com/installation-guide/). ## How to use -When the installation is finished, enter your desired max. charging percentage by clicking on the AlDente icon on your menu bar. Usually, the operating system will take a minute or two to register the changes, so be patient. You can check if it's working by setting the max. percentage to e.g., 80%. After a while, clicking on your battery icon will report "Battery is not charging" if you have more than ≈73% left, even though your charger is connected. Notice that in this state, your MacBook is still powered by the charger, but the battery is bypassed and not charging anymore. -IMPORTANT: Keeping your battery at a lower percentage, such as under 80%, for weeks without doing full cycles (100%-0%) can result in a disturbed battery calibration. When this happens, your MacBook might turn off with 40-50% left, or your battery capacity will drop significantly. However, this is only due to a disturbed battery calibration and not because of a faulty or degraded battery. To avoid this issue, we recommend doing at least one full cycle (0%-100%) every two weeks. Even if your battery calibration gets disturbed, doing 4+ full cycles will recalibrate your battery, and the capacity will go up again. +After the installation, click on the AlDente icon in your menu bar and set your desired charge limit, for example 80%. Once your battery reaches the charge limit, your MacBook is powered by the power adapter, and the battery is no longer charging. + +On Apple silicon MacBooks, charge limits below 80% can be enabled in the Charge Settings of AlDente. + +**Battery calibration:** Keeping your battery at a low charge level for a long time can disturb the battery calibration. Your MacBook might then show a lower capacity or turn off earlier than expected, even though the battery itself is fine. To prevent this, we recommend a full charge cycle (0% to 100%) from time to time, or using the Calibration Mode of AlDente Pro. Newer macOS versions also run an automatic battery calibration, during which macOS temporarily charges the battery to 100%. You can read more about it in [#1846](https://github.com/AppHouseKitchen/AlDente-Battery_Care_and_Monitoring/issues/1846). ## Support -* Most questions are already answered on our [FAQ page](https://apphousekitchen.com/faq/) or on our [blog](https://apphousekitchen.com/blog/). Check them out! -* E-mail support is only available for AlDente Pro customers. Check out our [support page](https://apphousekitchen.com/support/) if you want to contact us. -* Due to limited resources, we are not able to provide support to AlDente Free users or here on GitHub. -## Other tools used in this project: +* Most questions are already answered in our [FAQ](https://apphousekitchen.com/faq/) and on our [blog](https://apphousekitchen.com/blog/). +* **Bug reports:** Please open an [issue](https://github.com/AppHouseKitchen/AlDente-Battery_Care_and_Monitoring/issues) and include a debug file. You can find a guide on [How to generate and share a debug file](https://apphousekitchen.com/how-to-generate-and-share-a-debug-file/) on our blog. +* **Email support** is available for AlDente Pro customers through the Help & Support page within AlDente or our [support page](https://apphousekitchen.com/support/). + +## Legacy code + +The legacy code in this repository uses the following open-source projects: * * * -## Closed‑Source Notice +## Disclaimer -This project is no longer open source. Although the GitHub repository contains legacy code and archived releases, the current version of the software is proprietary and closed‑source. +AlDente taps into low-level system functions to control charging. Although it is used by many people without any issues, we do not take any responsibility for any damage resulting from the use of AlDente. Use it at your own risk. Please see the [LICENSE](LICENSE) for details. -## Disclaimer: -I do not take any responsibility for any sort of damage as a result of using this tool! Although this had no negative side effects for me and thousands of others, AlDente still taps into some very low-level system functions that are not meant to be tampered with. Use it at your own risk! - -Copyright(c) 2021 AppHouseKitchen +Copyright ¬© 2020‚Äì2026 AppHouseKitchen GmbH THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.