{"id":34066740,"url":"https://github.com/hfern/winix","last_synced_at":"2026-04-02T02:18:46.086Z","repository":{"id":48884962,"uuid":"289171053","full_name":"hfern/winix","owner":"hfern","description":"Python Driver and CLI for the Winix C545 Air Purifier","archived":false,"fork":false,"pushed_at":"2021-07-07T06:23:57.000Z","size":75,"stargazers_count":26,"open_issues_count":3,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-12-16T06:30:53.495Z","etag":null,"topics":["cli","iot","python","winix"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hfern.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-08-21T03:45:07.000Z","updated_at":"2025-05-15T11:20:21.000Z","dependencies_parsed_at":"2022-09-16T04:21:34.525Z","dependency_job_id":null,"html_url":"https://github.com/hfern/winix","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/hfern/winix","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hfern%2Fwinix","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hfern%2Fwinix/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hfern%2Fwinix/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hfern%2Fwinix/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hfern","download_url":"https://codeload.github.com/hfern/winix/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hfern%2Fwinix/sbom","scorecard":{"id":463424,"data":{"date":"2025-08-11","repo":{"name":"github.com/hfern/winix","commit":"aa3add00821d965b35cd7c6b9bf3e8e2034083ad"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":3.3,"checks":[{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Code-Review","score":1,"reason":"Found 2/19 approved changesets -- score normalized to 1","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/main.yml:12: update your workflow using https://app.stepsecurity.io/secureworkflow/hfern/winix/main.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/main.yml:14: update your workflow using https://app.stepsecurity.io/secureworkflow/hfern/winix/main.yml/master?enable=pin","Info:   0 out of   2 GitHub-owned GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/main.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":8,"reason":"2 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2024-48 / GHSA-fj7x-q9j7-g6q6","Warn: Project is vulnerable to: PYSEC-2022-43017 / GHSA-qwmp-2cf2-g9g6"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 15 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-19T11:47:54.787Z","repository_id":48884962,"created_at":"2025-08-19T11:47:54.787Z","updated_at":"2025-08-19T11:47:54.787Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31294527,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T01:43:37.129Z","status":"online","status_checked_at":"2026-04-02T02:00:08.535Z","response_time":89,"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":["cli","iot","python","winix"],"created_at":"2025-12-14T06:47:38.654Z","updated_at":"2026-04-02T02:18:46.075Z","avatar_url":"https://github.com/hfern.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Winix Controller\n\nThis is a Python library for controlling Winix C545 Air Purifier\ndevices. I reverse-engineered the API calls from the Android app. There\nare a few weird idiosyncrasies with the Winix backends.\n\nIncluded in this package is a CLI program `winixctl`.\n\n## Setup\n\nInstall using PyPI: `pip install winix`.\nYou then have access to the `winix` module in python as well\nas the `winixctl` command for shell (which uses the library).\n\n## `winixctl` CLI\n\n```\n$ winixctl\nusage: winixctl [-h] [--device DEVICE_SELECTOR] {login,refresh,devices,getstate,fan,power,mode,plasmawave} ...\n\nWinix C545 Air Purifier Control\n\npositional arguments:\n  {login,refresh,devices,getstate,fan,power,mode,plasmawave}\n    login               Authenticate Winix account\n    refresh             Refresh account device metadata\n    devices             List registered Winix devices\n    getstate            Get device state\n    fan                 Fan speed controls\n    power               Power controls\n    mode                Mode controls\n    plasmawave          Plasmawave controls\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --device DEVICE_SELECTOR, -D DEVICE_SELECTOR\n                        Device Index/Mac/Alias to use\n```\n\nIn order to control your device, you first must run `winixctl login`.\nthis will save a token from the Winix backend in a file on your system\nat `~/config/winix/config.json`. It will prompt you for a username\nand password. You can use the `--username` and `--password` flags as well.\n\n\nYou can see the devives registered to your winix account\nwith `winixctl devices`.\n\n    ~/dev/winix(master*) » winixctl devices\n    1 devices:\n    Device#0 (default) -------------------------------\n          Device ID : 123456abcde_********** (hidden)\n                Mac : 123456abcde\n              Alias : Bedroom\n           Location : SROU\n\n    Missing a device? You might need to run refresh.\n\nThe last portion of the Device ID is hidden as it can be used to control\nthe device.\n\n### Multi-device Support\n\nBy default the commands will work on the first device you have in your Winix account. If you\nhave multiple air purifiers, you can specify which device to use by specifying\na value for the top-level `--device` flag (short: `-D`).\n\nYou may specify one of:\n- The device **index**. Example: `0` _(the default device selector)_.\n- The device **mac**. Example: `123456abcde`. Mac values stay the same between device registration.\n    If you have a device that you move between Wifi networks frequently then you will want\n    to use this.\n- The device **alias**. Example: `bedroom`. This is the most human-friendly version.\n\n\n**Examples**\n\nTurn off the bedroom air purifier _using an alias as the selector_:\n\n    winixctl -D bedroom power off\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhfern%2Fwinix","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhfern%2Fwinix","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhfern%2Fwinix/lists"}