{"id":47580842,"url":"https://github.com/sokogen/flipperzero-htw-ac-remote","last_synced_at":"2026-04-15T17:00:53.445Z","repository":{"id":330353196,"uuid":"1122446840","full_name":"sokogen/flipperzero-htw-ac-remote","owner":"sokogen","description":"Flipper Zero app for controlling HTW air conditioners via infrared","archived":false,"fork":false,"pushed_at":"2026-01-26T23:15:40.000Z","size":95,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-27T10:25:49.809Z","etag":null,"topics":["air-conditioner","fap","flipper-zero","flipperzero","htw","infrared"],"latest_commit_sha":null,"homepage":null,"language":"C","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/sokogen.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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":"2025-12-24T18:40:46.000Z","updated_at":"2026-01-26T23:15:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sokogen/flipperzero-htw-ac-remote","commit_stats":null,"previous_names":["sokogen/flipperzero-htw-ac-remote"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/sokogen/flipperzero-htw-ac-remote","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sokogen%2Fflipperzero-htw-ac-remote","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sokogen%2Fflipperzero-htw-ac-remote/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sokogen%2Fflipperzero-htw-ac-remote/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sokogen%2Fflipperzero-htw-ac-remote/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sokogen","download_url":"https://codeload.github.com/sokogen/flipperzero-htw-ac-remote/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sokogen%2Fflipperzero-htw-ac-remote/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31851057,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-15T15:24:51.572Z","status":"ssl_error","status_checked_at":"2026-04-15T15:24:39.138Z","response_time":63,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["air-conditioner","fap","flipper-zero","flipperzero","htw","infrared"],"created_at":"2026-03-31T19:00:24.234Z","updated_at":"2026-04-15T17:00:53.439Z","avatar_url":"https://github.com/sokogen.png","language":"C","funding_links":[],"categories":["Infrared"],"sub_categories":[],"readme":"# HTW AC Remote for Flipper Zero\n\n[![CI](https://github.com/sokogen/flipperzero-htw-ac-remote/actions/workflows/ci.yml/badge.svg)](https://github.com/sokogen/flipperzero-htw-ac-remote/actions/workflows/ci.yml)\n\nFlipper Zero application for controlling HTW air conditioners via infrared.\n\n## Features\n\n- **Full IR Protocol Support** - Complete implementation of HTW AC IR protocol\n- **All AC Modes** - Off, Cool, Auto, Dry, Heat, Fan\n- **Fan Speed Control** - Auto, Low, Medium, High\n- **Temperature Control** - 17°C to 30°C\n- **Toggle Functions** - Swing, Turbo, Fresh, LED, Clean\n- **Timer Scheduling** - Auto ON/OFF timers from 0.5h to 24h (34 steps)\n- **Settings Persistence** - Save settings to SD card between sessions\n- **Vertical Orientation** - Optimized for one-handed use\n\n## Screenshots\n\n| Main Screen | Timer | Settings |\n|:-----------:|:-----:|:--------:|\n| ![Main](docs/screenshots/main.png) | ![Timer](docs/screenshots/timer.png) | ![Settings](docs/screenshots/settings.png) |\n\n## Building\n\n### Prerequisites\n\n- [ufbt](https://github.com/flipperdevices/flipperzero-ufbt) - Flipper Zero build tool\n\n### Install ufbt\n\n```bash\npip install ufbt\n```\n\n### Build\n\n```bash\ncd htw_ac_remote\nufbt\n```\n\nThe compiled `.fap` file will be in `dist/htw_ac_remote.fap`\n\n### Deploy to Flipper\n\nConnect your Flipper Zero via USB and run:\n\n```bash\nufbt launch\n```\n\nOr manually copy `dist/htw_ac_remote.fap` to your Flipper's SD card:\n```\n/ext/apps/Infrared/htw_ac_remote.fap\n```\n\n## Usage\n\n### Main Screen\n\n- **Mode** - Press OK to cycle through modes (Off → Cool → Auto → Dry → Heat → Fan)\n- **Fan** - Press OK to cycle fan speed (Auto → Low → Med → High)\n- **Temperature** - Use [-] and [+] buttons to adjust (17-30°C)\n- **Toggle Buttons** - Press OK to send toggle command (Swing, Turbo, Fresh, LED, Clean)\n- **Timer** - Open timer configuration menu\n- **Setup** - Open settings menu\n\n### Navigation\n\n- **Up/Down** - Move between rows\n- **Left/Right** - Move between buttons in a row\n- **OK** - Activate/select\n- **Back** - Return to previous screen or exit\n\n### Timer Menu\n\nConfigure auto ON/OFF timers:\n- Use Left/Right to adjust time value\n- Press OK to send timer command to AC\n- Available times: 0.5h, 1h, 1.5h ... 10h, 11h ... 24h\n\n### Settings Menu\n\n- **Save state** - When ON, settings are saved to SD card and restored on next launch\n\n## File Structure\n\n```\nhtw_ac_remote/\n├── application.fam          # App manifest\n├── htw_ac_remote.c          # Main app entry point\n├── htw_ac_remote.h          # App structures\n├── htw_ir_protocol.c        # IR protocol encoder\n├── htw_ir_protocol.h        # Protocol constants and API\n├── htw_state.c              # State management and persistence\n├── htw_state.h              # State structures\n├── htw_ac_remote.png        # App icon (10x10)\n├── HTW_AC.ir                # IR signal library (150 commands)\n├── views/\n│   ├── htw_main_view.c      # Main screen UI\n│   ├── htw_main_view.h\n│   ├── htw_timer_view.c     # Timer configuration UI\n│   ├── htw_timer_view.h\n│   ├── htw_setup_view.c     # Settings UI\n│   └── htw_setup_view.h\n└── docs/\n    ├── ARCHITECTURE.md      # System architecture\n    ├── PROTOCOL.md          # IR protocol specification\n    └── screenshots/         # App screenshots\n```\n\n## IR Protocol\n\nHTW AC uses a pulse-distance encoded protocol:\n\n- **Carrier**: 38 kHz\n- **Frame**: 48 bits (6 bytes), transmitted twice\n- **Encoding**: LSB-first within each byte\n\nSee [docs/PROTOCOL.md](docs/PROTOCOL.md) for detailed protocol documentation.\n\n## License\n\nMIT License\n\n## Acknowledgments\n\n- Flipper Zero team for the amazing device and SDK\n- HTW for making interesting IR protocols to reverse engineer\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsokogen%2Fflipperzero-htw-ac-remote","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsokogen%2Fflipperzero-htw-ac-remote","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsokogen%2Fflipperzero-htw-ac-remote/lists"}