mirror of
https://github.com/AppHouseKitchen/AlDente-Battery_Care_and_Monitoring.git
synced 2026-01-19 15:37:12 +01:00
Compare commits
18 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
7d1c0d54a8 | ||
|
|
67b8e22224 | ||
|
|
be1c6ff69a | ||
|
|
f3b01d194c | ||
|
|
0abfeafbd2 | ||
|
|
ea81111e77 | ||
|
|
357a84ba31 | ||
|
|
276b8db95a | ||
|
|
465867dc1a | ||
|
|
68160e4b63 | ||
|
|
263cf1e5f2 | ||
|
|
7aaa55f3da | ||
|
|
34e6ce8987 | ||
|
|
f4a12b3cdb | ||
|
|
b7f526ae51 | ||
|
|
80a10a5380 | ||
|
|
ef3309eb2e | ||
|
|
9ff04f31e3 |
34
.github/ISSUE_TEMPLATE/bug_report.md
vendored
Normal file
34
.github/ISSUE_TEMPLATE/bug_report.md
vendored
Normal file
@@ -0,0 +1,34 @@
|
||||
---
|
||||
name: Bug report
|
||||
about: Create a report to help us improve
|
||||
title: ''
|
||||
labels: ''
|
||||
assignees: ''
|
||||
|
||||
---
|
||||
|
||||
**Describe the bug**
|
||||
A clear and concise description of what the bug is.
|
||||
|
||||
**To Reproduce**
|
||||
Steps to reproduce the behavior:
|
||||
1. Go to '...'
|
||||
2. Click on '....'
|
||||
3. Scroll down to '....'
|
||||
4. See error
|
||||
|
||||
**Expected behavior**
|
||||
A clear and concise description of what you expected to happen.
|
||||
|
||||
**Screenshots**
|
||||
If applicable, add screenshots or screen recordings to help explain your problem.
|
||||
|
||||
**MacBook (please complete the following information):**
|
||||
- MacBook model (https://support.apple.com/en-us/HT201608)
|
||||
- macOS version (https://support.apple.com/en-us/HT201260)
|
||||
- AlDente Pro or AlDente Free?
|
||||
- AlDente Version?
|
||||
- List of all enabled/disabled settings in AlDente:
|
||||
|
||||
**Additional context**
|
||||
Add any other context about the problem here.
|
||||
20
.github/ISSUE_TEMPLATE/feature_request.md
vendored
Normal file
20
.github/ISSUE_TEMPLATE/feature_request.md
vendored
Normal file
@@ -0,0 +1,20 @@
|
||||
---
|
||||
name: Feature request
|
||||
about: Suggest an idea for this project
|
||||
title: ''
|
||||
labels: ''
|
||||
assignees: ''
|
||||
|
||||
---
|
||||
|
||||
**Is your feature request related to a problem? Please describe.**
|
||||
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
|
||||
|
||||
**Describe the solution you'd like**
|
||||
A clear and concise description of what you want to happen.
|
||||
|
||||
**Describe alternatives you've considered**
|
||||
A clear and concise description of any alternative solutions or features you've considered.
|
||||
|
||||
**Additional context**
|
||||
Add any other context or screenshots about the feature request here.
|
||||
94
README.md
94
README.md
@@ -15,10 +15,12 @@ AlDente Pro is our paid version of AlDente. It has many more features such as He
|
||||
* 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 here: 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 more healthy percentage. Unfortunately, while Discharge is activated, clamshell mode is not supported due to technical limitations. Read more about the Discharge feature here: https://apphousekitchen.com/feature-explanation-discharge/
|
||||
|
||||
## Supported Devices (macOS 11 Big Sur required)
|
||||
## Supported Devices (macOS 11 Big Sur or higher required)
|
||||
|
||||
#### MacBook Pro
|
||||
Full Support
|
||||
* MacBook Pro (16-inch, M1 Pro/Max, 2021)
|
||||
* MacBook Pro (14-inch, M1 Pro/Max, 2021)
|
||||
* MacBook Pro (13-inch, M1, 2020)
|
||||
* MacBook Pro (13-inch, 2020, Two Thunderbolt 3 ports)
|
||||
* MacBook Pro (13-inch, 2020, Four Thunderbolt 3 ports)
|
||||
@@ -35,7 +37,7 @@ Full Support
|
||||
* MacBook Pro (13-inch, 2016, Four Thunderbolt 3 ports)
|
||||
* MacBook Pro (13-inch, 2016, Two Thunderbolt 3 ports)
|
||||
|
||||
Limited Support(Only Charge Limiter)
|
||||
Limited Support(Only Charge Limiter through Intel Mode)
|
||||
* MacBook Pro (Retina, 15-inch, Mid 2015)
|
||||
* MacBook Pro (Retina, 13-inch, Early 2015)
|
||||
* MacBook Pro (Retina, 15-inch, Mid 2014)
|
||||
@@ -50,7 +52,7 @@ Full Support
|
||||
* MacBook Air (Retina, 13-inch, 2019)
|
||||
* MacBook Air (Retina, 13-inch, 2018)
|
||||
|
||||
Limited Support(Only Charge Limiter)
|
||||
Limited Support(Only Charge Limiter through Intel Mode)
|
||||
* MacBook Air (13-inch, 2017)
|
||||
* MacBook Air (13-inch, Early 2015)
|
||||
* MacBook Air (11-inch, Early 2015)
|
||||
@@ -60,7 +62,7 @@ Limited Support(Only Charge Limiter)
|
||||
* MacBook Air (11-inch, Mid 2013)
|
||||
|
||||
#### MacBook 12"
|
||||
Limited Support(Only Charge Limiter)
|
||||
Limited Support(Only Charge Limiter through Intel Mode)
|
||||
* MacBook (Retina, 12-inch, 2017)
|
||||
* MacBook (Retina, 12-inch, Early 2016)
|
||||
* MacBook (Retina, 12-inch, Early 2015)
|
||||
@@ -79,38 +81,82 @@ For some reason, macOS will always try to squeeze in a few more percent than spe
|
||||
IMPORTANT: Keeping your battery at a lower percentage, such as 20-80%, over 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.
|
||||
|
||||
## FAQ
|
||||
* IT DOES NOT WORK???
|
||||
|
||||
AlDente does only prevent your Mac from charging more than you specify, it does NOT automatically drain your battery to the specified percentage.
|
||||
* STILL NOT WORKING :(
|
||||
<details>
|
||||
<summary>IT DOES NOT WORK???</summary>
|
||||
Firstly, AlDente does only prevent your Mac from charging more than you specify, it does NOT automatically drain your battery to the specified percentage. Secondly, make sure you have Apple's "Optimized battery charging" disabled, keeping it on will result in slow charging beyond the charge limit. Lastly, check the next questing regarding the behavior of AlDente while your MacBook is in sleep or powered off.
|
||||
</details>
|
||||
|
||||
Simply reboot your MacBook! This seems to do the trick for most people.
|
||||
* HOW TO UNINSTALL?
|
||||
<details>
|
||||
<summary>CHARGE LIMITER DOES NOT WORK! :(</summary>
|
||||
AlDente Free can not control the charging behavior of your MacBook while it is in sleep, or shut down. Therefore, it will continue to charge to 100% when you close the lid or shut it down. AlDente Pro has features called "Stop charging when sleeping" and "Stop charging when powered off" to counteract this behavior. You can read more about these features in our blog:
|
||||
https://apphousekitchen.com/feature-explanation-stop-charging-when-sleeping/
|
||||
https://apphousekitchen.com/feature-explanation-stop-charging-when-powered-off-app-closed/
|
||||
</details>
|
||||
|
||||
Take a look at our blog post here: https://apphousekitchen.com/how-to-uninstall-aldente-pro/
|
||||
* DO I HAVE TO UNCHECK THE BUILT IN BATTERY HEALTH CHECKBOX?
|
||||
<details>
|
||||
<summary>WHY DOES MY MACBOOK KEEP CHARGING WHEN IT IS POWERED OFF?</summary>
|
||||
AlDente Free can not control the charging behavior of your MacBook while it is in sleep, or shut down. Therefore, it will continue to charge to 100% when you close the lid or shut it down. AlDente Pro has features called "Stop charging when sleeping" and "Stop charging when powered off" to counteract this behavior. You can read more about these features in our blog:
|
||||
https://apphousekitchen.com/feature-explanation-stop-charging-when-sleeping/
|
||||
https://apphousekitchen.com/feature-explanation-stop-charging-when-powered-off-app-closed/
|
||||
</details>
|
||||
|
||||
Yes! Leaving it on results in slow charging, even when AlDente is trying to inhibit it.
|
||||
* WHY DOES DISCHARGE NOT WORK IN CLAMSHELL MODE?
|
||||
<details>
|
||||
<summary>WHY DOES MY MACBOOK KEEP CHARGING WHEN IT IS IN SLEEP?</summary>
|
||||
AlDente Free can not control the charging behavior of your MacBook while it is in sleep, or shut down. Therefore, it will continue to charge to 100% when you close the lid or shut it down. AlDente Pro has features called "Stop charging when sleeping" and "Stop charging when powered off" to counteract this behavior. You can read more about these features in our blog:
|
||||
* https://apphousekitchen.com/feature-explanation-stop-charging-when-sleeping/
|
||||
* https://apphousekitchen.com/feature-explanation-stop-charging-when-powered-off-app-closed/
|
||||
</details>
|
||||
|
||||
Unfortunately, while "Discharge" is activated, clamshell mode is not supported due to technical limitations.
|
||||
* HELP MY BATTERY CAPACITY DROPPED AND MY MACBOOK TURNS OFF WITH 50% LEFT
|
||||
<details>
|
||||
<summary>HOW TO UNINSTALL?</summary>
|
||||
Take a look at our blog post here: https://apphousekitchen.com/how-to-uninstall-aldente-pro/
|
||||
</details>
|
||||
|
||||
Keeping your battery at a lower percentage, such as 20-70%, over weeks without doing full cycles (0%-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 month. Even if your battery calibration gets disturbed, doing 4-5 full cycles will recalibrate your battery and the capacity will go up again.
|
||||
* WHAT IS ALDENTE CLASSIC?
|
||||
<details>
|
||||
<summary>DO I HAVE TO DISABLE APPLE'S "OPTIMIZED BATTERY CHARGING"?</summary>
|
||||
Yes! Leaving it on results in slow charging, even when AlDente is trying to inhibit it.
|
||||
</details>
|
||||
|
||||
AlDente Classic is our original version of AlDente. First introduced in 2020 and further developed until March 2021. With a complete rewrite of the code of AlDente and the introduction of AlDente Pro, we decided to rename the original AlDente in AlDente Classic and use the name AlDente (Free) or AlDente Pro with synchronous versioning between these two from now on.
|
||||
* WHY IS ALDENTE NOT SUPPORTED BY OLDER VERSIONS OF MACOS AND ARE YOU PLANNING TO SUPPORT OLDER MACOS VERSIONS IN THE FUTURE?
|
||||
<details>
|
||||
<summary>WHY DOES DISCHARGE NOT WORK IN CLAMSHELL MODE?</summary>
|
||||
Discharge in Clamshell mode is only supported in AlDente Pro.
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>HELP, SAILING MODE DOES NOT WORK!?</summary>
|
||||
The Sailing Mode is not intended to actively discharge your battery. Therefore, your MacBook will barely lose any energy even in Sailing Mode, since the power brick is the main source of energy. So do not worry when the battery percentage does not change even if the Sailing Mode is activated. Sailing Mode is still doing its thing.
|
||||
</details>
|
||||
|
||||
Due to SwiftUI not being compatible with older versions of macOS, AlDente is only compatible with macOS 11 Big Sur. Even though it might be possible to get AlDente to work on older MacBooks and macOS versions too, we are currently not working on it.
|
||||
<details>
|
||||
<summary>WHY DOES THE SAILING MODE NOT CHARGE AND DISCHARGE THE MACBOOK BETWEEN A CERTAIN RANGE?</summary>
|
||||
Unlike the common belief, it is actually way more unhealthy for a battery to always get cycled between a reasonable range (for example between 30% and 70%) than to just stay at a healthy percentage (for example 80%). This is due to even reasonable charge cycling adding a lot of charge cycles which results in more and faster battery degradation over time than just using the MacBook plugged in at a healthy percentage. However, this does not mean that you should not use your MacBook remotely. MacBooks are portable devices but if you use your MacBook in your office pugged in, it is better to just limit charging to a healthy percentage than to cycle between a certain range.
|
||||
</details>
|
||||
|
||||
<details>
|
||||
<summary>HELP MY BATTERY CAPACITY DROPPED AND MY MACBOOK TURNS OFF WITH 50% LEFT</summary>
|
||||
Keeping your battery at a lower percentage, such as 20-70%, over weeks without doing full cycles (100%-0%-100%) 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-5 full cycles will recalibrate your battery and the capacity will go up again. AlDente Pro has a feature called Calibration Mode(https://apphousekitchen.com/feature-explanation-calibration-mode-2/), which will automatically do a full cycle when startet. You can read more about the calibration of "smart" batteries here: https://batteryuniversity.com/article/bu-603-how-to-calibrate-a-smart-battery
|
||||
</details>
|
||||
|
||||
* IS ALDENTE OPEN SOURCE?
|
||||
<details>
|
||||
<summary>WHAT IS ALDENTE CLASSIC?</summary>
|
||||
AlDente Classic is our original version of AlDente. First introduced in 2020 and further developed until March 2021. With a complete rewrite of the code of AlDente and the introduction of AlDente Pro, we decided to rename the original AlDente in AlDente Classic and use the name AlDente (Free) or AlDente Pro with synchronous versioning between these two from now on.
|
||||
</details>
|
||||
|
||||
The first couple of versions of AlDente Classic until AlDente Classic 2.0 are open source. Later versions of AlDente Classic or AlDente Free/Pro are not open source anymore.
|
||||
<details>
|
||||
<summary>WHY IS ALDENTE NOT SUPPORTED BY OLDER VERSIONS OF MACOS AND ARE YOU PLANNING TO SUPPORT OLDER MACOS VERSIONS IN THE FUTURE?</summary>
|
||||
Due to SwiftUI not being compatible with older versions of macOS, AlDente is only compatible with macOS 11 Big Sur on newer. Even though it might be possible to get AlDente to work on older MacBooks and macOS versions too, we are currently not working on it.
|
||||
</details>
|
||||
|
||||
* UPDATED TO MACOS 12 MONTEREY AND ALDENTE DOES NOT WORK ANYMORE!
|
||||
<details>
|
||||
<summary>IS ALDENTE OPEN SOURCE?</summary>
|
||||
The first couple of versions of AlDente Classic until AlDente Classic 2.0 are open source. Later versions of AlDente Classic or AlDente Free/Pro are not open source anymore.
|
||||
</details>
|
||||
|
||||
No worries, big macOS updates might require a reinstall for AlDente. Just reinstall AlDente and everything should work as expected again.
|
||||
<details>
|
||||
<summary>UPDATED TO MACOS 12 MONTEREY AND ALDENTE DOES NOT WORK ANYMORE!</summary>
|
||||
No worries, big macOS updates might require a reinstall for AlDente. Just reinstall AlDente and everything should work as expected again.
|
||||
</details>
|
||||
|
||||
## Other tools used in this project:
|
||||
* <https://github.com/beltex/SMCKit>
|
||||
|
||||
Reference in New Issue
Block a user