https://github.com/archagon/good-spirits

A drink tracker for iOS with Untappd and HealthKit integration.
https://github.com/archagon/good-spirits

Last synced: 24 days ago
JSON representation

A drink tracker for iOS with Untappd and HealthKit integration.

• Host: GitHub
• URL: https://github.com/archagon/good-spirits
• Owner: archagon
• License: gpl-3.0
• Created: 2018-07-18T07:14:04.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2018-09-05T04:26:03.000Z (over 6 years ago)
• Last Synced: 2024-11-12T20:46:08.735Z (about 1 month ago)
• Language: Swift
• Homepage: https://itunes.apple.com/us/app/good-spirits/id1434237439?mt=8
• Size: 102 MB
• Stars: 179
• Watchers: 8
• Forks: 13
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

• fucking-open-source-ios-apps - Good Spirits

README

        
Good Spirits is a drink tracking iOS app that helps you stay under the government limits for "low-risk" drinking. Includes charts and stats, the ability to pull your check-ins from Untappd, and the ability to sync your drinks as calories to HealthKit.

You can find the App Store version [here][app]. Unfortunately, HealthKit is not available in this release. You can always compile the app yourself to get this functionality.



# Technical Details

Compiling the code should be pretty straight-forward. Just be sure to run `git submodule update --init --recursive` after cloning the repo.

Note that there are three unique build configurations in this project, designed to toggle donation and HealthKit functionality. You can change this in your Scheme settings.

The directory structure is a bit messy. `External` contains modified dependencies. `Submodules` contains unmodified (git-submodule) dependencies. `Modules` contains the independent data layer, compilable as its own project. `GoodSpirits` contains the actual project code.

Sometimes, the compiler will complain about a "cycle in dependencies between targets 'Good Spirits' and 'GRDBiOS'". A clean build will fix this.

My Untappd Client ID, which is necessary for Untappd API calls, is not included. (I'm not sure I should be publishing it.) If you have API access, you can create a Keys.plist file in the `GoodSpirits` directory, add it to the Good Spirits target in Xcode, and add your Client ID string to the plist with an `untappd` key.

# Licensing

The source code is available under the GPL license with absolutely no support or maintenance commitments. Note that GPL-licensed code isn't compatible with the App Store. If you're interested in releasing a fork in the App Store, please contact me.

You can find licenses for the third-party assets in the Licenses.txt file.

The app icon is **not** licensed for public use! You may not use the name of the app ("Good Spirits") nor the app icon in any of your own projects.

[app]: https://itunes.apple.com/us/app/good-spirits/id1434237439?mt=8&ref=github