Compare commits

...

13 Commits

Author SHA1 Message Date
Matthias Kerbl
9136e85d11 Update README.md 2025-07-15 14:59:09 +02:00
Matthias Kerbl
024fe005cd Update README.md 2025-07-02 13:37:30 +02:00
Matthias Kerbl
a2f0e88f83 Update README.md 2024-09-20 14:21:54 +02:00
Matthias Kerbl
e2c0b1a0ac Add files via upload 2024-09-20 14:20:46 +02:00
Matthias Kerbl
73b76a5f62 Update SECURITY.md 2024-09-20 13:57:17 +02:00
Matthias Kerbl
ff48b9cc2f Merge pull request #1311 from SmolekVT/patch-1
Create SECURITY.md
2024-09-12 09:56:12 +02:00
Smolek
fa707ee7e1 Create SECURITY.md 2024-09-05 10:38:11 +02:00
Matthias Kerbl
921ec64e46 Merge pull request #1173 from AppHouseKitchen/MatthiasKerbl-patch-3
Update bug_report.md
2024-02-20 12:40:44 +01:00
Matthias Kerbl
1559f0c95e Update bug_report.md 2024-02-20 12:40:33 +01:00
Matthias Kerbl
90ef62e1c9 Merge pull request #1172 from AppHouseKitchen/MatthiasKerbl-patch-2
Update bug_report.md
2024-02-20 11:54:37 +01:00
Matthias Kerbl
2d3089399e Update bug_report.md 2024-02-20 11:54:26 +01:00
Matthias Kerbl
da53f8ba65 Merge pull request #1171 from AppHouseKitchen/MatthiasKerbl-patch-1
Update bug_report.md
2024-02-20 11:52:56 +01:00
Matthias Kerbl
6c9cc14725 Update bug_report.md 2024-02-20 11:52:37 +01:00
4 changed files with 61 additions and 20 deletions

View File

@@ -1,11 +1,22 @@
---
name: Bug report
name: Bug Report
about: Create a report to help us improve
title: ''
labels: ''
assignees: ''
---
**MacBook (please complete the following information):**
- MacBook Model (https://support.apple.com/en-us/HT201608):
- macOS Version (https://support.apple.com/en-us/HT201260):
- Charger Model (Apple, Third Party, Wattage,...):
- Charging Cable (MagSafe 2, MagSafe 3, USB-C, Apple, Third Party,...):
- AlDente Pro or AlDente Free:
- AlDente Version:
- List or add screenshots of all enabled/disabled settings in AlDente:
- Please share a debug file the next time this happens so that we can assess this issue better. You can find a guide on How to generate and share a debug file on our blog(https://apphousekitchen.com/how-to-generate-and-share-a-debug-file/).
- External Monitor connected?
- MacBook used in Clamshell Mode (with the lid closed)?
**Describe the bug**
A clear and concise description of what the bug is.
@@ -17,18 +28,11 @@ Steps to reproduce the behavior:
3. Scroll down to '....'
4. See error
**Expected behavior**
**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:
**Screenshots and Screen Recordings**
If applicable, add screenshots or screen recordings of the issue to help explain your problem.
**Additional context**
Add any other context about the problem here.

Binary file not shown.

After

Width:  |  Height:  |  Size: 741 KiB

View File

@@ -1,5 +1,9 @@
# AlDente - Charge Limiter🍝
_MacOS menu bar tool to limit maximum charging percentage_
<div align="center">
<img src="AlDente/Assets.xcassets/AppIcon.appiconset/512pt_Mac_1x.png" width=200 height=200>
<h1>AlDente - Battery Care & Monitoring</h1>
</div>
_MacOS menu bar tool to limit maximum charging percentage and improve battery lifespan_
#### Don't overcook your battery! Keep it fresh and chewy with AlDente.
@@ -13,8 +17,8 @@ AlDente Pro is our paid version of AlDente. It has many more features such as He
AlDente Pro is now available on [Setapp](https://apphousekitchen.com/pricing/) too.
## 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 more healthy 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 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/).
## Supported MacBook Models (macOS 11 Big Sur or later required)
@@ -27,23 +31,27 @@ You can download the app from GitHub: <https://github.com/davidwernhart/AlDente/
An installation guide can be found on our website:[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 🍝 icon on your menu bar. 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.: 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 not charging anymore.
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%, 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.
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.
## 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 recourses, we are not able providing support to AlDente Free users or here in Github.
* 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:
* <https://github.com/beltex/SMCKit>
* <https://github.com/sindresorhus/LaunchAtLogin>
* <https://github.com/andreyvit/create-dmg>
## ClosedSource Notice
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 closedsource.
## Disclaimer:
I do not take any responsibility for any sort of damage in result of using this tool! Although this had no negative side effects for me and thousands of others, AlDente still taps in some very low level system functions that are not meant to be tampered with. Use it at your own risk!
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
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.
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.

29
SECURITY.md Normal file
View File

@@ -0,0 +1,29 @@
# Security Policy
## Supported Versions
We release security updates for the latest version of **AlDente** here: https://github.com/AppHouseKitchen/AlDente-Charge-Limiter/releases
## Reporting a Vulnerability
We take the security of our software seriously. If you discover a security vulnerability, we appreciate your help in disclosing it to us in a responsible manner.
**How to Report**
- **Email:** Please send an email to [security@apphousekitchen.com](mailto:security@apphousekitchen.com).
- **Subject Line:** Use a clear and descriptive subject line, such as "Security Vulnerability in AlDente-Charge-Limiter".
- **Content:** Provide a detailed description of the vulnerability, including steps to reproduce it, the potential impact, and any suggested fixes.
**What to Expect**
- **Acknowledgment:** We will acknowledge receipt of your report within 48 hours.
- **Investigation:** Our team will investigate the issue and work on a fix.
- **Updates:** We will keep you informed about the progress of the investigation and remediation.
- **Disclosure:** Once the vulnerability is resolved, we will issue a patch and publicly disclose the issue, crediting you for the discovery if you wish.
**Guidelines**
- **Confidentiality:** Please do not disclose the vulnerability publicly until we have addressed it.
- **Legal:** You must not violate any laws or breach any agreements in the course of discovering and reporting vulnerabilities.
Thank you for helping us keep **AlDente** safe and secure for everyone!