Code Monkey home page Code Monkey logo

apple-juice's Introduction

Apple Juice application icon

Apple Juice

An advanced battery gauge for macOS. Apple Juice can show you the estimated battery time remaining and notify you, when your battery charge hits certain percentages.

Apple Juice Appmenu Apple Juice Notifications

Today Widget

You can get even more information about your current battery status, without cluttering your screen, with the Apple Juice Today Widget. Just take a quick glance at your battery’s stats, whenever you want.

Apple Juice Today Widget

How do I install it?

  • Install Apple Juice from the published binary, by downloading the latest release and dropping it into your Applications folder.

  • Install Apple Juice using Homebrew, using the command brew install --cask apple-juice

  • You can also download the source code and build it yourself. You'll have to have Carthage installed, and run carthage bootstrap, inside the project folder, to pull in the required dependencies.

ATTENTION

Loosen Gate Keeper Restrictions

As I'm not paying for an Apple Developer Account, you have to allow unsigned third party apps within the system preferences, to run Apple Juice. To allow unsigned apps choose Anywhere under System Preferences: Security: Allow apps downloaded from. If you don't have the option to select Anywhere you'll have to loosen the Gate Keeper restrictions by running sudo spctl --master-disable in the Terminal. OSXDaily have a great step by step guide. Afterwards you should be able to select Anywhere.

Remove Quarantine Attributes

Alternatively you can remove the quarantine attribute from the downloaded application package, as suggested by henrycodebreaker in issue #18. By executing the following command inside your Terminal: xattr -cr /path/to/Apple\ Juice.app.

Why does this project exist?

There are plenty of other solutions out there, so why make another one? I wanted an app that looks like it’s part of the system. As if it were built directly into macOS. Which can show me a lot of information, but only when I need them. And, most importantly, it should display notifications for several percentages. Since I haven’t found such an app, I made one myself.

How do I contribute?

You can fork this project, make your changes and send me a pull request. Make sure SwiftLint succeeds and everything is translated before submitting your pull request. Or, since the whole source code is licensed under the MIT License, fork Apple Juice and make your own thing. :-)


License

The MIT License (MIT)

Copyright (c) 2015 - 2020 Raphael Hanneken

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of 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.

apple-juice's People

Contributors

ailtonvivaz avatar dotwee avatar kawarimidoll avatar nicopasla avatar raphaelhanneken avatar stepheneb avatar wadinj avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

apple-juice's Issues

Does not work with Mac desktop

Want to have this work for my desktop, and detect when on UPS / battery, it appears in menu bar, but has X over battery and does not run.

Notifications not getting posted

Notifications are not posted when a notification enabled percentage is skipped, e.g. the battery charge jumps from 11% to 9% then the 10% notification won't be posted. Shouldn't happen too often, but it's stupid behaviour nonetheless.

Adding 80% of battery Notification

Please consider to add notification also when battery reached 80% of charge. It will help users, who are trying to keep them between 20%-80% for most of the time to extend battery life.

Low battery colour

Consider changing the colour of the battery in the menu bar to red when low.
#fc3d39?

Update interval

Hello,

I like your app. It is the best battery app ❤️. When I plug in my power adapter, the battery icon will need 5sec to update the symbol, but the system battery needs no update time.

P.s.

I added your battery app by Homebrew Cask

brew cask install apple-juice

https://brew.sh
https://caskroom.github.io

Add "Launch at login" setting

I think a "Launch at login" toggle/checkbox would be useful, since now the user can only achieve that by manually adding it in System settings.

@raphaelhanneken let me know what do you think about that feature, and I could give it a look.

Add option to hide time and percentage

Since the Apple Juice widget already shows both time and percentage, it would be nice to have the option to display only the battery icon in the menu bar. Thanks!

Installation is failed using latest Homebrew

The command brew cask install in README.md doesn't work now because of update of Homebrew.
This is not a bug of this app, but the document needs to be fixed.

homebrew discussions: Error: Calling brew cask install is disabled! · Discussion #340 · Homebrew/discussions

brew cask <command> was deprecated in favor of brew <command> --cask in Homebrew 2.6.0. Now that 2.7.0 has been released, they have been disabled.

homebrew blog: 2.6.0 — Homebrew

All brew cask commands have been deprecated in favour of brew commands (with --cask) when necessary

screenshot:
Calling brew cask install is disabled

Displays 99% At Full Charge

screen shot 2018-04-25 at 12 25 35 pm

While the charge should be displaying 100% I think there's a floating point or logic error stopping it from displaying correctly.

Device: Macbook Pro 15in Late 2016
OS: 10.13.4 (17E199)

1092h 15m

Hey,

the reaming time is wrong. After 30 - 60sec is it correct. It could be some update issue or wrong conversion.

Screenshot 2020-12-23 at 15 38 18

french translation

Hello!
First, it's a very good app, it replaced my battery indicator since 2 month but the French version of the app isn't right, I don't know how to code but I can help translate.

Apple Juice.app is damaged and ca't be opened.

Hi,
after failed update to latest version, I uninstalled an app and try to install latest version, but after install and open an app, I get "Apple Juice.app is damaged and ca't be opened. You should move it to the Trash" message.

I tryed brew and dmg installation.

I have latest Mac os.

'%' should not have preceding space

Minor gripe, but in Apple's default battery icon, there is no space preceding the % sign. Example: 87% and not 87 %. Would be great if the app could conform to this.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.