You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
[](https://gitter.im/LoopKit/LoopKit?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
6
+
[](https://gitter.im/LoopKit/Loop?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
7
7
8
-
Loop is an app template for building an artificial pancreas. It is a stone resting on the boulders of work done by [@bewest](https://github.com/bewest/decoding-carelink), [@ps2](https://github.com/ps2/rileylink) and many others.
8
+
Loop is an app template for building an automated insulin delivery system. It is a stone resting on the boulders of work done by many others.
9
+
10
+
Loop is built on top of [LoopKit](https://github.com/LoopKit/LoopKit). LoopKit is a set of frameworks that provide data storage, retrieval, and calcluation, as well as boilerplate view controllers used in Loop.
9
11
10
12
Please understand that this project:
11
13
- Is highly experimental
@@ -24,86 +26,75 @@ Please understand that this project:
24
26
<ahref="/Documentation/Screenshots/Watch%20Notification%20Reservoir.png"><imgsrc="/Documentation/Screenshots/Watch%20Notification%20Reservoir.png?raw=true"alt="Screenshot of bolus failure notification on Apple Watch"width="141"></a>
25
27
<ahref="/Documentation/Screenshots/Watch%20Notification%20Bolus%20Failure.png"><imgsrc="/Documentation/Screenshots/Watch%20Notification%20Bolus%20Failure.png?raw=true"alt="Screenshot of bolus failure notification on Apple Watch"width="141"></a>
<br/><aname="hw1">1</a>. Offline access to glucose requires a Receiver with Share and the [Share2 app](https://itunes.apple.com/us/app/dexcom-share2/id834775275?mt=8) to be running on the same device. Internet-dependent access via Share servers is also supported.
65
71
<br/><aname="hw2">2</a>. Pump must have a remote ID added in the [Remote Options](https://www.medtronicdiabetes.com/sites/default/files/library/download-library/workbooks/x22_menu_map.pdf) menu.
66
72
<br/><aname="hw3">3</a>. Early firmware (US <= 2.4A, AU/EUR <= 2.6A) is required for using Closed Loop and Bolus features.
67
-
<br/><aname="hw4">4</a>. It's not impossible, but comms-heavy and there's some work to be done. File an issue if you're someone who's up for the challenge and can test this hardware configuration.
68
-
69
-
### RileyLink
70
-
71
-
Bluetooth LE communication with Minimed pumps is enabled by the [RileyLink](https://github.com/ps2/rileylink), a compact BLE-to-916MHz bridge device designed by the incredible [@ps2](https://github.com/ps2). Please visit the [repository](https://github.com/ps2/rileylink) and the [gitter room](https://gitter.im/ps2/rileylink) for more information.
72
-
73
-
### LoopKit
74
-
75
-
Loop is built on top of [LoopKit](https://github.com/LoopKit/LoopKit). LoopKit is a set of frameworks that provide data storage, retrieval, and calcluation, as well as boilerplate view controllers used in Loop.
73
+
<br/><aname="hw4">4</a>. It's not impossible, but comms-heavy and there's [some work to be done](https://github.com/LoopKit/Loop/issues/100).
76
74
77
-
#Getting Started
75
+
### Mac and Xcode
78
76
79
-
Fork and clone this repository so you can commit the changes you'll make below.
77
+
To build Loop you will need a Mac, and have Xcode 8 installed on it. You can build Loop without an Apple Developer Account, but any apps built this way will expire after a week, so signing up for the $99 developer account is recommended.
80
78
81
-
[Sign up for the Loop Users announcement list](https://groups.google.com/forum/#!forum/loop-ios-users) to stay informed of critical issues that may arise.
79
+
### iOS Phone
82
80
83
-
## Assigning a Bundle Identifier
81
+
Loop will run on on any iPhone that is compatible with iOS 10.
84
82
85
-
[](/Documentation/Assigning%20a%20bundle%20identifier.png)
83
+
### RileyLink
86
84
87
-
Open `Loop.xcodeproj` in Xcode. In the Project Navigator on the left-hand side, open `Loop.xcconfig`. Change the value of `MAIN_APP_BUNDLE_IDENTIFIER` to a unique reverse-domain name of your choosing.
85
+
Bluetooth LE communication with Minimed pumps is enabled by the [RileyLink](https://github.com/ps2/rileylink), a compact BLE-to-916MHz bridge device designed by [@ps2](https://github.com/ps2). Please visit the [repository](https://github.com/ps2/rileylink) and the [gitter room](https://gitter.im/ps2/rileylink) for more information.
88
86
89
-
##Installing Carthage
87
+
###Carthage
90
88
91
89
[Carthage](https://github.com/carthage/carthage) is used to manage framework dependencies. It will need to be [installed on your Mac](https://github.com/carthage/carthage#installing-carthage) to build and run the app, but most users won't have a need to explicitly rebuild any dependencies.
92
90
93
-
## Configuring Services
94
-
95
-
Loop optionally supports select third-party remote services, which are configured in the Settings screen.
91
+
# Getting Started
96
92
97
-
| Service | Description
98
-
| ---------------------- | -------------
99
-
| Dexcom Share | Downloads glucose data if a local G5 Transmitter or G4 Receiver with Share is not available.
100
-
| Nightscout | Uploads treatments and other pump data. Note that you will need to set "Nightscout history uploading" to "On" in Settings for treatments to be fetched from your pump and uploaded to Nightscout.
101
-
| mLab | Uploads diagnostic data about each loop run, as well as app errors. At this time, it is strongly recommended that you configure this service in case retrospective analysis is needed.
102
-
| Amplitude | Tracks private, single-user behavioral and system analytics (no health data is sent)
93
+
[Sign up for the Loop Users announcement list](https://groups.google.com/forum/#!forum/loop-ios-users) to stay informed of critical issues that may arise.
103
94
104
-
# Making it Your Own
95
+
[Please visit the Wiki for a "Guide to Loop" setup, installation, FAQs, and use.](https://github.com/LoopKit/Loop/wiki)
105
96
106
-
[Please visit the Wiki for more info on customizing the app](https://github.com/LoopKit/Loop/wiki/Personalizing-Your-App-Name-&-Icon)
97
+
(Note: there is also a tab for the Wiki at the top of this page)
0 commit comments