{"id":51503629,"url":"https://github.com/nullne/toggle-display","last_synced_at":"2026-07-07T22:01:55.520Z","repository":{"id":368806242,"uuid":"1285994208","full_name":"nullne/toggle-display","owner":"nullne","description":"macOS menu-bar app: toggle displays, caffeine mode, and break reminders","archived":false,"fork":false,"pushed_at":"2026-07-02T08:28:27.000Z","size":1270,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-02T10:22:29.575Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/nullne.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-07-01T10:42:11.000Z","updated_at":"2026-07-02T08:28:27.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nullne/toggle-display","commit_stats":null,"previous_names":["nullne/toggle-display"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/nullne/toggle-display","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nullne%2Ftoggle-display","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nullne%2Ftoggle-display/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nullne%2Ftoggle-display/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nullne%2Ftoggle-display/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nullne","download_url":"https://codeload.github.com/nullne/toggle-display/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nullne%2Ftoggle-display/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35243953,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-07T02:00:07.222Z","response_time":90,"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":[],"created_at":"2026-07-07T22:01:54.887Z","updated_at":"2026-07-07T22:01:55.503Z","avatar_url":"https://github.com/nullne.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DisplayToggle\n\nA tiny macOS menu-bar app to toggle displays on/off, keep the Mac awake (Caffeine mode), and remind you to take breaks.\n\n## Features\n\n- **Toggle displays** — turn individual displays on/off (DDC power, built-in brightness, or a blackout window fallback).\n- **Caffeine mode** — prevent display sleep.\n- **Break reminder** — after a configurable amount of continuous screen time (default 45 min), a reminder window appears; if you keep going, it re-appears and escalates every few minutes. Locking the screen for over a minute resets the timer. The menu-bar icon gradually fills with color as time passes, turns orange when it's time, and pulses red when overdue.\n\n## Install\n\nVia [Homebrew](https://brew.sh):\n\n```sh\nbrew install --cask nullne/tap/displaytoggle\n```\n\n\u003e The app is ad-hoc signed (not notarized), so Gatekeeper will block it the first time. Either **right-click the app → Open** once, or clear the quarantine flag:\n\u003e\n\u003e ```sh\n\u003e xattr -dr com.apple.quarantine /Applications/DisplayToggle.app\n\u003e ```\n\n## Build from source\n\n```sh\nswift build -c release          # build\nswift test                      # run tests\nbash Scripts/build.sh           # produce dist/DisplayToggle.app\nbash Scripts/create-dmg.sh      # produce dist/DisplayToggle.dmg\n```\n\nRequires macOS 14+ and a Swift 5.10+ toolchain.\n\n## Releasing\n\nReleases are fully automated by GitHub Actions ([`.github/workflows/release.yml`](.github/workflows/release.yml)). To cut a release, just push a version tag:\n\n```sh\ngit tag v1.2.3\ngit push origin v1.2.3\n```\n\nOn a `v*` tag the workflow builds the app, packages `DisplayToggle-\u003cversion\u003e.dmg`, publishes a GitHub Release with it, and updates the Homebrew cask in [`nullne/homebrew-tap`](https://github.com/nullne/homebrew-tap) (bumping `version` and `sha256`). Users then get it with `brew upgrade --cask displaytoggle`.\n\nThe tap update requires a repo secret `TAP_GITHUB_TOKEN` — a fine-grained PAT with **Contents: read and write** on `nullne/homebrew-tap`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnullne%2Ftoggle-display","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnullne%2Ftoggle-display","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnullne%2Ftoggle-display/lists"}