{"id":15707729,"url":"https://github.com/psychollama/luminary","last_synced_at":"2026-04-27T12:01:50.115Z","repository":{"id":92781988,"uuid":"92641422","full_name":"PsychoLlama/luminary","owner":"PsychoLlama","description":"Smartphone app for Philips Hue (frontend of filament)","archived":false,"fork":false,"pushed_at":"2019-07-05T13:04:08.000Z","size":859,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-07-05T00:19:26.480Z","etag":null,"topics":["iot","philips-hue","react-native"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/PsychoLlama.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":"2017-05-28T05:16:39.000Z","updated_at":"2020-02-01T20:30:41.000Z","dependencies_parsed_at":"2023-04-13T16:16:15.128Z","dependency_job_id":null,"html_url":"https://github.com/PsychoLlama/luminary","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/PsychoLlama/luminary","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PsychoLlama%2Fluminary","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PsychoLlama%2Fluminary/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PsychoLlama%2Fluminary/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PsychoLlama%2Fluminary/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PsychoLlama","download_url":"https://codeload.github.com/PsychoLlama/luminary/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PsychoLlama%2Fluminary/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32335297,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-26T23:26:28.701Z","status":"online","status_checked_at":"2026-04-27T02:00:06.769Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["iot","philips-hue","react-native"],"created_at":"2024-10-03T20:41:13.315Z","updated_at":"2026-04-27T12:01:50.098Z","avatar_url":"https://github.com/PsychoLlama.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Luminary\nAn Android app for managing [Hue lights](https://www2.meethue.com/en-us), focused on speed and configurability.\n\n\u003e Made with [Create React Native App](https://github.com/react-community/create-react-native-app) because I'm lazy.\n\n## Purpose\nI've got those fancy wifi lights from Philips. They're awesome, but the published apps don't have what I'm looking for: speed and customization.\nOnce you replace all your lights, the first thing you need is a better light switch. Since Hue can do a lot more than turn on and off, many apps make toggling a second-rate citizen. The advanced features are polished, but when you just want a light on, it's annoyingly slow.\n\nThe first goal of Luminary is to be the best light switch available.\n\nIt achieves this in two ways:\n\n### One-touch light toggle\nThe most common action should be the easiest. Tapping on a group of lights toggles their on/off state.\n\n### Customizable layout\nThis isn't a normal light switch. It's a light switch for your entire home. With Luminary, you can customize what rooms are shown, where they are on the screen, and the size relative to other rooms.\n\nfor example: you could make your whole screen a giant toggle button for your living room, or you could take half your screen for the living room, and split the rest between the kitchen and stairwell. That's the level of control you're given.\n\n\u003cimg src=\"./images/layout-screenshot.png\" alt=\"Example screenshot\" width=\"250\" /\u003e\n\n## Unique features\nRight now the focus is on speed, but here are some plans for the future:\n- Scenes: add scene recall. No big surprise here.\n- Animation builder: create animations for a set of lights. They'll probably be used like scenes.\n- Alarm: configure your phone and light alarms simultaneously. This could be tricky with React Native/Expo...\n\nAlso, this isn't really a feature, but the backend uses a [GraphQL server called filament](https://github.com/PsychoLlama/filament). Because of this, I can keep extra data in Postgres, like animations and light usage history. But I haven't yet.\n\n## Using it\nThis step isn't well polished, but should be straightforward. Open an issue if you run into problems.\n\n- Download and run [filament](https://github.com/PsychoLlama/filament) on the same network as your Hue bridge.\n- Then install the app. You can do this two ways:\n\n### Method #1: build logs (Android)\n1. Any commit message containing `[expo build]` will contain the link to the APK in [the build logs](https://travis-ci.org/PsychoLlama/luminary). Those builds are usually 10 minutes longer.\n2. Get that link to your phone somehow and download it. You can probably figure it out from there (or Google how to sideload an Android app).\n\n### Method #2: compile it yourself\n\u003e **Note:** You'll need an [Expo](https://expo.io/) account.\n\n- Clone this repo\n- `$ yarn install`\n- Log into expo via `$ yarn exp login`\n- Compile the app with `$ yarn exp build:android` (`build:ios` should work too, but I've never tried it)\n- The compile process isn't fast. You can check the progress via `$ yarn exp build:status`.\n\nI've got some automated tooling which gives me continuous app updates, so I usually don't need this much ceramony. For that reason I (probably) won't expend effort to simplify the process unless someone posts an issue.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpsychollama%2Fluminary","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpsychollama%2Fluminary","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpsychollama%2Fluminary/lists"}