{"id":15717547,"url":"https://github.com/7hannahadams7/dexcommacdisplay","last_synced_at":"2026-04-30T01:39:00.027Z","repository":{"id":222150203,"uuid":"756400971","full_name":"7hannahadams7/dexcomMacDisplay","owner":"7hannahadams7","description":"A macOS Dexcom display, with menu bar setup, graphical display of 3hrs of readings, and customizable high and low alerts.","archived":false,"fork":false,"pushed_at":"2024-04-03T18:36:29.000Z","size":3085,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-06T00:41:53.414Z","etag":null,"topics":["dexcom","dexcomg6","macos","macos-app","menubar-app"],"latest_commit_sha":null,"homepage":"","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/7hannahadams7.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-12T15:42:55.000Z","updated_at":"2024-06-17T17:40:18.000Z","dependencies_parsed_at":"2024-02-15T20:23:56.658Z","dependency_job_id":"efeeb466-06e5-4c14-a263-f92b9481988a","html_url":"https://github.com/7hannahadams7/dexcomMacDisplay","commit_stats":null,"previous_names":["7hannahadams7/dexcommacdisplay"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/7hannahadams7%2FdexcomMacDisplay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/7hannahadams7%2FdexcomMacDisplay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/7hannahadams7%2FdexcomMacDisplay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/7hannahadams7%2FdexcomMacDisplay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/7hannahadams7","download_url":"https://codeload.github.com/7hannahadams7/dexcomMacDisplay/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246380746,"owners_count":20767896,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dexcom","dexcomg6","macos","macos-app","menubar-app"],"created_at":"2024-10-03T21:50:29.201Z","updated_at":"2026-04-30T01:38:59.997Z","avatar_url":"https://github.com/7hannahadams7.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n![Portolio Display](images/dexcomMacDisplay.png) \n\n-------\n\n# Feature Walkthrough\nWhen the app is running on your mac, the code automatically fetches data every 5 minutes to stay up to date with your Dexcom's status. \nThe high and low alert boundaries are edited for the below images to trigger alerts for example purposes. The behavior will appropriately follow your specified bounds. \n\n## Menu Bar Icon\n![Dexcom Value in Menu Bar](images/Regular%20-%20MenuBar.png) \n\nThe current Dexcom reading and trend arrow displays in your menu bar, along with alerts for high and low values based on your specified bounds. \n\n![Dexcom Alert in Menu Bar](images/HighAlert%20-%20MenuBar.png)\n\n## Graph View\nIn the menu bar window, the current reading and trend is shown above your historical data. The graph can be collapsed or expanded, showing 1 hour and 3 hours of data. \n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/TrendExample%20-%20Window.png\" height=\"300\" alt=\"Collapsed Window\"\u003e\n  \u003cimg src=\"images/TrendExample%20-%20Expanded.png\" height=\"300\" alt=\"Expanded Window\"\u003e\n\u003c/p\u003e\n\nThe top corner settings allow you to adjust your high and low alert settings and to force refresh the data before the timer. The color of the window will also change color according to the current alert. \n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"images/HighAlert%20-%20ColorChange.png\" height=\"300\" alt=\"Alert Window Color Change\"\u003e\n  \u003cimg src=\"images/LowAlert%20-%20ColorChange.png\" height=\"300\" alt=\"Alert Window Color Change\"\u003e\n  \u003cimg src=\"images/Settings.png\" height=\"300\" alt=\"Settings\"\u003e\n\u003c/p\u003e\n\nNote the boundaries in the examples above that trigger the alerts.\n\n-------\n\n# Setup\nBelow is the walkthrough to setup the macOS Dexcom display on your machine. \n\n## Python 3\nThe dexcomMacDisplay script requires the use of python3. Follow the below steps to ensure proper setup and find the path to the Python executable. \n\n### Install Python 3\n1. Visit the [Python Downloads](https://www.python.org/downloads/) page.\n2. Download the latest version of Python 3 for Windows.\n3. Follow the installation instructions provided during the installation process.\n\n### Verify Installation\nAfter installation and finding the path, open a terminal and run the following command to verify that Python 3 is installed:\n\n```bash\npython3 --version\n```\n\n### Find the Path to Python 3\nTo configure the project, you'll need to know the path to Python 3 on your machine. Here's how you can find it:\n\n- **Windows:**\n  - Open a Command Prompt.\n  - Type `where python` and press Enter. Look for the path to the Python executable.\n\n- **macOS and Linux:**\n  - Open a terminal.\n  - Type `which python3` and press Enter. Look for the path to the Python executable.\n \n## File Path Configuration\nNow with the location of your Python executable, the project needs access to your file paths.\n\n- Open `PythonConfigTemplate.swift`.\n- Replace the placeholder paths with the actual paths on your system.\n  - Change the variable `pythonPath` to the path you found above to you Python executable. The full path should end with `/python3`.\n  - Change the variable `projectPath` to the location of this project file (ex. `/Users/User1/Downloads/`)\n- Save the file as `PythonConfig.swift`.\n\n## Pydexcom Install and Setup\nThis project uses the pydexcom API to pull your dexcom readings. \n\nFollow along with the creator's steps to install pydexcom on your machine and setup your Dexcom account for sharing. \n\u003e\u003e https://github.com/gagebenne/pydexcom\n\nMost importantly, follow the first two steps to get pydexcom installed and your Dexcom sharing configured. \n1. Download the Dexcom G6 / G5 / G4 mobile app and enable the Share service.\n  The Dexcom Share service requires setup of at least one follower to enable the share service, but pydexcom will use your credentials, not the follower's\n2. Install the pydexcom package.\n   `pip3 install pydexcom`\n\n## Setting Up Dexcom Credentials\nTo use this project, you'll need to set up your own Dexcom credentials. Follow these steps:\n\n1. Open the `credentials_template.json` file located in the project directory.\n2. Replace the placeholders with your Dexcom username and password.\n3. Save the file as `credentials.json`.\n4. Now you're ready to run the project with your own credentials.\n\n**NOTE:** These credentials must be YOUR DEXCOM ACCOUNT credentials, not a follower of the account. See the pydexcom documentation for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F7hannahadams7%2Fdexcommacdisplay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F7hannahadams7%2Fdexcommacdisplay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F7hannahadams7%2Fdexcommacdisplay/lists"}