설치와 시작
공식 릴리스의 메인 APK를 설치하고 Android에서 새글을 켭니다.
어떤 파일을 내려받아야 하나요?
GitHub Releases에서 net.chanpaca.saegeul로 시작하는 최신 사용자 앱 APK 하나를 내려받으면 됩니다. 한글 플러그인 APK는 이전 배포 호환과 독립 검증용 선택 파일입니다.
한글 플러그인을 따로 설치해야 하나요?
아니요. 최신 새글 메인 앱에는 libhangul C 엔진과 한글 입력 설정이 함께 들어 있습니다. 이전 버전에서 플러그인을 설치했다면 최신 메인 앱으로 업데이트한 뒤 별도 플러그인은 제거해도 됩니다.
설치 시 "출처를 알 수 없는 앱" 또는 "안전하지 않은 앱" 경고가 뜹니다
Google Play Store 외부에서 APK를 직접 내려받았을 때 Google Play Protect가 아직 등록되지 않은 서명으로 인식하여 표시하는 표준 안내입니다. 앱 자체의 결함이나 악성코드가 아닙니다.
공식 GitHub Releases가 아닌 곳에서 받은 파일은 설치하지 마세요. 설치가 차단되면 Play Protect를 끄지 말고, 릴리스의 SHA-256 체크섬과 아래 GitHub 직접 배포 APK 서명 지문이 일치하는지 먼저 확인하세요.
Google Play에서 설치한 앱은 Play가 별도 앱 서명 키로 다시 서명하므로 GitHub APK와 지문이 다릅니다.
배포 채널별 공식 서명 인증서 지문(SHA-256)
GitHub 직접 배포 APK와 호환·검증용 한글 플러그인 APK는 새글 업로드/릴리스 키로 서명됩니다.
3B:08:8B:5C:6A:69:E3:6C:62:80:2E:F5:D4:33:BD:9D:84:5B:8E:98:09:27:8E:13:13:36:A5:03:DA:90:1A:66
Google Play 설치본은 Play App Signing 키로 서명됩니다.
9F:22:43:69:28:D5:DC:AE:08:EF:26:57:DF:D7:C3:AB:88:F6:B7:E3:04:8F:B7:1D:2D:41:E9:C2:25:6F:E9:11
Android SDK 터미널에서 apksigner verify --verbose --print-certs 파일명.apk 명령으로 설치 경로에 맞는 지문과 v1/v2/v3 서명을 직접 검증할 수 있습니다.
특정 게임이나 웹뷰 앱에서 한글 조합이 깨질 때의 대처법
일부 앱은 한글 조합 중인 중간 버퍼(Composing Text)를 정상 처리하지 못합니다. 설정 > 고급 > 한글 버퍼 호환 모드를 켜면 키보드 내부에서 글자를 완성한 후 한 덩어리로 전달합니다. 시스템 붙여넣기, Ctrl+V, 직접 확정 방식 중 선택할 수 있습니다.
AI와 내 컴퓨터 연결
추가 API 사용료 없이 기존 Codex/Claude 구독을 모바일에서 활용합니다.
Windows, macOS, Linux PC에 이미 로그인된 Codex CLI 또는 Claude Code를 새글 Companion이 로컬에서 프록시합니다. 별도 유료 API 키 결제 없이 기존 구독 사용량 내에서 동작합니다.
내 컴퓨터(Windows/macOS/Linux)와 연결하려면 어떻게 해야 하나요?
1. 릴리스 페이지에서 OS에 맞는 Companion 압축 파일(saegeul-companion-windows.zip, macos.tar.gz, linux.tar.gz)을 내려받아 압축을 풉니다.
2. Windows는 install.bat 더블클릭 (작업 스케줄러 자동 등록), macOS는 install.command 실행 (LaunchAgent 데몬 등록), Linux는 ./install.sh를 실행 (systemd 서비스 등록)합니다.
3. 휴대폰과 PC가 같은 Tailscale tailnet에 연결되어 있는지 확인합니다.
4. 새글 앱의 개인정보·AI > 내 컴퓨터 연결에서 발견된 PC를 승인합니다. 연결은 Tailscale Serve HTTPS 종단간 암호화로만 통신합니다.
내 문장과 로그인 토큰이 유출되지 않나요?
Codex나 Claude의 로그인 토큰과 세션은 PC에만 머무르며 모바일 앱으로 복사되지 않습니다. 모바일에는 PC와 통신하기 위한 1회용 인증 키만 보관됩니다. Companion은 프롬프트 원문, 결과, 토큰을 디스크 로그에 남기지 않습니다.
PC 없이 모바일 단독으로 AI를 쓸 수도 있나요?
네. 개인정보·AI > AI 공급자에서 OpenAI, Anthropic 또는 OpenAI 호환 API 엔드포인트의 키를 직접 등록하여 사용할 수 있습니다. 등록된 키는 Android Keystore 하드웨어 암호화 저장소에 보관됩니다.
테마 & 시각 효과 (Theme v3.0)
초정밀 개별 키 커스텀부터 하드웨어 가속 RGB 셰이더와 터치 별빛 피직스까지 지원합니다.
키 하나하나의 배경색과 글자색을 다르게 지정할 수 있나요?
네! 새글 테마 v3.0 엔진은 개별 키 스타일 상속 체계를 지원합니다. 스페이스바, 엔터키, 백스페이스, 쉬프트키 또는 특정 문자키마다 개별 배경색, 텍스트 색상, 모서리 라운딩 반경, 테두리 두께를 자유롭게 지정할 수 있으며, 지정하지 않은 키는 상위 전역 키 스타일 및 기본 테마 색상을 자동으로 상속받습니다.
9-Patch 슬라이스(Sliced) 키캡 이미지는 어떻게 적용하나요?
커스텀 테마 스튜디오에서 원하는 키캡 비트맵 이미지를 지정하고 4방향 슬라이스 마진(좌, 상, 우, 하)을 설정하면 SlicedKeyDrawable 엔진이 런타임에 3x3 분할 격자로 연산합니다. 모서리 왜곡 없이 키 크기에 맞춰 완벽하게 스트레칭 렌더링됩니다.
RGB 크로마 백라이트나 터치 별빛 파티클을 켜면 배터리가 많이 소모되지 않나요?
전혀 걱정하지 않으셔도 됩니다! 새글의 RGB 크로마 백라이트는 Android 하드웨어 가속 LinearGradient/SweepGradient 셰이더 매트릭스 변환으로 연산되며, 터치 별빛 파티클은 VSYNC 싱크 Choreographer.postFrameCallback과 객체 풀링 기법으로 구동됩니다. 특히 키보드가 닫히거나 타이핑이 멈추면 애니메이션과 프레임 콜백이 즉각 완전 일시정지(Zero-CPU/GPU Idle)되도록 철저히 최적화되어 있습니다.
내가 만든 커스텀 테마를 백업하거나 친구에게 공유할 수 있나요?
네. 설정 > 테마에서 내가 만든 테마를 ZIP 아카이브 파일로 손쉽게 내보내거나 가져올 수 있습니다. 이전 버전(v1.0, v2.0, v2.1)에서 작성된 테마 파일도 최신 v3.0 스키마로 데이터 손실 없이 자동 마이그레이션됩니다.
음성, GIF, OCR
필요할 때만 켜고, 데이터 전송 위치를 사용자가 완전히 제어합니다.
음성 입력 시 데이터가 외부로 나가나요?
기본 휴대폰 받아쓰기는 기기 내장 음성 인식기로 동작하며 외부 전송이 없습니다. 사용자가 정밀 받아쓰기 모드에서 OpenAI STT API 키를 직접 지정한 경우에만 해당 오디오 청크가 전송됩니다.
사진 속 글자 읽기(OCR)는 사진을 서버로 보내나요?
아닙니다. OCR은 기기 안에서 Tesseract/ONNX 로컬 모델을 통해 100% 온디바이스로 처리됩니다. 선택한 사진이나 인식된 텍스트는 네트워크로 전송되지 않습니다.
GIF 검색 시 어떤 정보가 전달되나요?
Animated Noto Emoji는 기기 내에서 키워드를 매칭합니다. KLIPY, GIPHY, Wikimedia를 선택했을 때만 사용자가 입력한 검색어가 해당 미디어 공급자에게 전송됩니다.
개인정보와 데이터
평소 입력은 100% 로컬에서 처리하며 추적 코드가 없습니다.
내가 타이핑하는 키 입력이 개발자 서버로 전송되나요?
절대 전송되지 않습니다. 새글은 개발자 운영 서버, 광고 SDK, 분석 트래커, 사용자 계정 시스템이 전혀 없는 순수 독립 오픈소스 소프트웨어입니다.
네트워크 기능을 완전히 차단하는 방법이 있나요?
개인정보·AI 설정에서 전체 오프라인 모드를 켜면 AI, 음성 전사, 네트워크 GIF, OCR 모델 다운로드가 하드웨어 레벨에서 일괄 차단되며, 통신량이 0바이트로 유지됩니다.
소스와 문제 해결
공개된 소스 코드와 이슈 트래커를 통해 언제든 확인하고 기여할 수 있습니다.
버그 신고나 기능 제안은 어디에 하나요?
새글 GitHub Issues에 문의를 남겨주세요. 보안 취약점 제보는 [email protected]로 보내주시기 바랍니다.