Compare commits

..

23 Commits
v2.1 ... 1.04

Author SHA1 Message Date
Matthias Kerbl
d9949ce318 Update README.md 2021-06-14 11:01:48 +02:00
Matthias Kerbl
b81c72120c Update README.md 2021-05-03 18:56:55 +02:00
davidwernhart
b8b6481b8a Update README.md 2021-04-24 00:29:47 +02:00
Matthias Kerbl
211a5951b1 Update README.md 2021-04-23 22:46:02 +02:00
Matthias Kerbl
e248449a46 Update README.md 2021-04-13 22:36:56 +02:00
Matthias Kerbl
655b839078 Update README.md 2021-04-13 02:58:48 +02:00
Matthias Kerbl
c4762793ff Update README.md 2021-04-08 15:20:12 +02:00
davidwernhart
1c4cff3139 Update README.md 2021-03-30 20:34:41 +02:00
Matthias Kerbl
f1cf61141d Update README.md 2021-03-22 19:03:40 +01:00
Matthias Kerbl
de076514de Update README.md 2021-03-19 16:04:24 +01:00
Matthias Kerbl
61f9c4b60b Merge pull request #200 from Filnor/patch-1
Add 2018 MacBook Pro Model to supported devices
2021-03-15 12:11:09 +01:00
Philipp
e8c6eb9339 Update README.md
Add MBP 2018 (/w Touchbar), not sure if there are ones without it.
2021-03-15 11:11:14 +01:00
Matthias Kerbl
c66bc6278c Update README.md 2021-03-14 15:58:50 +01:00
Matthias Kerbl
e089c3d8d1 Merge pull request #191 from mog3n/patch-1
Tested on MBP 15" from 2017, and fixed typo
2021-03-12 22:31:43 +01:00
Mogen Cheng
c525f96255 Update README.md
Tested on MBP 15" from 2017, and fixed typo
2021-03-12 10:52:26 -05:00
Matthias Kerbl
2d6e02307f Update README.md 2021-03-12 12:25:18 +01:00
Matthias Kerbl
49b9c338b5 Update README.md 2021-03-12 12:15:44 +01:00
Matthias Kerbl
a00389695f Update README.md 2021-03-10 20:44:11 +01:00
Matthias Kerbl
784b97900f Update README.md 2021-03-10 20:43:30 +01:00
Matthias Kerbl
d9598bca61 Update README.md 2021-03-01 19:01:58 +01:00
Matthias Kerbl
f226c5cc0c Merge pull request #154 from tomschlenkhoff/patch-1
Update README.md
2021-03-01 18:06:01 +01:00
Tom Schlenkhoff
b44027c675 Update README.md
Fix typo
2021-03-01 17:55:22 +01:00
Matthias Kerbl
6981e3bfad Update README.md 2021-03-01 17:18:38 +01:00

View File

@@ -3,8 +3,18 @@ _MacOS menu bar tool to limit maximum charging percentage_
#### Don't overcook your battery! Keep it fresh and chewy with AlDente.
## AlDente for Apple Silicon (M1 MacBooks) is out now!
The time has come: AlDente for Apple Silicon (M1 MacBooks) is out now. We thank everyone who has helped us here in the forum and hope you like it. Thats not all, we have also started working on a pro version of AlDente with advanced features several weeks ago. Since we have put a lot of hours into developing the app, it will cost a little. However, there will always be this free and open source version of AlDente updated with the new M1 SMC keys. If you have any feature requests or ideas for AlDente Pro, let us know. If you want to get notified, when AlDente Pro comes out, just enter your email at https://apphousekitchen.com/aldente/ In the meantime, stay safe and keep your battery fresh. David & Matthias
## AlDente Pro 1.0 Launch!
After months of hard work, sweat and countless plates of pasta, we are proud to release the first public version of AlDente Pro.
Thanks to the incredible support of our beta testers, we can now bring AlDente Pro to everyone. You can get it at our new website: https://apphousekitchen.com
The pro version includes many convenient features like Sailing Mode, Heat Protection, Calibration Mode, Shortcuts and many more. On top of all that, it has a beautiful new design that gives you access to all important information at a glance.
If you would like to purchase our app and support further development of both the pro and the free version, head over to [AppHouseKitchen](https://apphousekitchen.com)!
Yours truly,
David & Matthias
## Why do I need this?
Li-ion and polymer batteries (like the one in your MacBook) last the longest when operating between 20 and 60 percent. Keeping your battery at 100% at all times can shorten the lifespan of your MacBook significantly.
@@ -14,7 +24,7 @@ More information can be found here:
## Features
* Max. Battery Charge 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.
* Launch at Login does exatly what it says, it will automatically launch AlDente when you start your MacBook. Make sure you safe the AlDente program file in the Applications folder for this feature to work.
* Allow Discharge - When this feature is activated, your MacBook will run on battery until it reaches the desired percentage. Afterwards, it will stay at the desired battery percentage and use the power adapter again.
* Allow Discharge (Beta) - When this feature is activated, your MacBook will run on battery until it has reached the desired percentage. Afterwards, it will stay at the desired battery percentage and use the power adapter again. Unfortunately, while "Allow Discharge" is activated, clamshell mode is not supported due to technical limitations.
* Use Classic SMC Key (Intel) - When activated, AlDente will use a different pathway to inhibit charging with the benefit of inhibiting charging even if your MacBook is turned off. However, it comes with a tradeoff: The feature "Allow Discharge" is not available when its activated. Furthermore, as the name suggests, this feature is only available on Intel MacBooks.
## Feature Review and Installation Process
@@ -26,34 +36,37 @@ Thanks to Haroon21 for making this awesome video tutorial.
## How does it work?
The tool writes the desired value to your MacBooks SMC (System Management Controller), which handles the rest.
## AlDente is tested and working on pretty much every MacBook from 2010-2020, including:
## AlDente is tested and working with full functionality on the following MacBooks:
* 2020 MacBook Air 13" M1 Apple Silicon
* 2020 MacBook Pro 13" M1 Apple Silicon
* 2020 MacBook Pro 13" with 4 TB3 ports
* 2020 Macbook Air 13" (Intel)
* 2019 MacBook Pro 16"
* 2019 MacBook Pro 13"
* 2018 MacBook Pro 15" with TouchBar
* 2017 MacBook Pro 15"
* 2017 Macbook Pro 13" without TouchBar
* 2017 MacBook Air 13"
* 2017 MacBook 12"
* 2016 MacBook Pro 15"
* 2016 MacBook 12"
* 2015 MacBook 12"
## Limited functionality on MacBooks from 2015 and older:
For AlDente to work on older MacBooks you have to activate the feature "USE OLD SMC KEY (INTEL)". Allow Discharge is not available on older devices.
* 2015 MacBook Pro 15"
* 2015 MacBook Pro 13"
* 2014 MacBook Air 13"
* 2014 MacBook Pro 15"
* 2014 MacBook Pro 13"
* 2013 MacBook Pro 13"
* 2013 MacBook Pro 15"
* 2013 MacBook Air 13"
* 2010 MacBook
## Download:
You can download the app from GitHub: <https://github.com/davidwernhart/AlDente/releases>
Alternatively, AlDente is available as a homebrew cask. Install via
```
brew install aldente
```
## How to use:
Simply extract the latest .zip release and drag the App to your Applications Folder.
@@ -64,7 +77,7 @@ Once finished, enter your desired max. charging percentage by clicking on the
For some reason, macOS will always try to squeeze in a few more percent than specified by the SMC. For example, if you set yours to 80% it will stop charging at around 83%, so be patient. Strangely, this is not the case using Windows with bootcamp, therefore I have chosen not to correct this inaccuracy in code for now.
Usually, the operating system will take a minute or two registering the changes, so be patient. You can check if it's working by setting the max. percentage to e.g.: 70%. After a while, clicking on your battery icon will report "Battery is not charging" if you have more than ≈73% left, even tough your charger is connected. Notice that in this state, your MacBook is still powered by the charger, but the battery is not charging anymore.
Usually, the operating system will take a minute or two registering the changes, so be patient. You can check if it's working by setting the max. percentage to e.g.: 70%. 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 not charging anymore.
IMPORTANT: Keeping your battery at a lower percentage, such as 20-70%, 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 month. Even if your battery calibration gets disturbed, doing 4-5 full cycles will recalibrate your battery and the capacity will go up again.
@@ -84,6 +97,12 @@ Yes! Leaving it on results in slow charging, even when AlDente is trying to inhi
* WHAT DOES THE FEATURE "USE OLD SMC KEY (INTEL)" DO?
When activated, AlDente will use a different pathway to inhibit charging with the benefit of inhibiting charging even if your MacBook is turned off. However, it comes with a tradeoff: The feature "Allow Discharge" is not available when its activated. Furthermore, as the name suggests, this feature is only available on Intel MacBooks.
* WHY DOES ALLOW DISCHARGE NOT WORK IN CLAMSHELL MODE?
Unfortunately, while "Allow 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
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.
## Other tools I used in this project:
* <https://github.com/beltex/SMCKit>