FlexControl 자동화

FlexControl (灵控)는 트리거, 액션, 범위로 Android를 자동화하는 도구입니다. 키와 제스처뿐 아니라 Wi-Fi, 배터리, 충전기, 헤드셋, Bluetooth 기기, 일정, 알림, UI 이벤트, QuickJS 조건을 사용해 일상 시나리오를 기기 안에서 실행할 수 있습니다.

🎯 매핑 가능한 키

• 음량 +/− / 음소거

• 유·무선 헤드셋 미디어 버튼

• 외장 Bluetooth 키보드, 텐키, 매크로 패드

• USB OTG 키보드와 게임 컨트롤러

• KeyEvent로 노출된 OEM 사이드 버튼

각 키에 짧게 누르기·더블·트리플·길게 누르기 네 가지 동작을 따로 설정 가능 — 버튼 하나로 네 가지 액션.

⚙️ 내장 동작

• 지정 앱 / Activity 실행

• 손전등·Wi-Fi·블루투스·모바일 데이터·회전 잠금·방해 금지 토글

• 미디어 볼륨 단독 조절 (벨소리와 분리)

• 스크린샷 / 화면 녹화

• 지정 좌표에서 스와이프 / 탭 / 멀티터치 제스처

• 알림 창 펼치기, 앱 전환, 홈, 화면 잠금

• URL 열기, Intent 전송, 전화 걸기

• 클립보드 붙여넣기, 텍스트 입력 시뮬레이션, 접근성 동작 실행

• Shell / ADB 명령 실행 (ROOT 또는 ADB 무선 디버깅 페어링 필요)

📝 JavaScript 스크립트 기반 고급 자동화

FlexControl에는 QuickJS 런타임이 내장되어 있으며 접근성·제스처·알림·시스템 상호작용용 API가 준비되어 있습니다. 직접 함수를 작성하거나, 커뮤니티 스크립트를 가져오거나, 내장 함수를 구문 강조 편집기로 바로 수정할 수 있습니다.

• QuickJS 런타임 + 깔끔한 ClickClick 네임스페이스

• 키워드 하이라이트와 오류 표시가 있는 인앱 에디터

• 스크립트를 텍스트/딥링크로 공유

🔔 알림 트리거

어떤 앱의 알림이든 실행·해제·버튼 펼치기, 또는 텍스트를 추출해 스크립트에 전달할 수 있습니다. 음악·내비·채팅 앱의 모든 알림을 자동화 이벤트로.

🛋 플로팅 볼 & 홈 바로가기

화면 어디든 고정되는 플로팅 버튼으로 자주 쓰는 동작을 탭 한 번에 실행. 홈 화면 바로가기를 만들면 FlexControl를 열지 않고도 스크립트를 실행 가능.

🔒 프라이버시 우선

키 이벤트·스크립트·규칙·알림 내용은 사용자가 설정한 자동화를 위해 기기에서 처리됩니다. FlexControl은 앱 계정이 필요 없으며 로컬 규칙이나 스크립트를 기본적으로 업로드하지 않습니다. 네트워크는 온라인 라이브러리, Play Billing 구매 확인, 문서, 설정과 플랫폼 정책이 허용하는 진단 기능에 사용됩니다.

📦 프로젝트 기반

FlexControl은 Novaryn이 개발했으며 이전 ClickClick 프로젝트(github.com/fishand73/ClickClick)를 기반으로 합니다.

왜 "접근성" 권한이 필요한가?

Android는 다른 앱이 전면에 있을 때 글로벌 하드웨어 키를 받거나, 규칙을 위한 UI/창 이벤트를 관찰하거나, 뒤로/홈/제스처/알림 버튼/스크린샷 같은 선택한 동작을 실행하는 기능을 AccessibilityService에만 허용합니다. FlexControl는 사용자가 구성한 규칙과 스크립트에만 이 접근을 사용합니다. 패키지명, 뷰 ID, 텍스트, 콘텐츠 설명, 사용자가 명시적으로 실행한 스크린샷 같은 이벤트 데이터는 기기에서 처리되며 기본적으로 업로드되지 않습니다.

최소 요구 사항:

• Android 5.0 (API 21) 이상

• "灵控-按键服务" 접근성 서비스 활성화 (키 캡처용)

• 알림 접근 권한 활성화 (알림 연동 기능용)

권한:

• 접근성 서비스 — 하드웨어 키 읽기, UI/창 규칙 매칭, 선택한 자동화 동작 실행

• 알림 접근 — 알림에 반응 (선택)

• 다른 앱 위에 표시 — 플로팅 볼

• 알림 전송 (Android 13+) — 실행 중 알림

• 포그라운드 서비스 — 장시간 스크립트 유지

표준 버전은 가벼운 설정에 적합합니다. Pro는 더 많은 키 규칙, 제스처 규칙, 플로팅 볼 동작, 앱별 규칙 한도를 제공합니다.